Content
70%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 clear sequencing and validation, but it carries redundant templated scaffolding and references several resources/ and ../_shared/ files that are not present in the bundle.
Suggestions
Add the referenced resource files (resources/execution-protocol.md, resources/iso-quality.md, resources/checklist.md, resources/error-playbook.md, resources/verify-ship-protocol.md) or remove the dangling references so progressive disclosure reflects the actual bundle.
Collapse the redundant scaffolding (SSL-primitive, Resource-scope, Control-flow features sections overlap the Scenes/Transitions/Guardrails content) to reduce tokens and lift conciseness.
Add a concrete example finding entry (severity, file:line, evidence, remediation code) so the report format is copy-paste ready and actionability reaches 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The templated scaffolding (SSL-primitive table, Resource-scope table, Control-flow features) and overlapping sections (Guardrails restating Scenes/Transitions; Dependencies overlapping Tools and instruments) add padding that could be tightened, though the body mostly assumes Claude's competence. | 3 / 5 |
Actionability | Provides concrete commands ('npm audit', 'bandit -r .', 'lighthouse <url>'), an explicit severity rubric, priority ordering, and a file:line + fix requirement — mostly executable guidance, but lacks a copy-paste finding-report template or example output to reach 5. | 4 / 5 |
Workflow Clarity | A clearly sequenced PREPARE → ACQUIRE → REASON → VERIFY → FINALIZE flow with explicit validation ('VERIFY: Reproduce findings and reject false positives', 'If a finding cannot be reproduced, do not report it') and a dedicated failure-and-recovery feedback loop. | 5 / 5 |
Progressive Disclosure | The body is a well-organized overview with one-level-deep, clearly signaled references (resources/execution-protocol.md, resources/iso-quality.md, resources/checklist.md, etc.), but none of the referenced files actually exist in the bundle, which is a real organization gap that caps the score. | 3 / 5 |
Total | 15 / 20 Passed |