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.
The body is well-structured with good progressive disclosure and sensible audit-workflow checkpoints, but it is held back by conceptual padding in the intro and 'Explain' sections and a vague 'Fix' section that defers all concrete implementation detail without summarizing the key technique.
Suggestions
Cut the conceptual intro sentence and the 'Explain' section — both restate knowledge Claude already has and duplicate each other.
Make 'Fix' concrete: inline a minimal loading="lazy" example or name the exact technique per media type (native attribute for images/iframes, Intersection Observer with rootMargin for sections).
Add a post-fix verification step in the body pointing at the reference's Verification guidance (PageSpeed Insights or a throttled waterfall trace) so the workflow closes the loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The intro sentence ('Lazy loading defers non-critical resources until needed—this reduces initial page weight, speeds up first paint...') and the 'Explain' section both restate basic lazy-loading concepts Claude already knows and duplicate each other. Otherwise the body is lean, so this is unnecessary explanation that could be tightened rather than severe padding. | 3 / 5 |
Actionability | 'Check' gives concrete directives ('Verify that images and other heavy resources below the fold are lazy loaded. Only report this when the code or route context makes offscreen placement clear'), but 'Fix' is a high-level hint ('using native loading='lazy' or JavaScript solutions') with no code or named technique, and 'describe the measurement method used to confirm the issue' leaves the method unspecified. | 3 / 5 |
Workflow Clarity | A clear Check → Fix → Explain → Code Review sequence is present with real checkpoints ('If fold position is unclear from the snippet, do not invent a lazy-loading defect'; 'Only report this when the code or route context makes offscreen placement clear'). The minor gap is that post-fix verification (PageSpeed/throttled trace) lives only in the reference file and is not surfaced as a step in the body. | 4 / 5 |
Progressive Disclosure | The body is a concise, well-sectioned ~35-line overview that appropriately defers code examples and framework-specific guidance to a clearly signaled, one-level-deep reference ('For full implementation details, code examples, and framework-specific guidance, see references/rule.md'), which exists in the bundle. | 5 / 5 |
Total | 15 / 20 Passed |