5-phase-workflow 1.8.9 → 1.9.1

package/bin/install.js

@@ -38,13 +38,17 @@ function compareVersions(v1, v2) {
 }
 
 // Get installed version from .5/version.json
+// Reads per-runtime version when available (runtimes[activeRuntime].packageVersion),
+// falling back to top-level packageVersion for backward compatibility.
 function getInstalledVersion(isGlobal) {
   const versionFile = path.join(getDataPath(isGlobal), 'version.json');
   if (!fs.existsSync(versionFile)) return null;
 
   try {
     const data = JSON.parse(fs.readFileSync(versionFile, 'utf8'));
-    return data.packageVersion;
+    return (data.runtimes && data.runtimes[activeRuntime] && data.runtimes[activeRuntime].packageVersion)
+      || data.packageVersion
+      || null;
   } catch (e) {
     return null; // Corrupted file, treat as missing
   }
@@ -280,8 +284,7 @@ const LEGACY_REMOVED_FILES = [
   'templates/STACK.md',
   'templates/STRUCTURE.md',
   'templates/CONVENTIONS.md',
-  'templates/INTEGRATIONS.md',
-  'skills/configure-project'
+  'templates/INTEGRATIONS.md'
 ];
 
 // Get list of workflow-owned files/directories (not user-created)
@@ -298,6 +301,7 @@ function getWorkflowManagedFiles() {
     // Skills: specific skill directories
     skills: [
       'configure-docs-index',
+      'configure-project',
       'configure-skills',
       'generate-readme'
     ],
@@ -624,7 +628,10 @@ function cleanupOrphanedFiles(targetPath, dataDir) {
   if (fs.existsSync(versionFile)) {
     try {
       const data = JSON.parse(fs.readFileSync(versionFile, 'utf8'));
-      oldManifest = data.manifest || null;
+      // Prefer per-runtime manifest to avoid cross-runtime orphan cleanup
+      oldManifest = (data.runtimes && data.runtimes[activeRuntime] && data.runtimes[activeRuntime].manifest)
+        || data.manifest
+        || null;
     } catch (e) {
       // Corrupted file, treat as no manifest
     }
@@ -651,7 +658,12 @@ function cleanupOrphanedFiles(targetPath, dataDir) {
     for (const entry of LEGACY_REMOVED_FILES) {
       const fullPath = path.join(targetPath, entry);
       if (fs.existsSync(fullPath)) {
-        fs.unlinkSync(fullPath);
+        const stat = fs.statSync(fullPath);
+        if (stat.isDirectory()) {
+          removeDir(fullPath);
+        } else {
+          fs.unlinkSync(fullPath);
+        }
         log.info(`Removed legacy orphan: ${entry}`);
       }
     }
@@ -672,27 +684,73 @@ function ensureDotFiveGitignore(dataDir) {
   }
 }
 
-// Initialize version.json after successful install
-function initializeVersionJson(isGlobal) {
-  const dataDir = getDataPath(isGlobal);
+// Write (or update) version.json, preserving per-runtime state for other runtimes.
+// - Reads existing file to preserve the other runtime's runtimes[] entry.
+// - Writes runtimes[activeRuntime] with current version + manifest.
+// - Top-level packageVersion = minimum across all runtime versions (so hooks
+//   detect an update if ANY runtime is behind).
+function writeVersionJson(dataDir, isGlobal, version) {
   const versionFile = path.join(dataDir, 'version.json');
+  const now = new Date().toISOString();
 
-  if (!fs.existsSync(dataDir)) {
-    fs.mkdirSync(dataDir, { recursive: true });
+  let existing = {};
+  if (fs.existsSync(versionFile)) {
+    try {
+      existing = JSON.parse(fs.readFileSync(versionFile, 'utf8'));
+    } catch (e) {
+      existing = {};
+    }
   }
 
-  const version = getPackageVersion();
-  const now = new Date().toISOString();
-
-  const versionData = {
+  const runtimes = existing.runtimes || {};
+  runtimes[activeRuntime] = {
     packageVersion: version,
-    installedAt: now,
     lastUpdated: now,
-    installationType: isGlobal ? 'global' : 'local',
     manifest: getFileManifest()
   };
 
+  // Top-level packageVersion = min across all runtime versions
+  const runtimeVersions = Object.values(runtimes).map(r => r.packageVersion).filter(Boolean);
+  const minVersion = runtimeVersions.reduce((min, v) => compareVersions(v, min) < 0 ? v : min, version);
+
+  const versionData = {
+    packageVersion: minVersion,
+    installedAt: existing.installedAt || now,
+    lastUpdated: now,
+    installationType: existing.installationType || (isGlobal ? 'global' : 'local'),
+    manifest: runtimes[activeRuntime].manifest,
+    runtimes
+  };
+
+  if (!fs.existsSync(dataDir)) {
+    fs.mkdirSync(dataDir, { recursive: true });
+  }
   fs.writeFileSync(versionFile, JSON.stringify(versionData, null, 2));
+}
+
+// Detect which runtimes are actually installed by probing marker files.
+function getInstalledRuntimes(isGlobal) {
+  const installed = [];
+  const saved = activeRuntime;
+  for (const rt of ['claude', 'codex']) {
+    activeRuntime = rt;
+    const tp = getTargetPath(isGlobal);
+    if (checkExistingInstallation(tp)) installed.push(rt);
+  }
+  activeRuntime = saved;
+  return installed;
+}
+
+// Initialize version.json after successful install
+function initializeVersionJson(isGlobal) {
+  const dataDir = getDataPath(isGlobal);
+
+  if (!fs.existsSync(dataDir)) {
+    fs.mkdirSync(dataDir, { recursive: true });
+  }
+
+  const version = getPackageVersion();
+  writeVersionJson(dataDir, isGlobal, version);
   ensureDotFiveGitignore(dataDir);
   log.success('Initialized version tracking');
 }
@@ -863,25 +921,8 @@ function performUpdate(targetPath, sourcePath, isGlobal, versionInfo) {
   // Merge settings (deep merge preserves user customizations)
   mergeSettings(targetPath, sourcePath);
 
-  // Update version.json
-  const versionFile = path.join(dataDir, 'version.json');
-  const now = new Date().toISOString();
-
-  const existing = fs.existsSync(versionFile)
-    ? JSON.parse(fs.readFileSync(versionFile, 'utf8'))
-    : {};
-  const versionData = {
-    packageVersion: versionInfo.available,
-    installedAt: existing.installedAt || now,
-    lastUpdated: now,
-    installationType: existing.installationType || (isGlobal ? 'global' : 'local'),
-    manifest: getFileManifest()
-  };
-
-  if (!fs.existsSync(dataDir)) {
-    fs.mkdirSync(dataDir, { recursive: true });
-  }
-  fs.writeFileSync(versionFile, JSON.stringify(versionData, null, 2));
+  // Update version.json (per-runtime, preserving other runtime's state)
+  writeVersionJson(dataDir, isGlobal, versionInfo.available);
   ensureDotFiveGitignore(dataDir);
 
   // Create features directory if it doesn't exist
@@ -1087,24 +1128,8 @@ function performCodexUpdate(targetPath, sourcePath, isGlobal, versionInfo) {
   const dataDir = getDataPath(isGlobal);
   cleanupOrphanedFiles(targetPath, dataDir);
 
-  // Update version.json
-  const versionFile = path.join(dataDir, 'version.json');
-  const now = new Date().toISOString();
-  const existing = fs.existsSync(versionFile)
-    ? JSON.parse(fs.readFileSync(versionFile, 'utf8'))
-    : {};
-  const versionData = {
-    packageVersion: versionInfo.available,
-    installedAt: existing.installedAt || now,
-    lastUpdated: now,
-    installationType: existing.installationType || (isGlobal ? 'global' : 'local'),
-    manifest: getFileManifest()
-  };
-
-  if (!fs.existsSync(dataDir)) {
-    fs.mkdirSync(dataDir, { recursive: true });
-  }
-  fs.writeFileSync(versionFile, JSON.stringify(versionData, null, 2));
+  // Update version.json (per-runtime, preserving other runtime's state)
+  writeVersionJson(dataDir, isGlobal, versionInfo.available);
   ensureDotFiveGitignore(dataDir);
 
   const featuresDir = path.join(dataDir, 'features');
@@ -1211,6 +1236,7 @@ function install(isGlobal, forceUpgrade = false) {
       log.warn('Detected legacy installation (no version tracking)');
       log.info(`Upgrading from legacy install to ${versionInfo.available}`);
       update(targetPath, sourcePath, isGlobal, versionInfo);
+      updateOtherRuntime(isGlobal);
       return;
     } else if (versionInfo.needsUpdate) {
       log.info(`Installed: ${versionInfo.installed}`);
@@ -1230,11 +1256,13 @@ function install(isGlobal, forceUpgrade = false) {
             return;
           }
           update(targetPath, sourcePath, isGlobal, versionInfo);
+          updateOtherRuntime(isGlobal);
         });
         return; // Wait for user input
       }
       // Force upgrade, no prompt
       update(targetPath, sourcePath, isGlobal, versionInfo);
+      updateOtherRuntime(isGlobal);
       return;
     } else {
       // Same version
@@ -1247,6 +1275,31 @@ function install(isGlobal, forceUpgrade = false) {
   freshInstall(targetPath, sourcePath, isGlobal);
 }
 
+// After updating the active runtime, check if the other runtime is also installed
+// and needs an update. Updates it silently if so.
+function updateOtherRuntime(isGlobal) {
+  const primaryRuntime = activeRuntime;
+  const installed = getInstalledRuntimes(isGlobal);
+
+  for (const rt of installed) {
+    if (rt === primaryRuntime) continue;
+
+    activeRuntime = rt;
+    const tp = getTargetPath(isGlobal);
+    const sp = getSourcePath();
+    const vi = getVersionInfo(tp, isGlobal);
+
+    if (vi.exists && (vi.needsUpdate || vi.legacy)) {
+      const updateFn = rt === 'codex' ? performCodexUpdate : performUpdate;
+      updateFn(tp, sp, isGlobal, vi);
+    } else if (vi.exists) {
+      log.success(`${rt}: already at version ${vi.installed}`);
+    }
+  }
+
+  activeRuntime = primaryRuntime;
+}
+
 // Perform uninstallation
 function uninstall() {
   if (activeRuntime === 'codex') {
@@ -1270,7 +1323,12 @@ function uninstall() {
   for (const entry of LEGACY_REMOVED_FILES) {
     const fullPath = path.join(targetPath, entry);
     if (fs.existsSync(fullPath)) {
-      fs.unlinkSync(fullPath);
+      const stat = fs.statSync(fullPath);
+      if (stat.isDirectory()) {
+        removeDir(fullPath);
+      } else {
+        fs.unlinkSync(fullPath);
+      }
       log.info(`Removed legacy orphan: ${entry}`);
     }
   }
@@ -1359,25 +1417,48 @@ function main() {
   }
 
   if (options.check) {
-    const targetPath = getTargetPath(options.global);
     migrateDataDir(options.global);
-    const versionInfo = getVersionInfo(targetPath, options.global);
 
-    if (!versionInfo.exists) {
-      log.info(`Not installed (${activeRuntime})`);
+    // When --codex is explicitly passed, check only Codex. Otherwise check all installed runtimes.
+    const runtimesToCheck = options.runtime === 'codex'
+      ? ['codex']
+      : getInstalledRuntimes(options.global);
+
+    if (runtimesToCheck.length === 0) {
+      log.info('Not installed');
       return;
     }
 
-    log.info(`Runtime: ${activeRuntime}`);
-    log.info(`Installed: ${versionInfo.installed || 'legacy (no version)'}`);
-    log.info(`Available: ${versionInfo.available}`);
+    const primaryRuntime = activeRuntime;
+    let anyUpdateAvailable = false;
 
-    if (versionInfo.needsUpdate) {
-      log.warn('Update available');
-      log.info(`Run: npx 5-phase-workflow${activeRuntime === 'codex' ? ' --codex' : ''} --upgrade`);
-    } else {
-      log.success('Up to date');
+    for (const rt of runtimesToCheck) {
+      activeRuntime = rt;
+      const tp = getTargetPath(options.global);
+      const vi = getVersionInfo(tp, options.global);
+
+      if (!vi.exists) {
+        log.info(`${rt}: not installed`);
+        continue;
+      }
+
+      log.info(`Runtime: ${rt}`);
+      log.info(`Installed: ${vi.installed || 'legacy (no version)'}`);
+      log.info(`Available: ${vi.available}`);
+
+      if (vi.needsUpdate) {
+        log.warn(`${rt}: update available`);
+        anyUpdateAvailable = true;
+      } else {
+        log.success(`${rt}: up to date`);
+      }
     }
+
+    if (anyUpdateAvailable) {
+      log.info('Run: npx 5-phase-workflow --upgrade');
+    }
+
+    activeRuntime = primaryRuntime;
     return;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "5-phase-workflow",
-  "version": "1.8.9",
+  "version": "1.9.1",
   "description": "A 5-phase feature development workflow for Claude Code",
   "bin": {
     "5-phase-workflow": "bin/install.js"

package/src/commands/5/configure.md

@@ -9,7 +9,7 @@ context: fork
 
 <role>
 You are a Project Configurator. You analyze a project, gather preferences, and write config.json plus a feature spec.
-You do NOT generate CLAUDE.md, documentation files, or skills directly — those are Phase 3's job.
+You do NOT generate AGENTS.md, CLAUDE.md, documentation files, or skills directly — those are Phase 3's job.
 You write ONLY to: .5/config.json, .5/version.json, .5/features/CONFIGURE/feature.md, and .gitignore.
 After writing config.json and the feature spec, you are DONE. Exit immediately.
 </role>
@@ -39,7 +39,7 @@ Your job in this command:
 ✅ Tell user to run /5:plan-implementation CONFIGURE
 
 Your job is NOT:
-❌ Create CLAUDE.md directly (Phase 3 does this)
+❌ Create AGENTS.md or CLAUDE.md directly (Phase 3 does this)
 ❌ Generate documentation files directly (Phase 3 does this)
 ❌ Generate skills directly (Phase 3 does this)
 ❌ Skip user interaction
@@ -47,7 +47,7 @@ Your job is NOT:
 
 **After writing config.json, creating the feature spec, and informing the user, YOUR JOB IS COMPLETE. EXIT IMMEDIATELY.**
 
-**If you find yourself creating CLAUDE.md, documentation files, or skills, STOP IMMEDIATELY. You should only be writing config.json and the feature spec.**
+**If you find yourself creating AGENTS.md, CLAUDE.md, documentation files, or skills, STOP IMMEDIATELY. You should only be writing config.json and the feature spec.**
 
 ## Configuration Process
 
@@ -92,8 +92,9 @@ fi
 # Set skill_creator_available=true if any skill-creator tool is found.
 ```
 
-**1e. Check CLAUDE.md:**
-- If `CLAUDE.md` exists, read its content
+**1e. Check AGENTS.md / CLAUDE.md:**
+- If `AGENTS.md` exists, read its content
+- If `AGENTS.md` does not exist but `CLAUDE.md` exists with real content (not just `@AGENTS.md`), read it — this is a legacy setup that will be migrated to AGENTS.md during Phase 3
 
 **1f. Scan existing skills:**
 - Check `.claude/skills/` for existing project-specific skills
@@ -169,7 +170,7 @@ If "Cancel": Exit immediately with message "Configuration unchanged."
 **2h. Review tool preference:**
 - "Which code review tool would you like to use?"
   - Options:
-    1. "Claude (built-in, no setup needed)" — always available
+    1. "Native (built-in agent review, no setup needed)" — always available, works with any AI coding tool
     2. "CodeRabbit CLI (requires installation)" — external tool
     3. "None (skip automated review)"
 - If user selects CodeRabbit and it was not detected in Step 1d:
@@ -207,14 +208,14 @@ The skill-creator plugin from the official Claude store helps generate higher-qu
   - If user selects "Install now": execute the install command, then set `tools.skillCreator.available = true` in the config
   - If user selects "Skip": `tools.skillCreator.available` remains `false`
 
-**2k. Confirm CLAUDE.md generation:**
-- "Generate/update CLAUDE.md? This will analyze your codebase to document structure and conventions."
+**2k. Confirm AGENTS.md generation:**
+- "Generate/update AGENTS.md? This will analyze your codebase to document structure and conventions. (A CLAUDE.md shim will also be created for Claude Code compatibility.)"
   - Options: "Yes (recommended)", "Skip"
 
 **2k2. Confirm rules generation:**
-- "Generate `.claude/rules/` files? These are scoped instruction files that automatically load when Claude works with matching file types (e.g., testing rules load only when editing test files, code-style rules load only for source files)."
+- "Generate `.claude/rules/` files? These are scoped instruction files that automatically load when the agent works with matching file types (e.g., testing rules load only when editing test files, code-style rules load only for source files)."
   - Options: "Yes (recommended)", "Skip"
-- Note: Rules complement CLAUDE.md — they provide focused, file-type-scoped directives derived from your project's actual conventions.
+- Note: Rules complement AGENTS.md — they provide focused, file-type-scoped directives derived from your project's actual conventions.
 
 **2l. Review detected patterns for skill generation:**
 
@@ -307,7 +308,7 @@ Write `.5/features/CONFIGURE/feature.md` containing all gathered data:
 # Feature: Project Configuration
 
 ## Summary
-Generates CLAUDE.md, a rebuildable codebase index, and project-specific skills. (config.json already written.)
+Generates AGENTS.md, CLAUDE.md shim, a rebuildable codebase index, and project-specific skills. (config.json already written.)
 
 ## Requirements
 
@@ -328,7 +329,7 @@ Analyze the codebase and generate focused documentation capturing only non-deriv
 - Skip empty categories; do not create placeholder index files
 - Re-running the script should fully refresh the index in place
 
-**Create CLAUDE.md:**
+**Create AGENTS.md** (provider-agnostic instructions file):
 - Project overview and build commands
 - Links to whichever `.5/` documentation files were created
 - Links to `.5/index/README.md`, the generated index files, and `.5/index/rebuild-index.sh`
@@ -348,8 +349,12 @@ Analyze the codebase and generate focused documentation capturing only non-deriv
   5. Respect SRP and DRY
   6. Make code maintainable and modular
 
-**Preserve existing content:**
-- If CLAUDE.md already exists, preserve user-written custom sections
+**Create CLAUDE.md shim:**
+- Contains only `@AGENTS.md` (Claude Code include syntax)
+
+**Migrate and preserve existing content:**
+- If AGENTS.md already exists, preserve user-written custom sections
+- If CLAUDE.md exists with real content (not just `@AGENTS.md`), migrate content to AGENTS.md and replace CLAUDE.md with the shim
 
 ### Requirement 2: Generate Project-Specific Skills
 Handled by: `configure-skills`
@@ -388,13 +393,14 @@ Only generate rules for patterns that were actually detected:
 - [ ] `.5/index/README.md` exists and documents the generated index files
 - [ ] Multiple focused `.5/index/*.md` files are generated for applicable codebase concerns
 - [ ] Empty sections omitted (no "Not detected" / "None found" placeholders)
-- [ ] `CLAUDE.md` exists with references to created `.5/` files
-- [ ] `CLAUDE.md` links to the codebase index and rebuild script
-- [ ] `CLAUDE.md` says to regenerate the index if it is older than one day
-- [ ] CLAUDE.md contains 6 coding guidelines
+- [ ] `AGENTS.md` exists with references to created `.5/` files
+- [ ] `AGENTS.md` links to the codebase index and rebuild script
+- [ ] `AGENTS.md` says to regenerate the index if it is older than one day
+- [ ] `AGENTS.md` contains 6 coding guidelines
+- [ ] `CLAUDE.md` exists and contains only `@AGENTS.md`
 - [ ] All specified project-specific skills are generated in `.claude/skills/`
 - [ ] Generated skills reference actual project conventions
-- [ ] If CLAUDE.md existed before, user-written sections are preserved
+- [ ] If AGENTS.md or CLAUDE.md existed before, user-written sections are preserved in AGENTS.md
 - [ ] `.claude/rules/` directory exists with scoped rule files (if rules generation selected)
 - [ ] Generated rules use `paths:` frontmatter for scoping where applicable
 - [ ] Rules contain concise directives, not documentation

package/src/commands/5/discuss-feature.md

@@ -92,7 +92,7 @@ Extract current state:
 - Business rules
 - Acceptance criteria
 - Alternatives considered
-- Questions & Answers
+- Decisions (with [DECIDED]/[FLEXIBLE]/[DEFERRED] labels)
 
 ### Step 3: Initial Discussion Prompt
 
@@ -117,6 +117,8 @@ Use `multiSelect: false` to get single focus area initially.
 
 Based on the user's focus area, explore the codebase if needed:
 
+**Index shortcut:** Before spawning Explore agents or running Glob/Grep, check if `.5/index/` exists. If it does, read `.5/index/README.md` first for the generation timestamp — if fresh (under 1 day old), read the relevant index files (e.g., modules.md for scope changes, routes.md for API discussions, models.md for data model questions) to quickly gather context and skip broad scanning. If outdated, inform the user they can run `.5/index/rebuild-index.sh` to refresh it. If `.5/index/` does not exist, inform the user they can run `/5:reconfigure` to generate it. In both missing/outdated cases, fall back to Glob/Grep or Explore agents for exploration.
+
 **For technical constraint discussions:**
 - Search for similar implementations
 - Check existing patterns
@@ -162,7 +164,7 @@ When user indicates they're done discussing, update `.5/features/{feature-name}/
 7. **Business Rules** - If logic clarified
 8. **Acceptance Criteria** - Add/refine verification criteria
 9. **Alternatives Considered** - Document discussed alternatives
-10. **Questions & Answers** - Append new Q&A from this session
+10. **Decisions** - Append new decisions from this session, tagged [DECIDED], [FLEXIBLE], or [DEFERRED] using Context/Decision format
 
 **Preserve existing content** - Only update sections that changed during discussion.
 

package/src/commands/5/implement-feature.md

@@ -163,7 +163,8 @@ Before executing step N (where N > 1), verify that prior steps' outputs exist on
    - Log: `"⚠ Pre-step check: {file} from step {M} component {name} not found on disk"`
    - Move the component back from `completedComponents` to `pendingComponents`
    - STOP execution for this step. Report to user: `"Step {N} blocked: prior step output missing. Re-run step {M} or fix manually."`
-3. If all files verified, proceed to 3a
+3. **Depends On check:** For each component in step N that has a `Depends On` value (not `—`), verify the named dependency component is in `completedComponents`. If a dependency is in `failedAttempts`, STOP and report: `"Step {N} component {name} blocked: dependency {dep} failed."`
+4. If all files and dependencies verified, proceed to 3a
 
 This prevents cascading failures where step N assumes step N-1's outputs exist but they don't.
 
@@ -202,11 +203,20 @@ Task tool call:
     ## Read First
     {Pattern File value(s) from plan table — executor MUST read these before writing any code}
 
+    ## Dependencies
+    {If Depends On is not "—": "This component depends on {dep-name} ({dep-file}). Read that file first to understand the exports/types you need to use."}
+    {If Depends On is "—": omit this section entirely}
+
+    ## Codebase Context (optional)
+    If you need to understand how this component relates to other modules (imports, service boundaries, data flow), check `.5/index/` for quick reference — especially modules.md and libraries.md. Only if these files exist.
+
     ## Verify
     {Verify command(s) from plan table — executor runs these after implementation}
 
     ## Implementation Notes
-    {relevant notes from plan}
+    {ONLY notes relevant to this step/component — filter by [Step N] or [component-name] prefix.
+     Include untagged notes only if they are globally relevant (e.g., "all services use dependency injection").
+     Do NOT send all notes to every agent — this wastes context.}
 ```
 
 The agent file defines the implementation process, output format, and deviation rules. If the agent file is not found (local install), fall back to `.claude/agents/component-executor.md` relative to the project root.
@@ -238,9 +248,16 @@ Mark the current step's TaskCreate task as `completed`. Mark the next step's tas
 
 For each component that returned `STATUS: failed`:
 
-1. **Assess the error:**
-   - **Small fix** (missing import, wrong path, syntax error): Fix with Edit tool directly in main context. Mark as completed. This counts as retry 1.
-   - **Large fix** (logic error, wrong pattern, missing context): Re-spawn the component-executor agent with the same prompt plus an `## Error Context` block describing the previous failure. This counts as retry 1.
+1. **Always re-spawn an agent** — NEVER fix code directly in the orchestrator context, not even for small fixes like missing imports or wrong paths. The orchestrator stays slim and delegates ALL code work.
+
+   Re-spawn the component-executor agent with the same prompt plus an `## Error Context` block describing the previous failure.
+
+   **Model upgrade on retry:** Bump the model one tier up from the original complexity:
+   - `simple` (haiku) → retry with `sonnet`
+   - `moderate` (haiku/sonnet) → retry with `sonnet`
+   - `complex` (sonnet) → retry with `sonnet` (already max)
+
+   This gives the retry agent better reasoning to solve what the first attempt couldn't.
 
 2. If the retry also fails:
    - Update `retryCount: 2` in the component's `failedAttempts` entry