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 well-engineered control-flow document: strict step ordering, exhaustive outcome branching with explicit stops, preserved retry loops, and clean one-level-deep progressive disclosure into real, well-scoped reference files. Its only weaknesses are minor redundancy between the Rules and Workflow sections and the total delegation of concrete examples to references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, imperative, and assumes Claude's competence throughout, with no explanations of known concepts. However, the '## Rules' section restates branching already specified in the Workflow (e.g., 'On failed, print the handoff Markdown as returned and stop' duplicates the failed branch), and justificational asides like 'That property is load-bearing...' could be trimmed. This matches 'efficient; minor instances of over-explanation that could be trimmed' rather than the fully lean level 5. | 4 / 5 |
Actionability | Guidance is concrete and executable: exact reference files per step, exhaustive branching on the three Status values with explicit stops, {plan-path}/{candidate-path} defined so every emitted command is directly runnable, and a named Completion layout in references/output.md. It stops short of level 5 only because the body itself contains no examples of the reports or layouts it mandates — all sample content lives in the references, leaving minor gaps if a reference were unavailable. | 4 / 5 |
Workflow Clarity | A strict two-step sequence with read-before-run gates, explicit validation checkpoints (branch on blocked/failed/validated), feedback loops for error recovery (failed handoff ending in '/validate {plan-path}' retry), and explicit stop conditions for every outcome. This matches the anchor for a clear sequence with explicit validation steps and feedback loops. | 5 / 5 |
Progressive Disclosure | The ~100-line body holds only control flow, with a table mapping each step to its reference file; all three referenced files (references/validation.md, references/validation-report.md, references/output.md) exist, are one level deep, and are clearly signaled with when to read them (including the point-in-time note for validation-report.md on validated/failed only). This matches the anchor for a clear overview with well-signaled one-level-deep references and easy navigation. | 5 / 5 |
Total | 18 / 20 Passed |