Content
40%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 has a sensible section structure and a well-signaled pointer to a real references/rule.md containing the executable detail, but the body itself is padding-heavy (the CDN concept is explained three times) and its Check/Fix/Explain/Code Review steps are one-line abstractions with no commands, code, or validation steps. Most of the actual instructional value lives entirely in the reference file.
Suggestions
Replace the vague Check step with concrete verification, e.g. "Open DevTools Network panel and confirm asset Host/`Cache-Control` headers; assets should return `X-Cache: HIT` from an edge domain, and Lighthouse's 'Serve static assets with an efficient cache policy' audit should pass."
Replace the vague Fix step with the executable config from references/rule.md (the Next.js images/headers example) or a minimal generic CDN setup snippet, plus a re-verify step after configuration.
Delete the redundant Explain section and the duplicate Quick Reference bullet — the intro paragraph already states the concept, and Claude knows what a CDN is; the saved tokens can carry the concrete check/fix steps instead.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short, but the same concept is stated three times — the intro ("A CDN serves static assets from geographically distributed servers—users download from the nearest location..."), Quick Reference bullet 1 ("CDNs serve content from edge servers closest to users"), and the Explain section ("Explain how CDNs reduce latency by serving content from geographically distributed servers."), which restates a concept Claude already knows. It is mostly efficient with removable padding, above anchor 2 but not the lean anchor 5. | 3 / 5 |
Actionability | The Check ("Check if static assets are served from a CDN and if the CDN is properly configured"), Fix ("Configure a CDN to serve static assets with proper caching headers and geographic distribution"), and Code Review sections are all abstract directions with no commands, code, or concrete steps — only a named list of providers ("Cloudflare, Vercel, AWS CloudFront, Fastly") and a pointer to references/rule.md. It is above anchor 1 (it does name concrete providers and what to inspect) but sits well below the executable-code anchors. | 2 / 5 |
Workflow Clarity | The Check → Fix → Explain → Code Review sections give a rough sequence, but each step is a single vague sentence with no detail on how to perform it, no measurement commands (despite the description promising DevTools/Lighthouse verification), and no validation checkpoint such as confirming cache headers after configuring. This matches anchor 2's 'rough sequence present but many gaps; steps poorly defined' rather than anchor 3's listed-steps-with-implicit-checkpoints. | 2 / 5 |
Progressive Disclosure | The body acts as a short overview with a clearly signaled one-level-deep reference — "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — and that file exists with the promised content (Next.js config example, caching headers). It misses anchor 5 because the body duplicates rule.md's intro text and Quick Reference claims instead of cleanly splitting overview vs. detail. | 4 / 5 |
Total | 11 / 20 Passed |