docs(fleet): record per-agent model switch in north star #667

Merged
jason.woltje merged 1 commits from docs/north-star-per-agent-model-switch into main 2026-06-24 18:14:38 +00:00
Owner

What

Adds a Decisions of record (2026-06-24) block to docs/fleet/north-star.md capturing two decisions from today's session with Jason:

  1. Per-agent model switch (operator-configurable, NOT a global lock): model is selected per-agent via the existing roster model_hint plumbing (model_hintMOSAIC_AGENT_MODELstart-agent-session.sh --model <hint>). North-star target: surface it as a per-agent model switch in the webUI (CLI/TUI parity per MVP-X1), composing with the budget downgrade ladder. Claude sessions must NOT be globally pinned in ~/.claude/settings.json.
  2. Orchestrator runtime confirmed: orchestrator + enhancer run Claude Opus 4.8 in Claude Code; only workers run pi/gpt-5.5. Pi/gpt-5.5-as-orchestrator only if proven.

Why

Jason asked to capture the per-agent model switch in the north star so the idea isn't lost.

Scope

Doctrine/docs only — no implementation. One file, +19 lines.

🤖 Generated with Claude Code

## What Adds a **Decisions of record (2026-06-24)** block to `docs/fleet/north-star.md` capturing two decisions from today's session with Jason: 1. **Per-agent model switch (operator-configurable, NOT a global lock):** model is selected per-agent via the existing roster `model_hint` plumbing (`model_hint` → `MOSAIC_AGENT_MODEL` → `start-agent-session.sh --model <hint>`). North-star target: surface it as a per-agent **model switch in the webUI** (CLI/TUI parity per MVP-X1), composing with the budget downgrade ladder. Claude sessions must NOT be globally pinned in `~/.claude/settings.json`. 2. **Orchestrator runtime confirmed:** orchestrator + enhancer run Claude Opus 4.8 in Claude Code; only workers run pi/gpt-5.5. Pi/gpt-5.5-as-orchestrator only if proven. ## Why Jason asked to capture the per-agent model switch in the north star so the idea isn't lost. ## Scope Doctrine/docs only — no implementation. One file, +19 lines. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
jason.woltje added 1 commit 2026-06-24 18:05:40 +00:00
docs(fleet): record per-agent model switch in north star
All checks were successful
ci/woodpecker/push/ci Pipeline was successful
ci/woodpecker/pr/ci Pipeline was successful
6ea4ef62ee
Per-agent model selection (operator-configurable, webUI switch over the
existing roster model_hint plumbing) recorded as a decision of record so
it isn't lost. Also confirms orchestrator/enhancer run Claude Opus 4.8 in
Claude Code; only workers run pi/gpt-5.5.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
jason.woltje merged commit a8008138c8 into main 2026-06-24 18:14:38 +00:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaicstack/stack#667