Content
67%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 highly actionable, validation-rich orchestration guide with excellent reference structure and explicit stop conditions, feedback loops, and decision tables. Its main weaknesses are duplicated inline content (the companion-executor pseudocode vs. the Codex section vs. the deferred references) and inline changelog/version noise that should be isolated or moved to reference files.
Suggestions
Conciseness: remove the ~60-line inline pseudocode block in "Backend-resolved executor path" — it duplicates the companion worktree/review workflow that is already shown as executable bash in the Codex モード section and deferred to references/backend-selection.md and references/review-loop.md; keep only a short summary plus the reference pointers.
Conciseness: move internal changelog citations ("2026-07-24 operator 裁定", "133.9", "140.3", and CC version pins like 2.1.217/2.1.219) into an 'old patterns' or changelog reference file so the operational rules stay lean in the main body.
Progressive disclosure: fix the anchor links to match the actual headings in references/execution-modes.md ("#solo--detailed-steps" / "#breezing--phase-detail") and qualify the docs/plans/spec-ssot.md pointer as a host-project path so it is not mistaken for a bundle file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and free of concept re-explanation, but the ~60-line pseudocode block ("Backend-resolved executor path") duplicates the companion workflow that is repeated again in the Codex モード section and also deferred to references/backend-selection.md and references/review-loop.md, violating its own disclosure principle. Inline changelog noise ("2026-07-24 operator 裁定", "133.9", "140.3", CC 2.1.217/2.1.219 pins) is not isolated in a deprecated section, so it could be tightened — anchor 3, not 2, since there is no padded explanation, only duplication. | 3 / 5 |
Actionability | Concrete executable commands appear throughout (resolve-impl-backend.sh, companion invocations with env vars, worktree creation, cherry-pick ranges) plus decision tables for mode and backend selection. It is not anchor 5 because the large orchestration block is non-executable pseudocode and helpers like read_contract/codex_exec_review are invoked without inline definition; not anchor 3 because the bash blocks are copy-paste ready and cover common cases. | 4 / 5 |
Workflow Clarity | Sequences are clear (TDD Red → sprint-contract → 実装 → review loop → commit; Phase A/B/C) with explicit validation checkpoints (self_review gate, two-stage contract grep before cherry-pick, commit-presence checks) and feedback loops (MAX_REVIEWS cap, 3-fail CI stop, EscalationError). It falls short of anchor 5 because the solo 1-17 step detail lives entirely in references and the top-level flow is fragmented across many sections, leaving minor inline sequencing gaps. | 4 / 5 |
Progressive Disclosure | An explicit Progressive Disclosure table maps details to eight real references/*.md files forming a flat one-level graph with sibling cross-links, making navigation easy. Not anchor 5: the 60-line pseudocode block inlines content that belongs in references, docs/plans/spec-ssot.md is not present in the bundle, and the anchors #solo-detailed-steps / #breezing-phase-detail do not exactly match the actual headings in execution-modes.md ("Solo — Detailed Steps", "Breezing — Phase Detail"). | 4 / 5 |
Total | 15 / 20 Passed |