eho/atomic-design-poc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(dx): model-routed custom agents (planner/developer/task-runner)

Browse Source 
Pin the model to the step, not the whole session, via .claude/agents/*.md frontmatter
instead of relying on a human to run /model at the right moment: planner (Opus, no
Edit/Write) for design work, developer (Sonnet) for implementation, task-runner (Haiku,
no Edit/Write) for mechanical read-only checks. CLAUDE.md documents the routing rule;
the backlog session protocol now names these agents instead of a manual /model instruction.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
eho
2026-07-27 14:35:40 +02:00
co-authored by Claude Sonnet 5
parent 7b6cabfc4a
commit 67170fbc84
5 changed files with 66 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/project/backlog/README.md
+7 -6
View File
@@ -11,12 +11,13 @@ This backlog **supersedes `docs/project/SHOWCASE-ROADMAP.md`**.
- **One WP per session.** Read `CLAUDE.md`, this README, the WP file, and the WP's
"Read first" list — then execute. Do not start the next WP in the same session.
- **Match the model to the step, not the whole session.** Plan/design under Opus (`/model
opus`) — a WP's approach and edge cases deserve the stronger model. Switch to Sonnet to
write the code once the plan is approved — routine implementation against a pre-made
Decisions block doesn't need Opus. Delegate simple, read-only CLI checks (running a test
suite, `grep`/`git status`, verifying a file exists) to a Haiku subagent where the harness
supports it — proportion cost to the step's difficulty, not the WP's.
- **Match the model to the step, not the whole session** (see CLAUDE.md's "Model routing
for agent delegation"). Read the WP's Decisions block with the `planner` agent (Opus) if
the current session isn't already Opus — the approach and edge cases deserve the
stronger model. Implement directly if already on Sonnet, or hand off to the `developer`
agent otherwise, once the plan is approved. Delegate simple, read-only CLI checks
(running a test suite, `grep`/`git status`, verifying a file exists) to the `task-runner`
agent (Haiku) — proportion cost to the step's difficulty, not the WP's.
- The **Decisions** block in each WP is pre-made — don't relitigate it.
- A WP ends **GREEN** (below) with its acceptance criteria checked off and its Status
updated to `done` (+ commit hash).