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.
A dense, highly operational workflow document: exact commands at every stage, a well-sequenced pipeline with real validation gates, and disciplined reference routing. The main costs are rhetorical flourish in the companion section and some inlined dispatch detail that belongs in a bundled reference.
Suggestions
Trim the companion-flow rhetoric (e.g., the 'director, not the contractor' and 'ceiling belongs to the concept' passages) to their operative directives to save tokens without losing guidance.
Move the §5 dispatch mechanics (packet contents, worker role assembly, wave rules) into a bundled reference and link it, keeping the stage list lean.
Resolve the dangling `sub-agents/frame-worker.md` reference — either ship the file in the bundle or point to an existing path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence throughout — no basic-concept explanations — and nearly every sentence carries a directive or a concrete fact (e.g., "measured: 5 short scenes ≈ 9 min inline vs ≈ 21 min packetized"). It is 4 not 5 because rhetorical framing in the companion section ("Arrive as the director, not the contractor.", "The ceiling belongs to the concept, not the toolbox.") and the very long §5 plan paragraph could be tightened without losing instruction. | 4 / 5 |
Actionability | Copy-paste-ready commands with exact flags cover every stage: `npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video`, `node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>`, `node <SKILL_DIR>/scripts/frame-packets.mjs --project ... --storyboard ...`, `npx hyperframes catalog --query "<the look, in plain English>" --json`, `npx hyperframes lint` / `check`. Placeholders are defined inline ("Here `<MEDIA_DIR>` is the installed `/media-use` skill directory..."). Full executability with common cases covered matches the 5 anchor. | 5 / 5 |
Workflow Clarity | A clear state table routes entry (specific edit / brief exists / resume / fresh), then an explicitly ordered dependency chain (plan → review → resolve → build → merge → assemble → verify → final approval) with validation checkpoints and feedback loops: lint after the first HTML pass, `npx hyperframes check` as the final gate, and a §7 done-checklist requiring checks to pass and the rendered file to be verified. Explicit validation plus error-recovery gating matches the 5 anchor. | 5 / 5 |
Progressive Disclosure | Structure is good: the body is an overview routing to clearly signaled, one-level-deep references (`../hyperframes/references/brief-contract.md`, `/hyperframes-creative` → `references/house-style.md`), and the referenced `scripts/frame-packets.mjs` exists in the bundle. It is not 5 because the §5 dispatch detail (packet contents, worker role assembly) is inlined rather than placed in a reference, and the referenced `sub-agents/frame-worker.md` is not present in the actual bundle, leaving a dangling path. | 4 / 5 |
Total | 18 / 20 Passed |