Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured overview with concrete, actionable modal-accessibility criteria and a clean one-level-deep pointer to references/rule.md. It loses points on conciseness (overlapping Check/Fix/Explain/Code Review restatements) and workflow clarity (flat checklist with no explicit validation checkpoints in the body).
Suggestions
Consolidate the Check/Fix/Explain/Code Review sections into a single sequenced workflow to remove redundant restatements of the same ARIA/focus/keyboard points.
Add an explicit validate-then-fix feedback loop in the body (e.g., verify with axe/Lighthouse -> if violations, fix and re-verify) rather than delegating all verification steps to references/rule.md.
Convert the flat Quick Reference bullet list into an ordered review sequence with checkpoints so the workflow is unambiguous without needing the reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and delegates detail to references, but the Check/Fix/Explain/Code Review sections restate the same ARIA, focus-trap, and keyboard points in slightly different framings, so it could be tightened — not the score 3 'every token earns its place' anchor. | 2 / 3 |
Actionability | Gives concrete, specific guidance — exact attribute values (role='dialog', aria-modal='true', aria-labelledby) and exact behaviors (Tab cycles within modal, Escape closes, return focus) — which is actionable; per the instruction-only note, absence of code blocks is not penalized when guidance is this specific. | 3 / 3 |
Workflow Clarity | Criteria are listed as a flat Quick Reference checklist with no explicit sequenced steps or validate-then-retry feedback loop in the body, matching the score 2 'steps present but checkpoints missing or implicit' anchor rather than the score 3 explicit-checkpoint anchor. | 2 / 3 |
Progressive Disclosure | Concise overview with a single, clearly signaled one-level-deep reference ('see references/rule.md'), and that bundle file exists as referenced, matching the well-organized one-level-deep anchor. | 3 / 3 |
Total | 10 / 12 Passed |