Content
86%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 orchestration layer: exact commands, verbatim prompts, explicit mode routing, and guardrails (no-argument guard, do-not-unblock rationale, fixed review-independence notice), with all detailed steps correctly pushed to six flat, clearly signaled reference files. The only real costs are the five-times-repeated delegation boilerplate and validation detail that lives entirely in the references rather than the body. No suggestions — the structure is strong as-is.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and directive with no basic-concept padding (it references `.claude/docs/director-gates.md` and engine docs without explaining them), but the two-sentence delegation formula "Read it now and follow it — this phase's steps are in that file, not here. Read it again if the conversation was compacted or resumed" is repeated verbatim five times and could be stated once, fitting anchor 4 (efficient with minor trimmable over-explanation). | 4 / 5 |
Actionability | Guidance is fully concrete: an executable bash resolve_config command, exact argument patterns ("retrofit <path>", "accept <ADR-id>"), a literal scan instruction ("Scan `docs/architecture/`"), a copy-paste widget format template, verbatim user prompts, and a verbatim fixed notice — all common cases (normal authoring, retrofit, accept, no-argument) have specific handling, matching anchor 5. | 5 / 5 |
Workflow Clarity | The sequence is explicit (Phase 0 mode detection with a no-argument guard, then numbered phases 1-6) with strong checkpoints at the boundaries (gate-based spawned validation, write approval, the "Do NOT unblock stories" guard, the pre-widget checklist), fitting anchor 4; it is not a 5 because the body itself delegates the intra-phase validation loops for phases 3-5 to the reference files rather than spelling them out inline. | 4 / 5 |
Progressive Disclosure | The body is a clean router: six reference files, each clearly signaled ("Read `references/N-x.md` now and follow it"), all verified to exist and flat in one directory with self-identifying headers ("Part of `/architecture-decision`") and only a single flat sibling cross-reference (0-retrofit.md → 5-generate.md), matching anchor 5 (clear overview with well-signaled one-level-deep references). | 5 / 5 |
Total | 18 / 20 Passed |