Content
88%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.
An unusually disciplined body: terse, project-specific rules, a numbered method, and a strong final checklist, with details correctly pushed to five real reference files. The main defect is bundle integrity — both `templates/` files the Method and Files sections point to for tiers 2 and 3 are absent, which also weakens copy-paste readiness for those tiers.
Suggestions
Add the missing `templates/mechanism.html` and `templates/dither.js` to the bundle, or repoint Method step 2 and the Files section to the existing reference files — two of the seven referenced paths are currently dead ends.
For tier 1, point early in the Method to the complete example modules in `references/toolkit.md` (or inline a minimal module from IIFE through `LF.register`) so a first-time author can copy a working skeleton instead of assembling one from thirteen steps.
Close the feedback loop in 'Check before you finish' with one line stating what to do when an item fails (fix it and re-run the validator and checklist), rather than leaving the recovery step implicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with project-specific facts Claude cannot know (the LF runtime, fence syntax, keySplines values, the 279 px measurement at 375 px width, ES5 constraints) and explains no general concepts. Every line is prescriptive; matches anchor 5 (lean, assumes competence, every token earns its place) rather than anchor 4, which would require trimmable over-explanation that is absent here. | 5 / 5 |
Actionability | Guidance is largely executable — exact fence syntax with a copy-paste example, the figure-function signature, `viewBox="0 0 520 H"`, `var(--blueprint,#3553ff)` patterns, and `LF.register` call. It falls short of anchor 5 because Method step 2 directs tier-2/3 authors to 'start from `templates/mechanism.html`' and 'copy `templates/dither.js`', and neither file exists in the bundle — those paths are dead ends, a concrete gap in executable guidance. | 4 / 5 |
Workflow Clarity | A 13-step Method in strict order, ending in step 13's explicit instruction to run the 'Check before you finish' section, which is a 15-item validation checklist covering reduced motion, dark theme, 375 px width, slider min/max NaN, and per-tier reference checklists, plus a browser-console validator in `references/smil-rules.md`. This matches anchor 5 (clear sequence, explicit validation, checklists); the work is not destructive or batch, so no cap applies. | 5 / 5 |
Progressive Disclosure | The body is a clean overview with one-level-deep references, all five `references/*.md` files exist, and the Files section summarizes each so navigation is easy — structurally an anchor 5. Scoring against the actual bundle per the rubric guideline, however, 2 of the 7 referenced paths (`templates/mechanism.html`, `templates/dither.js`) are missing from the directory, a real organization gap that fits anchor 4 (good structure, minor gaps) better than 5. | 4 / 5 |
Total | 18 / 20 Passed |