Skip to content

docs(policy): permanently codify design/execution model split (model delegation policy)#154

Merged
Yuu6798 merged 1 commit into
mainfrom
claude/dev-workflow-rules-pr150-mi8z68
Jul 6, 2026
Merged

docs(policy): permanently codify design/execution model split (model delegation policy)#154
Yuu6798 merged 1 commit into
mainfrom
claude/dev-workflow-rules-pr150-mi8z68

Conversation

@Yuu6798

@Yuu6798 Yuu6798 commented Jul 6, 2026

Copy link
Copy Markdown
Owner

Completion Summary: dev-workflow-rules (design / execution model split)

Phase

Repository operating policy (CLAUDE.md / docs). Port of the ecosystem-wide dev-workflow rule (design-model delegation discipline) into the code domain. Product code untouched.

What Changed

  • CLAUDE.md ## Workflow gains a Model split section (always-loaded operative rule): Fable (design model) is fixed to design judgment only — design, specification, review verdicts, brief drafting, phase planning. Implementation, execution, verification, and dogfooding are delegated to Opus/Sonnet executors. Route: Fable designs → Opus/Sonnet implements・executes・verifies → Fable judges the evidence.
  • Direct tool calls by Fable are allowed only when the whole operation is 1–2 calls AND every return payload is lightweight. Review-thread fetching and reply posting are always delegated regardless of call count — the measured token burner is GitHub tool return payloads (full-thread refetch, echoed diffs), not the fix work itself. When in doubt, delegate.
  • New docs/model_delegation_policy.md (ACTIVE, 101 lines): full policy — measured rationale, role table, main route with distilled-summary handback, direct-call criteria with examples, always-delegate list, relationship to the AGENTS.md Codex handoff (unchanged; Claude-exception route now runs implementation through executor subagents), user override, scope-guard non-goal, enforcement notes.
  • Line budget: to respect the 300-line CLAUDE.md cap, detail is offloaded to the new doc; a duplicated stale-memory sentence (Tier D) was removed and the Tech Stack list compressed to prose — zero rules removed. CLAUDE.md lands at 297/300.
  • Design Documents table (+1 ACTIVE row) and README documentation list updated per the CLAUDE.md doc-registration rule.

Acceptance Criteria Status

  • Operative rule lives in the always-loaded CLAUDE.md ## Workflow — Model split section present with route + direct-call criteria
  • Thread fetch / reply posting marked always-delegate regardless of call count — encoded in both CLAUDE.md and the policy doc §5
  • Full policy externalized to docs/model_delegation_policy.md and registered in the Design Documents table + README — both cross-references verified
  • CLAUDE.md ≤ 300-line discipline cap holds — 297 lines, test_claude_md_line_cap green
  • AGENTS.md Codex handoff unchanged — no edits to AGENTS.md; relationship pinned in policy doc §6

Tests

  • Added: none (agent-behavior policy is not structurally enforceable by pytest; enforcement = always-loaded CLAUDE.md rule, see policy doc §8)
  • Result: python -m pytest tests/discipline/ -q --no-cov → 36 passed; ruff check . → clean

Dogfooding

  • Status: performed
  • Commands: verification (discipline suite + ruff + cross-reference sanity) was delegated to a Sonnet executor subagent per the new rule itself; the design model received only the distilled summary
  • Result: 36 passed / ruff clean / all cross-references resolve — first live pass of the Fable→executor→Fable route this PR codifies

Files Changed

CLAUDE.md                        | 43 +++++++++++++++--------
README.md                        |  1 +
docs/model_delegation_policy.md  | 101 ++++++++++++++++++++++++++++++ (new)
3 files changed, 126 insertions(+), 20 deletions(-)

Deviations from Brief

None. (Provenance note: the 7-round-review token measurement originates from an ecosystem sibling-repo session, so the policy doc cites it as an ecosystem measurement rather than a PR number in this repo, avoiding a false cross-reference to this repo's #149.)

Open Questions / Deferred

  • Leading indicator (direct GitHub-call count per Fable session / tokens per review round) is observational for now; revisit at wrap-up whether any part can be test-encoded.

Next Handoff

Review the Model split wording in CLAUDE.md ## Workflow and the always-delegate list in docs/model_delegation_policy.md §5; merge when satisfied.

🤖 Generated with Claude Code

https://claude.ai/code/session_01CmnG4powRuRvD37unq7i1m


Generated by Claude Code

…delegation rules)

Port the ecosystem-wide dev-workflow rule into the code domain:

- CLAUDE.md ## Workflow gains a Model split section: Fable (design
  model) is fixed to design judgment only; implementation, execution,
  verification, and dogfooding are delegated to Opus/Sonnet executors.
  Route: Fable designs -> Opus/Sonnet implements/executes/verifies ->
  Fable judges the evidence.
- Direct tool calls by Fable are allowed only for 1-2 call operations
  whose return payloads are lightweight. Review-thread fetching and
  reply posting are ALWAYS delegated regardless of call count: measured
  token burn came from GitHub tool return payloads (full-thread
  refetch, echoed diffs), not from the fix work itself.
- Full policy (rationale, role table, always-delegate list, AGENTS.md
  relationship, enforcement) offloaded to
  docs/model_delegation_policy.md (ACTIVE) to respect the 300-line
  CLAUDE.md cap; Design Documents table + README list updated.
- Line budget: drop a duplicated stale-memory sentence (Tier D) and
  compress the Tech Stack list to prose (no rule removed); CLAUDE.md
  lands at 297/300.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CmnG4powRuRvD37unq7i1m
@Yuu6798 Yuu6798 merged commit 6338dc0 into main Jul 6, 2026
4 checks passed
@Yuu6798 Yuu6798 deleted the claude/dev-workflow-rules-pr150-mi8z68 branch July 6, 2026 22:46
Yuu6798 pushed a commit that referenced this pull request Jul 7, 2026
…査 planning (#155) 反映

- 2026-07-07.md reflection 新設 (体制ルール 2 層化 / 委譲調査→S1-S8→
  Wave 1-3 / Codex 8 巡 P2 x10 / 委譲ループで生ペイロード直撃ゼロの実測)
- _index.md 1 行追記
- 30 日 TTL: dated log 11 file を archive/2026-05, 2026-06 へ移送
  (2026-06 dir 新設)、_index Detail path 更新、archive/INDEX.md 反映
- STATUS.md: Phase 1 段落更新 / 直近 merged に #154+#155 追加・#148 を
  STATUS_MERGED_LOG へ移送 / 次の発行順序を Wave 1 参照に更新

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CmnG4powRuRvD37unq7i1m
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants