Content
85%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 concise, actionable, and sequenced with a strong verification checklist, but it references demo/index.html, demo/PROMPT.md, and REFERENCES.md that are not present in the bundle, breaking progressive disclosure.
Suggestions
Ship the referenced bundle files (demo/index.html, demo/PROMPT.md, REFERENCES.md) or remove the links so navigation is not broken.
Add a short runnable snippet for the dependency-free implementation (scroll/resize measurement + one rAF render) to match the concreteness of the GSAP example.
Show the video currentTime coalescing / image-sequence preload-and-cancel pattern as a small code block rather than only as prose bullets.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean, well-sectioned body that assumes Claude's competence — it never explains what scroll, GSAP, or canvas are, and every line ('Cap device pixel ratio at 2 and redraw only when progress changes') earns its place. | 5 / 5 |
Actionability | Provides executable, copy-paste-ready code for the core cases (progress normalization, the sequence config, the GSAP ScrollTrigger snippet) plus concrete per-renderer techniques, but the dependency-free path is described only abstractly and video/image-sequence seek handling is guidance rather than runnable code. | 4 / 5 |
Workflow Clarity | A clear sequenced flow (Define → Choose → Build → Handle → Preserve → Tune → Verify) culminates in an explicit validation checklist — 'forward and reverse scrolling, fast flicks, resize... reduced motion... The same scroll position must always reproduce the same state' — with a feedback invariant. | 5 / 5 |
Progressive Disclosure | Sections are well-organized and references are clearly signaled one level deep ('Use demo/index.html as the working reference... Keep REFERENCES.md as the links-only implementation source list'), but the referenced files do not exist in the bundle, so the navigation leads nowhere. | 3 / 5 |
Total | 17 / 20 Passed |