Skip to content

feat(models): add Fable orchestration/delegation policy - #6

Merged
gsdevme merged 1 commit into
mainfrom
feat/models-delegation-policy
Sep 4, 2026
Merged

gsdevme merged 1 commit into
mainfrom
feat/models-delegation-policy

Conversation

@gsdevme

@gsdevme gsdevme commented Sep 4, 2026

Copy link
Copy Markdown
Owner

Summary

Adds a new models.md topic that defines a model-delegation policy for Claude Code: treat the Fable session model as an orchestrator that spends its expensive tokens only on decomposition, judgment, and synthesis, and delegates real work to cheaper opus/sonnet worker agents via the Agent tool.

The topic is placed first in TOPIC_FILES, matching its "read first" framing, so it leads both the Claude @-imports in ~/.claude/CLAUDE.md and the concatenated Codex .agents/AGENTS.md.

Contents of models.md

  • Scope note — explicitly Claude Code-only (Fable, the Agent tool, teammates); Codex still receives the file but is told it can ignore it.
  • Delegation policy — opus as the default worker tier (preferring claude-opus-4-8), sonnet as the cheap tier for low-risk rote work.
  • Reasoning effort per tier — Fable medium; opus and sonnet workers high.
  • Delegation by task — routing for exploration/research, implementation, verification/review, and when Fable edits directly.
  • Token rules — don't echo file contents/diffs, front-load paths and constraints into agent prompts, batch independent launches.

Changes

  • models.md — new topic (Claude Code-scoped).
  • Makefile — models.md prepended to TOPIC_FILES, driving both generated outputs.
  • README.md — installed-layout tree updated to list models.md first.
  • tests/apply.bats — the three hardcoded helpers (expected_claude, expected_agents, make_fixture_repo) updated to include models.md first. These were needed because the default-TOPIC_FILES tests exercise the real Makefile.

Test plan

  • make apply renders both documents; ~/.claude/CLAUDE.md imports models.md as its first @-import and .agents/AGENTS.md opens with the # Model delegation content.
  • make test — the full Bats suite (13 tests) passes.

🤖 Generated with Claude Code

Add a Claude Code-scoped topic defining Fable as the orchestrator that
delegates work to cheaper opus/sonnet worker agents via the Agent tool,
with per-tier reasoning effort, task-type routing, and token rules.

Place models.md first in TOPIC_FILES so it leads both the Claude
@-imports and the Codex concatenation, and update the tests and README
layout to match.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@gsdevme
gsdevme merged commit 40864a4 into main Sep 4, 2026
4 checks passed
@gsdevme
gsdevme deleted the feat/models-delegation-policy branch September 4, 2026 13:47
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.

1 participant