Content
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured with clean progressive disclosure to a real reference file, but it suffers from redundant repeated guidance across sections, no in-body executable code, and a check→fix loop lacking an explicit verification checkpoint.
Suggestions
De-duplicate the overlapping aria-live/role guidance across Quick Reference, Check, and Fix, and drop the opening sentence that explains screen-reader basics Claude already knows.
Add a concrete in-body code snippet showing the accessible notification pattern (e.g., role='status' with aria-live='polite') instead of deferring all examples to references/rule.md, and replace 'adequate display time' with a specific guideline.
Add an explicit verification checkpoint after the Fix step (e.g., 'Confirm the announcement fires in a screen reader / verify aria-live is present on the rendered output') to close the check→fix loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient, but the Quick Reference, Check, and Fix sections repeat the same aria-live/role guidance, and the opening sentence explains screen-reader basics Claude already knows, so it could be tightened. | 2 / 3 |
Actionability | It gives concrete attribute values (role='alert'/'status', aria-live='polite'/'assertive'), but provides no in-body executable code (all examples are deferred to references/rule.md) and leaves 'adequate display time' vague, fitting the incomplete-guidance anchor. | 2 / 3 |
Workflow Clarity | A Check→Fix sequence is present, but there is no explicit validation or verification checkpoint closing the loop, matching the 'sequence present but checkpoints missing' anchor. | 2 / 3 |
Progressive Disclosure | The body is a concise, well-sectioned overview that points to a single one-level-deep reference (references/rule.md, verified present) clearly signaled for full details, matching the clear-overview anchor. | 3 / 3 |
Total | 9 / 12 Passed |