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.
The body is a well-structured technical reference: executable code and commands, a clear editing workflow with a validation checklist, and exemplary progressive disclosure via a reference table pointing to real files. The only weakness is repetition between the Anti-patterns section and earlier rules.
Suggestions
Trim the 'Anti-patterns' section to entries that add new information beyond the 'Hard rules' and 'Self-review' sections, or explicitly frame it as a quick-reference recap to justify the repetition.
Consider folding the duplicate 1080px-overflow guidance into a single canonical location and cross-referencing it from the checklist and anti-patterns.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean and rule-driven with no padding about basic concepts, but the 'Anti-patterns' section restates rules already covered in 'Hard rules', 'Canvas', and 'Self-review' (e.g. the 1080px overflow rule appears three times), which is more than minor repetition. | 4 / 5 |
Actionability | Provides copy-paste-ready code (file contract, starter template, component-vs-map examples), an executable locate command (`grep -n ": Page = "`), and a concrete timestamp command (`node -e "console.log(new Date().toISOString())"`) with specific numeric guidance throughout. | 5 / 5 |
Workflow Clarity | The 'Editing an existing slide' flow is sequenced (locate via grep → read range → edit) and closes with an explicit 'Self-review before finishing' checklist that acts as a validation checkpoint, plus a vertical-budget feedback loop that instructs splitting when over budget. | 5 / 5 |
Progressive Disclosure | A 'Primitive references' table maps each of seven primitives to when-to-read guidance and a real one-level-deep file under references/ (all seven files verified to exist), keeping only always-on rules inline and pushing detail to dedicated reference files. | 5 / 5 |
Total | 19 / 20 Passed |