Content
81%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 strong operational body: sequenced workflow with executable commands, decision gates, hard rules, and a real, verified bundle. It scores high on workflow clarity and actionability; the remaining headroom is de-duplicating claims repeated across sections and moving canon depth out of the inlined forcing-question library into a reference file.
Suggestions
Show or link the input schemas for draft_input.json and deal_context.json (or state up front that `--sample` emits the full template) so step 2 and step 4 inputs can be composed without discovery.
State the late-entry ~15%, incumbent ~30%, and GAP hard rule once — in Assumptions — and have Anti-patterns and forcing-questions reference them rather than restate them with different numbers framing.
Move the per-question canon citations of the forcing-question library into references/shipley_method_canon.md (or a dedicated forcing-questions reference), keeping the seven questions and recommended answers inline for the walk-through.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense and assumes competence — it never tutorials what an RFP or the Shipley method is, and sections carry opinionated domain content Claude does not reliably know (factor weights, thresholds, canon citations). Minor tightening available: the late-entry ~15% penalty, the GAP hard rule, and the theme-threading rule each appear in two or three sections (Purpose, Assumptions, Anti-patterns, forcing-questions) with slightly different framing. | 4 / 5 |
Actionability | Each workflow step has a copy-paste command ("python scripts/rfp_parser.py --input rfp.md --output json > parsed.json") plus hard thresholds ("estimate < 20% triggers automatic no-bid", "STRONG ≥ 70% on MANDATORY before bidding") and "--help and --sample work on all three". The minor gap: the input files for steps 2 and 4 (draft_input.json, deal_context.json) have their structure delegated to --sample rather than shown or schema-documented in the body, so first-run composition requires discovering the sample. | 4 / 5 |
Workflow Clarity | Clear 5-step sequence with explicit checkpoints and feedback loops: the forcing-question library is a walked checklist ("Walked one at a time before any script runs", "Lock 1-3 before opening 4-7") with error recovery ("If question 6 lands on 'we don't have a threshold,' set one now or no-bid"), the GAP audit gates the leadership decision at step 2, and the no-bid threshold gates step 4→5. Matches the anchor for clear sequence + explicit validation + feedback loops + checklists. | 5 / 5 |
Progressive Disclosure | Good structure with real one-level-deep references — all listed paths (rfp_parser.py, response_drafter.py, winrate_predictor.py, rfp_intake_template.md, and the three references/*.md canon files) exist, and the body navigates to them ("See `references/rfp_anti_patterns.md`"). Minor gaps: the 33-line forcing-question library and per-question canon citations are inlined where a reference file could hold the depth, and the References section lists source authors per file rather than signaling when to open each one. | 4 / 5 |
Total | 17 / 20 Passed |