Content
65%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 well-structured and lean, with excellent progressive disclosure pointing to a real references file. Its weaknesses are vague, non-executable Check/Fix/Code Review sections and missing validation checkpoints in the review workflow.
Suggestions
Replace the abstract Check/Fix directives with concrete, executable review steps (e.g., specific grep patterns or commands to detect missing afterEach cleanup and over-mocking).
Add an explicit validation/verification checkpoint to the Code Review workflow, such as 'run the test suite and confirm a mocked-out assertion fails when the rule is violated, then verify CI blocks the regression'.
Inline one or two short representative code examples (a good vs. bad mock cleanup snippet) so the body is actionable without requiring the references file for common cases.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with terse Quick Reference bullets and short mode sections; only the opening sentence restates a concept Claude already knows, so it is efficient with minor trimmable over-explanation. | 4 / 5 |
Actionability | The Quick Reference offers some concrete guidance (jest.restoreAllMocks() in afterEach, use MSW), but the Check/Fix/Explain/Code Review sections give high-level direction ('review...', 'improve mocking strategy by...') rather than executable steps, with the concrete detail delegated to references. | 3 / 5 |
Workflow Clarity | Check/Fix/Explain/Code Review act as a loose framework with an implied review-then-fix sequence, but there are no explicit validation checkpoints or feedback loops in the body. | 3 / 5 |
Progressive Disclosure | A clear overview with a single well-signaled one-level-deep reference to references/rule.md (verified to exist) for full details, with content appropriately split and easy navigation. | 5 / 5 |
Total | 15 / 20 Passed |