Content
100%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, token-efficient body that leads with high-signal EmDash-specific gotchas, gives an actionable API cheat sheet, sequences a six-step build workflow ending in verification, and cleanly delegates detail to verified one-level-deep references. It avoids explaining concepts Claude already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient: it skips concepts Claude already knows (no "what a CMS/Astro is") and opens with EmDash-specific facts, while the gotchas and API cheat sheet are high-signal and well-commented rather than padded, so every token earns its place. | 3 / 3 |
Actionability | Provides copy-paste-ready guidance: exact gotcha fixes (e.g. `<Image image={post.data.featured_image} /> from "emdash/ui"`), executable TypeScript query/import patterns, and the concrete `npx emdash dev` command, matching the fully-executable anchor. | 3 / 3 |
Workflow Clarity | A clearly numbered 1–6 sequence ends in an explicit "Run and verify" step (`npx emdash dev` runs migrations, seeds, and type generation), and the "Common Gotchas" section functions as a proactive error-prevention checklist; this is not a destructive/batch context so the missing recovery loop does not cap the score. | 3 / 3 |
Progressive Disclosure | A clear overview points to four real, one-level-deep reference files, each signaled in the Workflow steps and summarized in a bottom navigation table, with detail appropriately split out rather than inlined — a textbook match for the well-signaled one-level-deep anchor. | 3 / 3 |
Total | 12 / 12 Passed |