Content
57%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 a well-structured, appropriately short overview with excellent progressive disclosure to a real, one-level-deep reference file. Its weaknesses are internal duplication between the Quick Reference, Check, Fix, and Explain sections, the absence of any inline executable detail, and a missing re-measure step to close the Check-to-Fix feedback loop.
Suggestions
Consolidate the Quick Reference and Fix sections into one list of optimization levers to remove the near-duplicate bullets (preload, images, CDN, TTFB) and the twice-stated 2.5s target.
Add a final verification step to the workflow (e.g., 'Re-run Lighthouse after applying fixes to confirm LCP is under 2.5s') so the Check-to-Fix loop closes with a validation checkpoint.
Include at least one concrete inline snippet in the Fix section — such as the `<link rel="preload" as="image">` syntax for hero images or a specific Lighthouse CLI command — instead of deferring all executable detail to the reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean, but the Fix section ("preloading critical resources, optimizing images, using CDN, and reducing server response time") nearly duplicates the Quick Reference bullets, the 2.5s target is stated twice, and the Explain section restates the intro, so it could be meaningfully tightened. | 3 / 5 |
Actionability | It provides some concrete guidance by naming specific levers and tools ("Use preload for hero images", "Measure LCP using Lighthouse or PageSpeed Insights", "Reduce server response time (TTFB)"), but the body contains no executable detail — no preload syntax, commands, or image-format specifics — with all code deferred to the reference file. | 3 / 5 |
Workflow Clarity | A Check-then-Fix sequence is present with a problem-detection checkpoint ("Verify the largest visible element renders within 2.5 seconds"), but there is no re-measure or validation step after applying fixes, so the feedback loop for confirming the optimization worked is missing. | 3 / 5 |
Progressive Disclosure | The body is a concise overview that clearly signals a single one-level-deep reference ("For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`"), and that file exists with the detailed content, matching the top anchor for well-signaled navigation. | 5 / 5 |
Total | 14 / 20 Passed |