Content
96%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 an exceptionally lean, action-dense orchestration contract with a clear sequenced workflow, named actors, decision gates, and validation checkpoints. Its single weakness is a non-existent shared-reference path that slightly undermines progressive-disclosure navigation.
Suggestions
Fix or remove the broken reference '../_shared/review-ledger-contract.md' (the _shared directory is not present in the bundle), or note it as an optional external sibling to avoid a dead link.
Optionally inline a one-line example of the 'neutral findings result' shape the judges must return, so the Output Contract is fully copy-paste ready without opening the references file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean, directive contract that assumes Claude's competence — naming agents and rules without restating what a review or ledger is. Every section earns its tokens with no padding or known-concept explanation. Matches the top 'lean and efficient' anchor; not 4 because there are no noticeable over-explanation instances to trim. | 5 / 5 |
Actionability | Provides concrete, executable guidance: named sub-agents ('jd-judge-a', 'jd-fix-agent', 'jd-fix-agent'), a precise Decision Gates table, and an exact Output Contract with terminal verdicts ('JUDGMENT: APPROVED / ESCALATED'). Coverage of common cases is complete. Matches the top anchor; not 4 because the guidance is copy-paste ready and covers the standard flow end to end. | 5 / 5 |
Workflow Clarity | Execution Steps are explicitly sequenced with validation checkpoints ('Wait for both; never accept a partial judgment', 'Ask before round-one correction', bounded re-judgment rounds) and a Decision Gates feedback table. The destructive/batch cap is satisfied because fixes are gated on dual confirmation and round limits. Matches the top anchor with explicit validation and feedback loops; not 4 because checkpoints are present throughout rather than mostly. | 5 / 5 |
Progressive Disclosure | The body is well-organized into clear sections and points one level deep to a real bundle file ('references/prompts-and-formats.md', which exists). However the second reference '../_shared/review-ledger-contract.md' does not exist in the bundle, a minor navigation gap. Fits 'good structure, references mostly clear'; not 5 because of the broken/external shared reference, and not 3 because most content is appropriately placed and signaled. | 4 / 5 |
Total | 19 / 20 Passed |