Content
65%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tidy overview with excellent progressive disclosure into a real, self-contained reference file. The body itself falls short on actionability and workflow clarity: no executable snippets and the Check/Fix/Explain sections are generic directives without sequencing or verification steps.
Suggestions
Inline one minimal executable snippet (e.g. a jest-axe `expect.extend(toHaveNoViolations)` example) so the body is actionable without opening the reference.
Turn Check/Fix/Explain into a sequenced workflow with a verification step, e.g. 'Add tests → run the suite → confirm zero unexpected axe violations before merging'.
Delete the opening 30-50% rationale sentence, which duplicates 'Why It Matters' in references/rule.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and sectioned with each token mostly earning its place, but the opening rationale ('Automated accessibility testing catches 30-50% of WCAG violations—reducing legal risk and improving usability for everyone') is background duplicated from the reference file and could be trimmed. | 4 / 5 |
Actionability | Concrete tool names appear (jest-axe, @axe-core/playwright, cypress-axe, the color-contrast rule) and a real pointer to reference code exists, but the body itself contains no code, commands, or specific steps — 'Test specific WCAG rules like color-contrast individually' is a high-level hint without the how, matching the anchor for some concrete guidance that is incomplete. | 3 / 5 |
Workflow Clarity | The Check/Fix/Explain/Code Review sections loosely suggest a flow but are not sequenced into a process and include no validation checkpoints (e.g. how to verify zero new violations or confirm CI gates the build), fitting the anchor for steps listed with checkpoints missing. | 3 / 5 |
Progressive Disclosure | The short, well-organized body defers implementation detail via a clearly signaled one-level-deep pointer — 'For full implementation details, code examples, and framework-specific guidance, see references/rule.md' — and the referenced file exists and is self-contained with no nested references, matching the anchor for a clear overview with well-signaled references. | 5 / 5 |
Total | 15 / 20 Passed |