Content
46%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 appropriately defers implementation detail to a single real reference file, but it spends tokens on a concept primer Claude already knows and provides little executable guidance of its own. Strengthening the Fix section and tightening the intro would raise quality most.
Suggestions
Add one concrete, executable element to the Fix section (e.g., a minimal Playwright toHaveScreenshot snippet or the `npx playwright test --update-snapshots` baseline command) instead of only naming tools.
Delete or compress the opening concept-explanation paragraph, which duplicates the 'Why It Matters' section already in references/rule.md.
Make the review sequence explicit (e.g., numbered Check -> Flag gaps -> Fix -> Verify in CI) so the workflow checkpoints are stated rather than implied.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The intro paragraph ('Functional tests verify behavior but don't see your page. A CSS refactor might pass all unit and integration tests...') explains a concept Claude already knows and duplicates the 'Why It Matters' section in references/rule.md; the rest is mostly efficient. | 3 / 5 |
Actionability | The Fix section offers only high-level hints ('using Playwright's screenshot comparison or a tool like Chromatic') with no code, commands, or configuration in the body; all executable detail is deferred to the reference file. | 2 / 5 |
Workflow Clarity | Check/Fix/Explain/Code Review sections give a loose review sequence, but no ordered steps or verification checkpoints are stated; the sequence is present yet implicit. | 3 / 5 |
Progressive Disclosure | The body is a concise overview with a clearly signaled one-level-deep pointer to references/rule.md (verified to exist and hold the code examples and framework guidance). Minor gaps: the body inlines content duplicated in the reference, and the pointer is one generic sentence rather than per-topic navigation. | 4 / 5 |
Total | 12 / 20 Passed |