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.
The body is highly actionable with executable commands and a well-sequenced workflow, and it avoids over-explaining known concepts. Its main weakness is that the referenced bundle files (references/, scripts/, assets/) do not exist, breaking progressive-disclosure navigation, with a minor validation-loop gap in the workflow.
Suggestions
Ship the referenced bundle files (scripts/deal_scorer.py, scripts/discount_approval_router.py, scripts/terms_redliner.py, references/*.md, assets/deal_intake_template.md) or remove the references so navigation resolves.
Move the critical-signal override ('UNCAPPED_INDEMNITY blocks APPROVE') from Anti-patterns into the Workflow as an explicit gating checkpoint between the score and route steps.
Tighten the forcing-question library — the per-question canon citations could be condensed or moved to a reference file to reduce token load in the main body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and assumes Claude's competence (no explanation of MSA/MFN/DPA), but the 7-item forcing-question library with per-question canon citations and verbose reference source lists add tokens that don't all earn their place. | 4 / 5 |
Actionability | Provides copy-paste-ready commands ('python3 scripts/deal_scorer.py --input my_deal.json --profile enterprise-software', '--sample', '--output json') plus a scripts table documenting flags and profiles, covering the common cases. | 5 / 5 |
Workflow Clarity | Clear 5-step sequenced workflow with per-step script invocations and a real validation gate (critical-signal override: 'A high composite with UNCAPPED_INDEMNITY is still a DECLINE'); the explicit validate-fix-retry loop is only implied and the override rule lives in anti-patterns rather than the workflow itself, leaving a minor checkpoint gap. | 4 / 5 |
Progressive Disclosure | The overview is well-structured with clearly signaled one-level-deep references (references/deal_desk_canon.md, scripts/deal_scorer.py, assets/deal_intake_template.md), but none of the referenced bundle files or directories actually exist, so the navigation breaks. | 3 / 5 |
Total | 16 / 20 Passed |