From 0d50cff38873e067a64c4e3cf8c64a9d5afd4857 Mon Sep 17 00:00:00 2001 From: Sean Whalen <44679+seanthegeek@users.noreply.github.com> Date: Sun, 12 Jul 2026 09:31:23 -0400 Subject: [PATCH] Document model roles for feature work in CLAUDE.md Codifies the plan-with-Fable / implement-with-Sonnet / review-with-Fable split (Opus as fallback) for feature work and PR reviews. Co-Authored-By: Claude Sonnet 5 --- CLAUDE.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 078c29c4..749642c5 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -2,4 +2,14 @@ This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. +## Model roles for feature work + +Any new feature or modification to an existing feature must follow this model split: + +1. **Plan with Fable** (fall back to Opus only if Fable is unavailable). Enter plan mode, design the implementation, and present the plan to the user for approval or modification. Do not start implementing until the user approves the plan. +2. **Implement with Sonnet.** Once the plan is approved, carry out the implementation using Sonnet (e.g. by delegating the implementation steps to Sonnet subagents via the Agent tool with `model: "sonnet"`). +3. **Review with Fable** (fall back to Opus only if Fable is unavailable). After implementation, all work must be reviewed by Fable before it is considered done. + +**PR reviews** must also use Fable, with Opus as the fallback if Fable is unavailable. + @AGENTS.md