Content
53%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 well-structured as a documentation-grade overview with real bundle references and a clear assembly sequence, but it is held back by redundant restating of the non-negotiables across sections, no executable code blocks, and only implicit validation checkpoints for a batch render workflow.
Suggestions
Collapse the 'two non-negotiable separations' and 'Contract' sections so each non-negotiable is stated once, cutting redundant tokens.
Add an explicit validate-fix-retry loop for the batch/render steps (e.g. frame-diff after the 30s cut, re-burn captions if motion is not localized) to lift workflow clarity above 3.
Either inline a minimal executable ffmpeg/Remotion snippet for one beat or make the pointer to scripts/README.md a clearly labeled navigation block.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude knows the toolchain (ffmpeg, Remotion, PIL, libass, sidechaincompress) without padding, but the 'two non-negotiable separations', 'free assembly steps', and 'Contract' sections restate the same non-negotiables (text never baked, real vs AI, cut from animated master) redundantly. | 3 / 5 |
Actionability | Steps carry concrete parameters (cfg 0.5, loudnorm I=-15, setpts <=1.6x) but there are no executable code blocks in the body; the actual ffmpeg/Remotion/PIL commands are deferred to scripts/README.md, so guidance is specific but not copy-paste ready. | 3 / 5 |
Workflow Clarity | The free assembly is clearly sequenced (Remotion overlay -> PIL grid -> captions -> audio mix/master -> 30s cut), but for a batch/render workflow the validation checkpoints are only implicit ('frame-diff to prove localized motion', 'TEST one scene before batching') rather than structured validate-fix-retry loops. | 3 / 5 |
Progressive Disclosure | The body is an overview that signals one-level-deep, real bundle references (scripts/README.md, scripts/PIPELINE.md, scripts/config.example.json) and splits content into clear sections; references are clear but mentioned inline rather than in a dedicated navigation block. | 4 / 5 |
Total | 13 / 20 Passed |