Content
92%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 high-quality technical-reference body: hard rules, a complete file contract with executable starter code, a rigorous worked vertical-budget example, a validated preview/screenshot workflow with error recovery, and clean one-level-deep delegation to existing reference files. The only weakness is mild redundancy between the inline rules, the Anti-patterns list, and the Self-review checklist.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and rule-forward with no filler explaining concepts Claude already knows — no React tutorial, no 'what is a slide deck' prose — and it delegates per-primitive detail to `references/*.md` ("This file keeps only the always-on rules and a short summary per primitive"). The duplication is real but minor: the Anti-patterns section and the Self-review checklist restate rules already given verbatim (overflow/split-the-page, padding bounds, notes export, design const), which fits anchor 4 ('minor instances ... that could be trimmed') rather than 5 ('every token earns its place'). | 4 / 5 |
Actionability | Guidance is fully executable and copy-paste ready across common cases: the starter template (`export const design: DesignSystem = { ... }` full component code), the page-location command `grep -n ": Page = " slides/<id>/index.tsx`, the timestamp command `node -e "console.log(new Date().toISOString())"`, the worked 816px vertical-budget table with the formula, and the ready-to-run `npx --no playwright screenshot --viewport-size "1920,1080" --wait-for-selector '[data-osd-preview="ready"]' ...` command. This matches anchor 5; not a 4 because no key detail is missing. | 5 / 5 |
Workflow Clarity | Multi-step processes are clearly sequenced with explicit validation and feedback loops: the preview procedure is a numbered 4-step flow (find server.json → open preview URL → wait for `[data-osd-preview="ready"]` → screenshot at 1920×1080) that enumerates error states (`[data-osd-preview="error"]` with causes) and instructs "Fix the cause rather than screenshotting anyway", followed by "view the image and fix what you see". A full 17-item Self-review checklist closes the process. This matches anchor 5 (explicit validation steps, error-recovery loops, checklist); not a 4 because checkpoints are explicit, not implicit. | 5 / 5 |
Progressive Disclosure | Excellent structure: an up-front navigation table mapping each primitive to its reference file with a "Read before" condition, per-section "Read `references/X.md` before…" signals, and the stated policy of keeping only always-on rules inline. All 7 referenced files (`design-system.md`, `assets.md`, `webfonts.md`, `page-numbers.md`, `steps.md`, `transitions.md`, `morph.md`) exist in the bundle and are exactly one level deep — matching anchor 5 with no nesting, buried references, or content that should have been split out. | 5 / 5 |
Total | 19 / 20 Passed |