Content
78%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 well-engineered instruction body: dense, purposeful prose with concrete commands and decision gates, delegating detail to a real, correctly-gated reference bundle that is one level deep. The prose density and inline reliance on references for executable detail are the only things keeping conciseness and actionability from the top anchors.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence, explains no known concepts, and ties nearly every rule to a failure mode ("Do not fake the dimension being tested", "Do not start a preview or invent how it should feel"); a few guardrail sentences and the dense conditional prose could still be tightened, keeping it below the lean anchor 5. | 4 / 5 |
Actionability | Concrete guidance is present — the exact probe "git -C <repo root> check-ignore -q .context/compound-engineering/" with the trailing-slash requirement, explicit directory patterns, and exact invocation renderings — but key execution detail (server commands, sizing, yields) is delegated to references rather than executable inline, leaving minor gaps. | 4 / 5 |
Workflow Clarity | The scope → build → keep decisions → apply/continue sequence is clear with checkpoints (stop when no human is present, probe gitignore before resolving the root, "Do not build until authorized", report files you cannot restore); validation of the restored overlay tree is left somewhat implicit, holding it below the explicit-feedback-loop anchor 5. | 4 / 5 |
Progressive Disclosure | Verified against the actual bundle: all six references cited in the body (scoping.md, build.md, preview.md, annotation-loop.md, craft-floor.md, write-back.md) exist, are one level deep, and each is gated to the point in the flow where it is needed; scripts/light-webserver.js and the annotate assets sit behind those references, giving a clear overview with easy navigation. | 5 / 5 |
Total | 17 / 20 Passed |