Content
76%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, high-signal body that captures the format's signature, the non-obvious frame-swap design decision, and a clear two-command run path, all at excellent token efficiency. The main gaps are operational: no verification step after the batch render and script invocations that omit their scripts/ location and interpreter, which slightly blunt copy-paste executability.
Suggestions
Add a validation checkpoint after rendering, e.g. 'Verify: ffprobe master-silent.mp4 shows the expected duration and fps before considering the render done.'
Write the run commands with explicit paths and interpreter: 'python scripts/build_card.py --config config.json --out hyperframe.html' and 'python scripts/render.py ...'.
Include a minimal config.json snippet (or point to where the recipe DB supplies it) so tile types, cols/rows, and palette fields are concrete rather than implicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~37 lean lines: format signature, the run commands, the non-obvious frame-swap rationale (Chromium can't decode H.264 over file://, hangs on canplay), and a contract list. Every fact is something Claude could not infer — nothing explains known concepts, no padding. This matches anchor 5 ('Lean and efficient; every token earns its place'); even the codec explanation is genuinely non-obvious and load-bearing. | 5 / 5 |
Actionability | Concrete runnable commands are given with full flags and outputs ("build_card.py --config config.json --out hyperframe.html ; render.py --config config.json --html hyperframe.html --out master-silent.mp4") and both scripts exist in the bundle, matching anchor 4 ('mostly executable guidance... minor gaps'). Not 5 because the invocations omit interpreter/path context (python scripts/build_card.py) and no sample config or field list is shown, leaving the config schema implicit. | 4 / 5 |
Workflow Clarity | The build-then-render sequence is present and ordered, plus the input constraint 'Provide clips longer than the master (or the swap just loops them)', but there are no validation checkpoints on a batch-style render (~10s of frame-stepped output). Per the guideline capping batch operations without validation at 3, this sits at anchor 3 ('sequence present but checkpoints missing or implicit') — the sequence itself is coherent, so not 2. | 3 / 5 |
Progressive Disclosure | The ~37-line body is appropriately self-contained with well-marked sections (signature, ## Run, ## Contract) and correctly leaves tile/music generation to sibling capabilities — the under-50-lines exception applies. Scored 4 rather than 5 because the scripts build_card.py, render.py (and _shared.js) are referenced by bare filename without signaling they live in scripts/, a minor organization gap matching anchor 4. | 4 / 5 |
Total | 16 / 20 Passed |