Content
81%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 highly actionable, well-sequenced TDD workflow with strong validation and feedback loops. The main weakness is redundancy between the Overview and Rules and a formatting glitch in step 6.
Suggestions
Remove the overlap between the Overview and Rules 3-4 (e.g. drop the 'never edit a failing test / never silence lint' sentences from the Overview since they are fully stated in the Rules) to tighten token use.
Fix the step 6 heading ('6. **6. **TOTAL STOP**') duplicated-numbering/bolding glitch.
Consider moving the nine Rules into a separate references file (e.g. RULES.md) referenced one-level-deep from the body, which would let progressive_disclosure reach the cleanly-split 5 anchor.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and assumes Claude's intelligence (no explaining of what TDD or tests are), but the Overview restates prohibitions ('never edit a failing test', 'never silence lint') that are repeated verbatim in Rules 3-4, and step 6 has a duplicated-numbering formatting glitch, so it could be tightened below the 4 anchor. | 3 / 5 |
Actionability | Fully executable guidance: a concrete check-command detection table (deno task check, npm run check, make check, pytest, go vet), named todo tools, and specific suppression patterns to avoid (// deno-lint-ignore, eslint-disable, # noqa) covering the common cases. | 5 / 5 |
Workflow Clarity | A clear 6-step sequence with explicit validation checkpoints (RED must fail, CHECK must exit 0, re-run tests after refactor, final whole-project check, git-status and scope-creep checks), feedback loops (stop-on-second-fix-failure with STOP-ANALYSIS REPORT), and a verification checklist. | 5 / 5 |
Progressive Disclosure | Well-organized into Overview, Context, Rules, Instructions, and Verification sections with clear one-level references to AGENTS.md, but it is a dense ~75-line monolith with all nine rules inlined and no bundle files, leaving minor organization gaps short of the cleanly-split 5 anchor. | 4 / 5 |
Total | 17 / 20 Passed |