Content
82%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, competent reference that gives Claude exact APIs, constants, formulas, and QA paths for modifying the CCTV system with sharp pitfalls. Its main limitation is the absence of a consolidated copy-paste code example and an explicit feedback-loop workflow for edits.
Suggestions
Add one complete, copy-paste-ready code block showing a minimal camera add+tick+monitor wiring so the most common modification is executable end-to-end.
Wrap the core edit task in an explicit numbered workflow with a validate->fix->retry checkpoint (e.g., run ?cctv=demo and assert activeFeed()/activity before declaring done).
Consider moving the detailed constant table (FEED_W, CAPTURES_PER_FRAME, TRACK_LERP, ACTIVITY_DECAY, etc.) into a short reference subsection or file so the overview stays scannable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense; it assumes Claude's competence (referencing WebGLRenderTarget, ShaderMaterial, PerspectiveCamera without explanation) and every line carries implementation detail with no concept padding. | 5 / 5 |
Actionability | Highly concrete guidance — exact file paths, API signatures (setSubjectsProvider, aim), the prox*0.6+moved*1.0 scoring formula, named constants, and QA commands (?cctv=demo, npm run check) — but it is a descriptive contract rather than a single copy-paste-ready code block, leaving a minor gap. | 4 / 5 |
Workflow Clarity | Clear sequences exist (tick wiring order, lobby-enter placement with 350ms delay, teardown on non-lobby enter/leave, lobby-cutting state machine) and the QA section provides validation checkpoints (assert activeFeed() and activity > 0), but there is no unified validate->fix->retry loop for the core editing workflow. | 4 / 5 |
Progressive Disclosure | Well-organized into clear sections (Files, How it works, Placement, Lobby cutting, QA, Pitfalls) with easy navigation and no nested references, but it is a single self-contained file with no progressive disclosure into deeper reference files. | 4 / 5 |
Total | 17 / 20 Passed |