Content
70%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 highly actionable with a well-validated render workflow and good reference scaffolding, but it loses points for a duplicated OD workflow explanation, one broken script path, and four dead reference-file links. Fixing the broken references and de-duplicating the workflow narrative would lift both conciseness and progressive disclosure.
Suggestions
Resolve dead links: visual-styles.md, house-style.md, patterns.md, and data-in-motion.md are referenced (some multiple times) but missing from the bundle — either add the files or point to existing references/ equivalents.
Fix the animation-map command path from 'design-templates/hyperframes/scripts/animation-map.mjs' to the actual 'scripts/animation-map.mjs' so the example is runnable.
De-duplicate the Open Design workflow: the prose summary at lines ~122–143 restates the scaffold bash block above it; collapse into one authoritative pass.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with no concept padding, but the OD render workflow is explained twice (the full bash block then a prose restatement) and the Visual Identity Gate is stated and then re-explained for OD, so it could be tightened beyond minor trimming. | 3 / 5 |
Actionability | Mostly executable: full scaffold bash with exit-code-aware wait-loop, copy-paste GSAP/CSS examples, and data-attribute tables — but the animation-map command points at 'design-templates/hyperframes/scripts/animation-map.mjs' which does not exist in the bundle (actual: scripts/animation-map.mjs), so that command is not runnable as written. | 4 / 5 |
Workflow Clarity | The OD render workflow is a clearly numbered sequence (slot → init → edit → dispatch → wait-loop) with explicit validation/feedback (exit codes 0/2/5, stderr-on-failure, plus lint/validate/inspect re-run loops and an Output Checklist), matching the explicit-checkpoints anchor. | 5 / 5 |
Progressive Disclosure | Structure is sound with a 'References (loaded on demand)' section and per-file 'Read when…' triggers, but four referenced files are absent from the bundle (visual-styles.md, house-style.md, patterns.md, data-in-motion.md) and the animation-map script path is wrong, so navigation leads nowhere for those entries. | 3 / 5 |
Total | 15 / 20 Passed |