Content
63%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 lean, well-structured overview with excellent progressive disclosure into a real, detailed reference file. The weaknesses are a motivational intro paragraph and duplicated bullets that could be trimmed, and a Fix section that delegates all executable detail to the reference without even a minimal inline command. The Check/Fix/Explain workflow is clear but lacks a verification step.
Suggestions
Trim or remove the opening motivational paragraph and the overlapping Quick Reference bullets; the 'why' of performance budgets is background Claude already has.
Inline one minimal executable step in the Fix section (e.g., the `pnpm add -D size-limit @size-limit/preset-app` command or a single size-limit config entry) so the body is actionable without opening the reference.
Add a verify step to the workflow, such as 'Run `size-limit` locally to confirm budgets pass before pushing the CI change.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The opening paragraph ('Without automated enforcement, performance degrades gradually — each PR adds a small library... within months the app that loaded in 2 seconds now takes 5') is motivational rationale Claude already knows, and the Quick Reference bullets partially duplicate the Check/Fix/Explain sections. The rest is efficient, so this is mostly tight with some removable padding rather than clearly verbose. | 3 / 5 |
Actionability | The body names concrete tools and targets ('size-limit', 'Lighthouse CI assertions', 'package.json', 'CI workflows') but contains no commands or configuration — the Fix section is a high-level hint, with all executable detail delegated to references/rule.md. Not 4 because inline guidance lacks any runnable command or config snippet; not 2 because tool names and inspection targets are specific. | 3 / 5 |
Workflow Clarity | The Check → Fix → Explain → Code Review sequence is coherent, with concrete inspection targets (package.json, CI configuration, bundle-size config, production RUM). A minor validation gap keeps it below 5: no step verifies the fix, e.g. running size-limit locally or confirming CI fails on an exceeded budget. | 4 / 5 |
Progressive Disclosure | Scored against the actual bundle: the body is a concise overview with a single, clearly signaled, one-level-deep pointer ('For full implementation details, code examples, and framework-specific guidance, see references/rule.md'), and references/rule.md exists and contains exactly that implementation detail. Content is appropriately split with easy navigation. | 5 / 5 |
Total | 15 / 20 Passed |