odd-studio 2.6.0 → 2.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "odd-studio",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "Outcome-Driven Development for Claude Code — a planning and build harness for domain experts building serious software with AI.",
   "keywords": [
     "claude-code",

package/skill/SKILL.md

@@ -119,10 +119,22 @@ Enter build mode. This command runs the following checks in order before beginni
 1. Checks that `planApproved` is true in `.odd/state.json`. If not, explain that the plan must be approved before building, and offer `*plan` to complete it.
 2. Checks that `techStackDecided` is true. If not, explain that the technical architecture decision must be made first, and route to `*phase-plan` to complete it with Rachel.
 3. Checks that `servicesConfigured` is true. If not, run the **Project Setup Protocol** below before proceeding.
-4. Loads `docs/build/build-protocol.md` into context.
-5. Initialises the ruflo swarm (see Ruflo Swarm Initialisation below).
-6. Confirms to the user which phase is being worked on and which outcomes are in scope.
-7. Begins executing the Build Protocol for the current phase.
+4. **Model check.** Read the current model from the session context. If the session is running on Opus (or another high-reasoning model), display the model advisory:
+
+---
+
+**Model advisory:** You are currently on **[current model]**. The planning phase benefits from Opus-level reasoning, but the build phase runs well on **Sonnet** — it is faster, cheaper, and produces excellent code from well-specified outcomes like yours.
+
+Switch now with `/model` if you would like to use Sonnet for the build, or continue on [current model] if you prefer.
+
+---
+
+If the user switches or continues, proceed. Do not block — this is advisory only. Do not repeat the advisory if the user has already seen it in this session.
+
+5. Loads `docs/build/build-protocol.md` into context.
+6. Initialises the ruflo swarm (see Ruflo Swarm Initialisation below).
+7. Confirms to the user which phase is being worked on and which outcomes are in scope.
+8. Begins executing the Build Protocol for the current phase.
 
 ---
 
@@ -164,6 +176,41 @@ Jump directly to implementation planning. Check that contracts have been mapped.
 
 ---
 
+### `*models`
+
+Display the current model routing configuration and allow the user to customise it. Read `modelRouting` from `.odd/state.json`. If not set, display the defaults:
+
+---
+
+**Model Routing — Current Configuration**
+
+ODD Studio recommends different models for different stages of your project:
+
+| Stage | Recommended Model | Why |
+|-------|------------------|-----|
+| Planning (personas, outcomes, contracts, plan) | **Opus** | Deep reasoning about domain complexity, persona psychology, dependency analysis |
+| Building (code generation, swarm agents) | **Sonnet** | Fast, cost-effective, excellent code quality from well-specified outcomes |
+| Verification (QA checks, security scanning) | **Sonnet** | Sufficient for structured verification against known criteria |
+
+These are recommendations, not requirements. You can override any of them.
+
+To change: `*models planning sonnet` or `*models building opus`
+To reset to defaults: `*models reset`
+
+---
+
+When the user provides a subcommand like `*models [stage] [model]`:
+- Validate that `stage` is one of: `planning`, `building`, `verification`
+- Accept any model name (do not validate — the user may have access to models we do not know about)
+- Update `modelRouting.[stage]` in `.odd/state.json`
+- Display: "Model for [stage] set to [model]."
+
+When `*models reset` is called:
+- Remove the `modelRouting` field from `.odd/state.json` (revert to defaults)
+- Display: "Model routing reset to defaults."
+
+---
+
 ### `*ui`
 
 Load the UI excellence briefing. This is relevant whenever an outcome involves a screen the persona will interact with. Load `docs/ui/design-system.md`.
@@ -329,6 +376,7 @@ Display this reference:
 | `*contracts` | Map contracts with Theo |
 | `*phase-plan` | Build the Master Implementation Plan with Rachel |
 | `*ui` | Load UI excellence principles |
+| `*models` | View or change which Claude model is recommended for each stage |
 | `*swarm` | Build all independent outcomes in the current phase simultaneously |
 | `*agent` | Create a custom agent for a domain-specific concern |
 | `*export` | Generate IDE Session Brief |
@@ -652,6 +700,10 @@ techStack: string (chosen framework, e.g. "Next.js")
 orm: string (always "Drizzle")
 testingFramework: string (always "Vitest")
 servicesConfigured: boolean
+modelRouting: object (optional — omit to use defaults)
+  planning: string (default "opus")
+  building: string (default "sonnet")
+  verification: string (default "sonnet")
 ```
 
 ---