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 a tight, well-sequenced four-step workflow with explicit validation checkpoints and feedback loops, backed by a real worked-example reference and harness script. It is executable and well-structured, with only minor conciseness and placeholder gaps in the code examples.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and assumes Claude's competence (no basic-concept padding); the intro paragraph and the Prism validation-behavior explanation orient usefully but could be trimmed slightly, fitting the 4 anchor over a clean 5. | 4 / 5 |
Actionability | Provides concrete commands ('prism mock <spec> --port 13000 --cors --multiprocess=false') and a mostly executable harness example with per-scheme auth guidance, but the harness snippet relies on caller-supplied placeholders (base, token, watch paths), keeping it just short of copy-paste-ready 5. | 4 / 5 |
Workflow Clarity | Four numbered steps each carry a '**Done when:**' checkpoint, with explicit feedback loops for error recovery (crash → --multiprocess=false, taken port → pick another, Prism can't signal → harness asserts wire body), matching the 5 anchor. | 5 / 5 |
Progressive Disclosure | Clear overview body with well-signaled, one-level-deep references to a real references/coolisimplify-example.md (gated on 'when the task touches this repo's clone/API flows') and scripts/prism-harness.mjs; both files exist and content is appropriately split. | 5 / 5 |
Total | 18 / 20 Passed |