Content
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured and properly delegates detail to a real one-level reference, but it spends tokens re-explaining basic testing concepts, keeps the Fix guidance abstract, and lacks explicit validation checkpoints in its workflow.
Suggestions
Delete the opening paragraph and the first Quick Reference bullet that re-explain what integration tests are and how they differ from unit tests; Claude already knows this.
Add a minimal concrete test skeleton or a specific runner command in the Fix section rather than outsourcing every example to references/rule.md.
Insert an explicit validation step after writing tests, e.g. "run the suite and confirm the new test passes and fails without the fix".
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The opening paragraph and the first Quick Reference bullet re-explain what integration tests are and how they differ from unit tests — concepts Claude already knows — so it is mostly efficient but carries unnecessary explanation. | 2 / 3 |
Actionability | It gives concrete integration points to inspect ("where API routes call services, where services interact with the database"), but the Fix section is abstract ("Write integration tests for the identified critical paths") with no code or concrete pattern in the body, delegating all examples to the reference. | 2 / 3 |
Workflow Clarity | The Check → Fix → Explain → Code Review sequence is clearly laid out, but there are no explicit validation checkpoints or feedback loops (e.g. run the suite, confirm the test fails without the fix), so checkpoints are implicit. | 2 / 3 |
Progressive Disclosure | The body is a concise overview with well-organized sections and a clearly signaled, one-level-deep pointer to references/rule.md for code examples and framework guidance; the referenced file exists and holds the detailed content. | 3 / 3 |
Total | 9 / 12 Passed |