Content
73%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.
The body is a well-structured, actionable QA workflow with explicit validation checkpoints and feedback loops. Its main weaknesses are mild verbosity from an abstract primitive table and repeated priority/severity content, plus references to bundle files that are not actually present.
Suggestions
Remove or collapse the "SSL primitive" action table, which restates obvious read/run/compare actions in abstract framework jargon that does not aid execution.
De-duplicate the Security > Performance > Accessibility > Code Quality priority order and the severity definitions, which appear in both Transitions and Guardrails.
Either add the referenced resources/*.md and ../_shared/core/* files to the bundle or mark which references are external, so the References section is navigable and verifiable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient structured guidance, but the abstract "SSL primitive" action table adds framework jargon Claude does not need, and the priority order and severity definitions are repeated across the Transitions and Guardrails sections. | 3 / 5 |
Actionability | Provides concrete runnable commands (npm audit, bandit -r ., lighthouse <url>), a severity rubric, file:line evidence requirements, and ISO mappings, with only minor gaps around stack-specific command selection. | 4 / 5 |
Workflow Clarity | The PREPARE→ACQUIRE→REASON→VERIFY→FINALIZE sequence is explicit, with a dedicated VERIFY validation step (reproduce findings, reject false positives) and a failure-and-recovery section providing feedback loops; review work is read-heavy rather than destructive, so no cap applies. | 5 / 5 |
Progressive Disclosure | A clear References section lists one-level-deep, well-signaled resources, but no references/scripts/assets bundle directory exists, so the cited resources/*.md and ../_shared/core/* files cannot be verified and some detail is inlined rather than split out. | 4 / 5 |
Total | 16 / 20 Passed |