Content
68%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 concise, actionable accessibility rulebook with good structure and concrete code examples. Weakest area is workflow clarity: it offers priorities and a report format rather than an explicit sequenced review workflow with a re-verification checkpoint.
Suggestions
Add an explicit numbered review workflow (e.g. 1. scan controls for names, 2. check keyboard/focus, 3. quote violation + fix, 4. re-verify the fixed element) with a validation/re-check step.
Pair more of the rule bullets with a small before/after example, especially for forms/errors and announcements where the pattern is non-obvious.
Dedupe the 'prefer minimal/native, don't refactor' guidance so it appears once (in tool boundaries) rather than across three sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean bullet-list constraints that assume Claude's HTML/ARIA competence, with minor redundancy — 'prefer minimal/native' and the no-refactor guidance recur across 'how to use', 'tool boundaries', and 'review guidance'. | 4 / 5 |
Actionability | Provides concrete, specific rules (exact aria attributes, patterns) plus three executable before/after HTML examples and an explicit review report format; minor gap is that most rules lack a paired example. | 4 / 5 |
Workflow Clarity | A priority order and a three-part report format give a rough sequence, but there is no explicit step sequence or validation/re-verify checkpoint (e.g. re-check the element after applying a fix). | 3 / 5 |
Progressive Disclosure | Well-organized into clearly headed sections with a priority table and is appropriately self-contained (no bundle files exist, none needed); not a 5 because it is a single inline ~130-line document with no one-level-deep reference split. | 4 / 5 |
Total | 15 / 20 Passed |