ralph-teams 1.0.29 → 1.0.31

package/.claude/agents/epic-planner.md

@@ -82,4 +82,4 @@ A single implementation plan Markdown file written to the exact path the Team Le
 - Stay at design level. You may include signatures and contracts, but do not include full function bodies, code blocks, or pseudocode.
 - Design the test strategy per story, not just the code changes.
 - Reference existing patterns and keep the plan practical.
-- Your final response should confirm the exact plan file path you wrote.
+- Your final response must include a line exactly in the form `WROTE: <path>` using the exact plan file path you wrote.

package/.claude/agents/team-lead.md

@@ -10,14 +10,21 @@ Start by reading `prompts/team-lead-policy.md`. That file is the canonical Team
 
 ## Claude-Specific Rules
 
-- Use Claude subagents, not direct teammate mailboxes.
-- When the policy says to spawn the story planner, use `subagent_type: "story-planner"`.
-- When the policy says to spawn the epic planner, use `subagent_type: "epic-planner"`.
-- When the policy says to spawn the Builder, spawn a fresh Builder with `subagent_type: "builder"`.
-- When the policy says to spawn the story validator, use `subagent_type: "story-validator"`.
-- When the policy says to spawn the epic validator, use `subagent_type: "epic-validator"`.
-- When the policy says to spawn the final validator, use `subagent_type: "final-validator"`.
-- Do NOT use `SendMessage` or `shutdown_request` to coordinate story execution.
+- Use Claude agent teams, not Claude subagents.
+- Create teammates with `TeamCreate` when you need planners, builders, validators, or a merger.
+- When creating a teammate, give it the role-specific canonical prompt file to follow:
+  - epic planner -> `prompts/agents/epic-planner.md`
+  - story planner -> `prompts/agents/story-planner.md`
+  - builder -> `prompts/agents/builder.md`
+  - story validator -> `prompts/agents/story-validator.md`
+  - epic validator -> `prompts/agents/epic-validator.md`
+  - final validator -> `prompts/agents/final-validator.md`
+  - merger -> `prompts/agents/merger.md`
+- Use `SendMessage` for follow-up instructions, task assignment, redirection, and clean teammate shutdown when needed.
+- Use direct teammate messaging to coordinate planner and builder work when useful, but keep validators independent from builder reasoning. Validators should validate from acceptance criteria, plan context, code state, and commit results.
+- Builder-to-validator direct messaging is restricted to artifact or status handoff only, such as commit SHAs, verification command completion, changed-file summaries, or artifact/result paths. Do not let the Builder send reasoning, verdict framing, acceptance-criteria arguments, or coaching about what the Validator should conclude.
+- Keep Builder and Validator execution one-shot per attempt even though teammates can communicate. Create a fresh Builder for each build attempt and a fresh Validator for each validation attempt.
+- When the epic is done, clean up the team state and shut down unneeded teammates instead of leaving them idle.
 
 ## Claude Model Selection Policy
 

package/.codex/agents/epic-planner.toml

@@ -79,5 +79,5 @@ A single implementation plan Markdown file written to the exact path the Team Le
 - Stay at design level. You may include signatures and contracts, but do not include full function bodies, code blocks, or pseudocode.
 - Design the test strategy per story, not just the code changes.
 - Reference existing patterns and keep the plan practical.
-- Your final response should confirm the exact plan file path you wrote.
+- Your final response must include a line exactly in the form `WROTE: <path>` using the exact plan file path you wrote.
 """

package/.github/agents/epic-planner.agent.md

@@ -82,4 +82,4 @@ A single implementation plan Markdown file written to the exact path the Team Le
 - Stay at design level. You may include signatures and contracts, but do not include full function bodies, code blocks, or pseudocode.
 - Design the test strategy per story, not just the code changes.
 - Reference existing patterns and keep the plan practical.
-- Your final response should confirm the exact plan file path you wrote.
+- Your final response must include a line exactly in the form `WROTE: <path>` using the exact plan file path you wrote.

package/.opencode/agents/epic-planner.md

@@ -82,4 +82,4 @@ A single implementation plan Markdown file written to the exact path the Team Le
 - Stay at design level. You may include signatures and contracts, but do not include full function bodies, code blocks, or pseudocode.
 - Design the test strategy per story, not just the code changes.
 - Reference existing patterns and keep the plan practical.
-- Your final response should confirm the exact plan file path you wrote.
+- Your final response must include a line exactly in the form `WROTE: <path>` using the exact plan file path you wrote.

package/README.md

@@ -1,7 +1,10 @@
-# ralph-teams
+# ralph-teams - Loop epics and ai teams, Trust the Team-Lead, Run and Walk away
 
-Lightweight orchestration for spec-driven AI delivery: Ralph Teams loops whole teams and epics, not tiny tasks, and uses small agent teams to move from PRD to merged implementation with minimal process overhead.
-It is built for teams who want the structure of epics and user stories without the token burn and rigidity of heavier spec-execution systems.
+Lightweight orchestration for spec-driven AI delivery: Ralph Teams loops whole teams and epics, not tiny tasks, and uses small agent teams to move from PRD to merged implementation with minimal process overhead. 
+
+The Teamlead decides on which agent to spawn and which model to use depending on the task complexity. 
+
+It is built for developer who don't want to babysit their agents. Start the loop and walk away.
 
 `ralph-teams` is a lightweight and budgetfriendly CLI for running Ralph Teams: a shell-based orchestrator that initializes and reads a `prd.json`, loops through epics (not user stories), and spawns AI coding agent teams to implement work story by story. One Agent Team per Epic with fresh context. Ralph-Teams can even work on multiple epics in parallel, if there are no dependencies
 ```bash

package/dist/commands/task.d.ts

@@ -16,6 +16,11 @@ interface TaskDeps {
 }
 export declare function buildTaskPlanningPrompt(task: string, cwd: string, branch: string): string;
 export declare function buildTaskExecutionPrompt(task: string, cwd: string, branch: string): string;
+export declare function buildTaskExecutionInvocation(backend: SupportedBackend, env: NodeJS.ProcessEnv): {
+    command: string;
+    args: string[];
+    extraEnv?: NodeJS.ProcessEnv;
+};
 export declare function taskCommand(task: string, options?: TaskOptions, deps?: TaskDeps): Promise<void>;
 export {};
 //# sourceMappingURL=task.d.ts.map

package/dist/commands/task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,+BAA+B,EAA2C,MAAM,WAAW,CAAC;AAGjH,KAAK,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAEpE,UAAU,WAAW;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,QAAQ;IAChB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,UAAU,CAAC;IAC/B,+BAA+B,CAAC,EAAE,OAAO,+BAA+B,CAAC;IACzE,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC7D,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1G,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3G,gBAAgB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACxC;AAqGD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAgBzF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAwB1F;AAkHD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,WAAgB,EACzB,IAAI,GAAE,QAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAqDf"}
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,+BAA+B,EAA2C,MAAM,WAAW,CAAC;AAGjH,KAAK,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAEpE,UAAU,WAAW;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,QAAQ;IAChB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,UAAU,CAAC;IAC/B,+BAA+B,CAAC,EAAE,OAAO,+BAA+B,CAAC;IACzE,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC7D,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1G,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3G,gBAAgB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACxC;AAqGD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAgBzF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA0B1F;AAoDD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,CA+CnE;AAyCD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,WAAgB,EACzB,IAAI,GAAE,QAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAqDf"}

package/dist/commands/task.js

@@ -38,6 +38,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildTaskPlanningPrompt = buildTaskPlanningPrompt;
 exports.buildTaskExecutionPrompt = buildTaskExecutionPrompt;
+exports.buildTaskExecutionInvocation = buildTaskExecutionInvocation;
 exports.taskCommand = taskCommand;
 const child_process_1 = require("child_process");
 const readline = __importStar(require("readline/promises"));
@@ -162,6 +163,8 @@ function buildTaskExecutionPrompt(task, cwd, branch) {
         '- Work in the current repository and stay on the current branch.',
         '- Do not create or switch branches unless the user explicitly asks.',
         '- You may use story-planner, builder, and story-validator teammates when helpful.',
+        '- If the runtime is Claude, create a Claude agent team at the start of the task and use that team for delegated work instead of Claude subagents or a single-threaded solo workflow.',
+        '- If the runtime is Claude, do not execute the task as a solo Team Lead when team creation is available.',
         '- If the runtime supports teammate model choice, respect explicit config overrides first; otherwise choose cheaper models for easy work and stronger models for difficult work.',
         '- If the runtime is Codex, use these named teammate roles when spawning: story_planner_easy/story_planner_medium/story_planner_difficult, builder_easy/builder_medium/builder_difficult, story_validator_easy/story_validator_medium/story_validator_difficult.',
         '- You may skip planning for very simple tasks, but plan internally or via a story-planner teammate when the task has ambiguity or design risk.',
@@ -214,6 +217,50 @@ function buildSpawnEnv(backend, projectRoot, config, explicitAgentOverrides) {
         RALPH_TASK_PROJECT_ROOT: projectRoot,
     };
 }
+function buildTaskExecutionInvocation(backend, env) {
+    const cwd = env.RALPH_TASK_PROJECT_ROOT ?? process.cwd();
+    if (backend === 'claude') {
+        return {
+            command: 'claude',
+            args: [
+                '--agent', 'team-lead',
+                '--model', env.RALPH_MODEL_TEAM_LEAD ?? 'opus',
+                '--dangerously-skip-permissions',
+                '--teammate-mode', 'in-process',
+            ],
+            extraEnv: {
+                ...env,
+                CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS ?? '1',
+            },
+        };
+    }
+    if (backend === 'copilot') {
+        return {
+            command: 'gh',
+            args: ['copilot', '--', '--allow-all', '--no-ask-user', '-p'],
+        };
+    }
+    if (backend === 'opencode') {
+        return {
+            command: 'opencode',
+            args: ['.', '--prompt'],
+        };
+    }
+    return {
+        command: 'codex',
+        args: [
+            '-a', 'never',
+            'exec',
+            '-C', cwd,
+            '-m', env.RALPH_MODEL_TEAM_LEAD ?? 'gpt-5.3-codex',
+            '-c', 'model_reasoning_effort="high"',
+            '-s', 'workspace-write',
+            '--skip-git-repo-check',
+            '--color', 'never',
+            '--enable', 'multi_agent',
+        ],
+    };
+}
 function runSpawnedProcess(command, args, env) {
     return new Promise((resolve, reject) => {
         const child = (0, child_process_1.spawn)(command, args, {
@@ -242,31 +289,8 @@ async function runPlanningSession(prompt, backend, env) {
     }
 }
 async function runExecutionSession(prompt, backend, env) {
-    const cwd = env.RALPH_TASK_PROJECT_ROOT ?? process.cwd();
-    if (backend === 'claude') {
-        await runSpawnedProcess('claude', ['--dangerously-skip-permissions', prompt], env);
-        return;
-    }
-    if (backend === 'copilot') {
-        await runSpawnedProcess('gh', ['copilot', '--', '--allow-all', '--no-ask-user', '-p', prompt], env);
-        return;
-    }
-    if (backend === 'opencode') {
-        await runSpawnedProcess('opencode', ['.', '--prompt', prompt], env);
-        return;
-    }
-    await runSpawnedProcess('codex', [
-        '-a', 'never',
-        'exec',
-        '-C', cwd,
-        '-m', env.RALPH_MODEL_TEAM_LEAD ?? 'gpt-5.3-codex',
-        '-c', 'model_reasoning_effort="high"',
-        '-s', 'workspace-write',
-        '--skip-git-repo-check',
-        '--color', 'never',
-        '--enable', 'multi_agent',
-        prompt,
-    ], env);
+    const invocation = buildTaskExecutionInvocation(backend, env);
+    await runSpawnedProcess(invocation.command, [...invocation.args, prompt], invocation.extraEnv ?? env);
 }
 async function taskCommand(task, options = {}, deps = defaultDeps) {
     const cwd = deps.cwd();

package/dist/commands/task.js.map

@@ -1 +1 @@
-{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2HA,0DAgBC;AAED,4DAwBC;AAkHD,kCAyDC;AAhVD,iDAAiD;AACjD,4DAA8C;AAC9C,kDAA0B;AAC1B,sCAAiH;AACjH,wCAAqE;AAoBrE,MAAM,WAAW,GAAa;IAC5B,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;IACxB,IAAI,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;IAC3C,UAAU,EAAV,mBAAU;IACV,+BAA+B,EAA/B,wCAA+B;CAChC,CAAC;AAEF,MAAM,2BAA2B,GAAoC;IACnE,QAAQ,EAAE,MAAM;IAChB,YAAY,EAAE,OAAO;IACrB,WAAW,EAAE,MAAM;IACnB,OAAO,EAAE,QAAQ;IACjB,cAAc,EAAE,QAAQ;IACxB,aAAa,EAAE,QAAQ;IACvB,cAAc,EAAE,QAAQ;IACxB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF,SAAS,sBAAsB,CAAC,OAAyB;IACvD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAA,yBAAS,EAAC,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC,CAAC;YAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAA,yBAAS,EAAC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC,CAAC;YAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,aAAa,GAAG,IAAA,yBAAS,EAAC,IAAI,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE;YACpE,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QACH,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC,CAAC;YACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,IAAA,yBAAS,EAAC,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5F,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC,CAAC;YAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,cAAc,GAAG,IAAA,yBAAS,EAAC,SAAS,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClG,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC,CAAC;QACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,MAAM,GAAG,IAAA,yBAAS,EAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC,EAAE;QAC5D,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;AACvC,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAyB,EAAE,KAAa;IAClE,QAAQ,GAAG,OAAO,IAAI,KAAK,EAAE,EAAE,CAAC;QAC9B,KAAK,eAAe;YAClB,OAAO,YAAY,CAAC;QACtB,KAAK,gBAAgB;YACnB,OAAO,eAAe,CAAC;QACzB,KAAK,cAAc;YACjB,OAAO,SAAS,CAAC;QACnB,KAAK,aAAa;YAChB,OAAO,YAAY,CAAC;QACtB,KAAK,cAAc;YACjB,OAAO,eAAe,CAAC;QACzB,KAAK,YAAY;YACf,OAAO,SAAS,CAAC;QACnB,KAAK,gBAAgB;YACnB,OAAO,+BAA+B,CAAC;QACzC,KAAK,iBAAiB;YACpB,OAAO,yBAAyB,CAAC;QACnC,KAAK,eAAe;YAClB,OAAO,uBAAuB,CAAC;QACjC;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,SAAgB,uBAAuB,CAAC,IAAY,EAAE,GAAW,EAAE,MAAc;IAC/E,OAAO;QACL,gEAAgE;QAChE,mEAAmE;QACnE,EAAE;QACF,SAAS,IAAI,EAAE;QACf,oBAAoB,GAAG,EAAE;QACzB,mBAAmB,MAAM,EAAE;QAC3B,EAAE;QACF,mEAAmE;QACnE,+FAA+F;QAC/F,wCAAwC;QACxC,+CAA+C;QAC/C,oEAAoE;QACpE,8EAA8E;KAC/E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAgB,wBAAwB,CAAC,IAAY,EAAE,GAAW,EAAE,MAAc;IAChF,OAAO;QACL,uDAAuD;QACvD,2EAA2E;QAC3E,EAAE;QACF,SAAS,IAAI,EAAE;QACf,sBAAsB,GAAG,EAAE;QAC3B,mBAAmB,MAAM,EAAE;QAC3B,EAAE;QACF,QAAQ;QACR,kEAAkE;QAClE,qEAAqE;QACrE,mFAAmF;QACnF,iLAAiL;QACjL,iQAAiQ;QACjQ,gJAAgJ;QAChJ,0IAA0I;QAC1I,wFAAwF;QACxF,uIAAuI;QACvI,6DAA6D;QAC7D,kGAAkG;QAClG,EAAE;QACF,uBAAuB;KACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC/C,OAAO,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,CAAC;IACpD,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,OAAyB,EACzB,WAAmB,EACnB,MAA4C,EAC5C,sBAAgE;IAEhE,MAAM,iBAAiB,GAAG,CAAC,KAAsB,EAAU,EAAE,CAAC,CAC5D,sBAAsB,CAAC,KAAK,CAAC,KAAK,SAAS;QACzC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC,CAAC,2BAA2B,CAAC,KAAK,CAAC,CACvC,CAAC;IAEF,OAAO;QACL,GAAG,OAAO,CAAC,GAAG;QACd,aAAa,EAAE,OAAO;QACtB,qBAAqB,EAAE,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACjF,yBAAyB,EAAE,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,CAAC,cAAc,CAAC,CAAC;QACzF,wBAAwB,EAAE,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAC;QACvF,mBAAmB,EAAE,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC9E,2BAA2B,EAAE,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;QAC7F,0BAA0B,EAAE,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;QAC3F,2BAA2B,EAAE,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;QAC7F,kBAAkB,EAAE,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC5E,8BAA8B,EAAE,sBAAsB,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QACzF,kCAAkC,EAAE,sBAAsB,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QACjG,iCAAiC,EAAE,sBAAsB,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QAC/F,4BAA4B,EAAE,sBAAsB,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QACtF,oCAAoC,EAAE,sBAAsB,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QACrG,mCAAmC,EAAE,sBAAsB,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QACnG,oCAAoC,EAAE,sBAAsB,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QACrG,2BAA2B,EAAE,sBAAsB,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QACpF,uBAAuB,EAAE,WAAW;KACrC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe,EAAE,IAAc,EAAE,GAAsB;IAChF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,IAAA,qBAAK,EAAC,OAAO,EAAE,IAAI,EAAE;YACjC,KAAK,EAAE,SAAS;YAChB,GAAG;SACJ,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAmB,EAAE,EAAE;YACxC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,OAAO,qBAAqB,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,MAAc,EAAE,OAAyB,EAAE,GAAsB;IACjG,MAAM,OAAO,GAAiB,IAAA,8BAAoB,EAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAChC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,GAAG,GAAG,WAAW,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,MAAc,EAAE,OAAyB,EAAE,GAAsB;IAClG,MAAM,GAAG,GAAG,GAAG,CAAC,uBAAuB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEzD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,iBAAiB,CAAC,QAAQ,EAAE,CAAC,gCAAgC,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;QACnF,OAAO;IACT,CAAC;IAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,iBAAiB,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;QACpG,OAAO;IACT,CAAC;IAED,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,MAAM,iBAAiB,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;QACpE,OAAO;IACT,CAAC;IAED,MAAM,iBAAiB,CAAC,OAAO,EAAE;QAC/B,IAAI,EAAE,OAAO;QACb,MAAM;QACN,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,GAAG,CAAC,qBAAqB,IAAI,eAAe;QAClD,IAAI,EAAE,+BAA+B;QACrC,IAAI,EAAE,iBAAiB;QACvB,uBAAuB;QACvB,SAAS,EAAE,OAAO;QAClB,UAAU,EAAE,aAAa;QACzB,MAAM;KACP,EAAE,GAAG,CAAC,CAAC;AACV,CAAC;AAEM,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,UAAuB,EAAE,EACzB,OAAiB,WAAW;IAE5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,IAAI,mBAAU,CAAC;IACnD,MAAM,uBAAuB,GAAG,IAAI,CAAC,+BAA+B,IAAI,wCAA+B,CAAC;IAExG,IAAI,MAAM,CAAC;IACX,IAAI,sBAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,0BAAiB,EAAC,YAAY,CAAC,GAAG,CAAC,EAAE;YAC5C,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvE,CAAC,CAAC;QACH,sBAAsB,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,OAA2B,CAAC;IAC7D,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC;IAC/D,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,sFAAsF,CAAC,CAAC,CAAC;QACjH,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,sBAAsB,IAAI,sBAAsB,CAAC;IAC5E,aAAa,CAAC,OAAO,CAAC,CAAC;IAEvB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,kBAAkB,OAAO,IAAI,CAAC,CAAC,CAAC;IAEtD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,EAAE,CAAC;IACjE,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,MAAO,EAAE,sBAAsB,IAAI,EAAE,CAAC,CAAC;IAE/E,IAAI,CAAC;QACH,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,cAAc,GAAG,uBAAuB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,IAAI,kBAAkB,CAAC;YAC7D,MAAM,MAAM,CAAC,cAAc,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,MAAM,eAAe,GAAG,wBAAwB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YACpE,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,IAAI,mBAAmB,CAAC;YAC/D,MAAM,MAAM,CAAC,eAAe,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-teams",
-  "version": "1.0.29",
+  "version": "1.0.31",
   "description": "CLI tool for Ralph Teams",
   "bin": {
     "ralph-teams": "dist/index.js",

package/prompts/agents/epic-planner.md

@@ -80,4 +80,4 @@ A single implementation plan Markdown file written to the exact path the Team Le
 - Stay at design level. You may include signatures and contracts, but do not include full function bodies, code blocks, or pseudocode.
 - Design the test strategy per story, not just the code changes.
 - Reference existing patterns and keep the plan practical.
-- Your final response should confirm the exact plan file path you wrote.
+- Your final response must include a line exactly in the form `WROTE: <path>` using the exact plan file path you wrote.

package/prompts/team-lead-policy.md

@@ -1,6 +1,6 @@
 # Team Lead Policy
 
-You coordinate epic execution. Do not write implementation code yourself.
+You coordinate epic execution. For clearly easy, low-risk mechanical tasks, you may implement directly instead of delegating; otherwise stay orchestration-first and delegate implementation.
 
 ## Core Rules
 
@@ -9,14 +9,15 @@ You coordinate epic execution. Do not write implementation code yourself.
 - Do not treat task lifecycle notices, idle output, or generic summaries as success.
 - A Builder result only counts if it includes a concrete commit SHA for that attempt.
 - Builder work is one-shot. Spawn a fresh Builder for each attempt instead of reusing an old one.
-- Do not inspect the codebase beyond the minimum needed before delegation.
+- Keep the Team Lead orchestration-first. Do not inspect the codebase beyond the minimum needed before delegation.
+- Your own repo inspection is limited to workflow toggles, state-file contents, plan-file existence checks, repository-level command discovery, and short targeted reads needed to understand validator findings or unblock a delegation decision.
+- Do not do open-ended architecture tours, large file sweeps, or broad grep passes yourself unless delegation is impossible.
 - The runtime prompt provides the active workflow configuration. Follow those toggles first.
 
 ## Command Inference
 
 - Ralph does not centrally bootstrap project dependencies for the worktree. You must infer the right setup, build, and test commands from the repository itself.
-- Start with repository instructions: `AGENTS.md`, `README*`, contributor docs, and any project-local guidance files referenced there.
-- Prefer repository-defined task runners and scripts over language defaults: `Makefile`, `justfile`, `Taskfile.yml`, package scripts, wrapper scripts, or documented commands.
+- Start with repository instructions: `AGENTS.md`, `README*`, contributor docs, and any project-local guidance files referenced there. Then prefer repository-defined task runners and scripts over language defaults: `Makefile`, `justfile`, `Taskfile.yml`, package scripts, wrapper scripts, or documented commands.
 - Then inspect ecosystem manifests such as `package.json`, `pyproject.toml`, `requirements.txt`, `Cargo.toml`, `go.mod`, `Gemfile`, `pom.xml`, `build.gradle*`, `mix.exs`, `Dockerfile`, and `docker-compose*.yml`.
 - Prefer explicit repository commands over generic ecosystem defaults even when the language is obvious.
 - Only use generic defaults when the repository is unambiguous.
@@ -29,9 +30,9 @@ You coordinate epic execution. Do not write implementation code yourself.
 - If the epic is already marked `planned=true`, do not spawn the epic planner. Read the canonical plan file path provided in the prompt and follow it.
 - Otherwise, if `epicPlanning.enabled = 1`, spawn the epic planner for any medium- or high-complexity epic that does not already have a usable canonical plan.
 - Only skip epic planning for clearly low-complexity epics where the acceptance criteria can be implemented literally with no meaningful design decisions.
-- When delegating epic planning, explicitly tell the epic planner the exact output path for the epic plan file and require it to write the plan there before replying.
-- Treat an epic planner response as incomplete if it only pastes or summarizes the plan in chat. The epic planner must perform the file write itself and only then report completion.
-- Before using a newly generated plan, verify that the plan file exists at the required path. If it does not, send the epic planner back to write it instead of writing it yourself.
+- When delegating epic planning, explicitly tell the epic planner the exact output path for the epic plan file. Require it to write the file before replying and to include a line exactly in the form `WROTE: <path>`.
+- Treat an epic planner response as incomplete if it only pastes or summarizes the plan in chat without the required `WROTE: <path>` confirmation.
+- Before using a newly generated plan, verify that the plan file exists at the required path. If the planner returned a usable plan in chat but failed to persist the file, the Team Lead may write that exact plan to the canonical path and continue. Do not rerun the planner only for the missing file write.
 - The epic planner output should stay at implementation/design-plan level. It may include function signatures or file/type/route contracts when useful, but it should not include full functions, code snippets, or pseudocode.
 - The epic planner must design the automated tests for each story in the epic. The plan must map acceptance criteria to concrete test cases, test level, likely test files, and verification commands for each `US-xxx`.
 
@@ -45,6 +46,7 @@ You coordinate epic execution. Do not write implementation code yourself.
 ## Per Story Workflow
 
 - Before starting a story, check the epic state file. If the story has `passes: true`, skip it.
+- For clearly easy, low-risk mechanical stories, you may implement directly in the Team Lead session when delegation overhead would exceed the work. Keep the change narrowly scoped and still run the required verification yourself before counting the story complete.
 - Before delegating a story, determine the likely setup/build/test commands for this repository and pass the relevant commands or repository-based guidance to the Builder.
 - If an epic plan exists, give the Builder the story, acceptance criteria, relevant plan section, and especially the story's planned test design.
 - If a story planner was used, give the Builder the story planner output too.
@@ -56,8 +58,7 @@ You coordinate epic execution. Do not write implementation code yourself.
 ## Story Validation
 
 - If `storyValidation.enabled = 0`, validate the story yourself and update state directly.
-- If `storyValidation.enabled = 1`, use a strict verification heuristic.
-- Default to spawning the story validator for any medium- or high-complexity story.
+- If `storyValidation.enabled = 1`, use a strict verification heuristic and default to spawning the story validator for any medium- or high-complexity story.
 - In practice, that means you must spawn the story validator for new behaviour, logic changes, bug fixes, refactors, new files/modules, new routes/pages/APIs, state changes, async flows, UI interactions, auth/permissions, data fetching, persistence, external integrations, tests requiring interpretation, or anything requiring judgment to verify.
 - Only skip the story validator for clearly low-complexity mechanical stories where every criterion can be verified directly from the changed lines or by running a deterministic command yourself.
 - If you are unsure, spawn the story validator.
@@ -68,8 +69,7 @@ You coordinate epic execution. Do not write implementation code yourself.
 ## Epic Validation
 
 - If `epicValidation.enabled = 0`, do not spawn an epic validator.
-- If `epicValidation.enabled = 1`, use a strict epic-level verification heuristic.
-- Default to spawning the epic validator for any medium- or high-complexity epic, especially when multiple stories interact, shared abstractions changed, cross-story integration is part of the acceptance criteria, or verification requires judgment beyond deterministic checks.
+- If `epicValidation.enabled = 1`, use a strict epic-level verification heuristic and default to spawning the epic validator for any medium- or high-complexity epic, especially when multiple stories interact, shared abstractions changed, cross-story integration is part of the acceptance criteria, or verification requires judgment beyond deterministic checks.
 - Only skip the epic validator for clearly low-complexity mechanical epics where the epic acceptance criteria can be verified directly from the completed story results and deterministic commands.
 - If you are unsure, spawn the epic validator.
 - Give the epic validator the epic acceptance criteria, story results, relevant plan context, and the branch or commit context needed to inspect the completed epic.
@@ -79,7 +79,7 @@ You coordinate epic execution. Do not write implementation code yourself.
 ## Story State Updates
 
 - After each story attempt, update the epic state file at the exact path provided in the prompt.
-- Read the current JSON, update the story entry:
+- Read the current JSON and update the story entry:
   - If the story passes: set `passes` to `true` and `failureReason` to `null`.
   - If the story fails: set `passes` to `false` and `failureReason` to a short concrete reason.
 - Write the file atomically: write to a `.tmp` file in the same directory, then rename over the original.
@@ -94,4 +94,16 @@ You coordinate epic execution. Do not write implementation code yourself.
   }
   ```
 - When all stories are processed, verify every attempted story has an updated state file result.
-- Print `DONE: X/Y stories passed` and exit immediately.
+
+## Merge Completion
+
+- If every story in the epic passes, this same Team Lead session must attempt the merge before exiting.
+- Use the loop-branch name, repository-root path, epic branch name, and merge-result artifact path provided by the runtime prompt.
+- You may leave the epic worktree only for this final merge attempt. Keep all other work inside the epic worktree.
+- Attempt the merge on the repository root branch with `git merge <epic-branch> --no-commit --no-ff` so you can resolve conflicts before the final commit.
+- Before the merge attempt, check the repository root for uncommitted changes. If it is dirty, create a checkpoint commit so the merge can proceed cleanly.
+- If the merge is clean, commit it and write a merge-result artifact with `status: "merged"` and mode `clean` or `projected-prd` as appropriate.
+- If there are conflicts, resolve them yourself in this same session. Do not delegate to another merger role or any other teammate. If you resolve the conflicts, commit the merge and write `status: "merged"` with mode `conflict-resolved`.
+- If you cannot resolve the merge safely, abort the merge, write a merge-result artifact with `status: "merge-failed"`, include a short concrete `details` string, and then exit.
+- The merge-result artifact must be written atomically to the exact path provided by the runtime prompt before you print the final DONE line.
+- Only print `DONE: X/Y stories passed` after the merge attempt and merge-result artifact write are finished.

package/prompts/team-lead-runtime.md

@@ -0,0 +1,93 @@
+You are the Team Lead for this epic. Read the epic below and execute it.
+
+## Project
+{{PROJECT}}
+
+## Working Directory
+ALL work for this epic MUST happen in this directory: {{WORKTREE_ABS_PATH}}
+Do NOT modify files outside this directory, except for the epic state file below and the final merge workflow paths listed later in this prompt.
+
+## Project Setup Strategy
+- Ralph does not preinstall dependencies or preselect build/test commands for this repo.
+- Before delegating implementation, infer the setup, build, and test commands from project context.
+- Check repo instructions first: 'AGENTS.md', 'README*', contributor docs, and project-local guidance files. Then check repo-defined task runners or scripts such as 'Makefile', 'justfile', 'Taskfile.yml', package scripts, wrapper scripts, or documented commands.
+- Then inspect ecosystem manifests such as 'package.json', 'pyproject.toml', 'requirements.txt', 'Cargo.toml', 'go.mod', 'Gemfile', 'pom.xml', 'build.gradle*', 'mix.exs', 'Dockerfile', and 'docker-compose*.yml'.
+- Prefer explicit repository commands over generic ecosystem defaults.
+- Only fall back to generic defaults when the repository is unambiguous.
+- If setup remains ambiguous after inspection, stop guessing and fail the story attempt with a short concrete reason describing what you found.
+
+## Epic State File
+{{WORKTREE_STATE_FILE}}
+
+## PRD File Path (read-only context)
+{{WORKTREE_PRD_PATH}}
+
+## Merge Responsibility
+- If all stories pass, this same Team Lead session owns the merge attempt before exiting.
+- Loop branch to merge into: {{LOOP_BRANCH}}
+- Source epic branch: {{EPIC_BRANCH}}
+- Repository root for the merge attempt: {{ROOT_DIR}}
+- Write the final merge result artifact to: {{WORKTREE_MERGE_RESULT_FILE}}
+- The merge result artifact must be valid JSON with fields: epicId, status, mode, details, timestamp.
+- Allowed status values: merged, merge-failed.
+- Allowed mode values: clean, projected-prd, conflict-resolved, unknown.
+- When all stories pass, do not print DONE until after you have attempted the merge and written the merge result artifact.
+- During the merge attempt you may operate in the repository root path above even though normal implementation work stays inside the epic worktree.
+
+## Epic
+{{EPIC_JSON}}
+
+## Plan File
+If this epic has planned=true in the PRD, the canonical implementation plan is:
+{{WORKTREE_PLAN_FILE}}
+
+## Planning Status
+- epic.planned = {{EPIC_PLANNED}}
+- canonical_plan.exists = {{WORKTREE_PLAN_EXISTS}}
+- If a usable canonical plan already exists, do NOT spawn the epic planner. Use it even if epic.planned is false.
+- Only spawn the epic planner when epicPlanning.enabled = 1 and there is no usable canonical plan for this epic.
+
+## Stories To Plan And Execute
+Only these stories should be planned or worked in this run. Stories omitted here are already passed and must be treated as done context only.
+{{PENDING_STORIES_JSON}}
+
+## Canonical Team Lead Policy
+{{TEAM_LEAD_POLICY}}
+
+You are the Team Lead for execution, not the primary implementer or explorer. Keep your own repo exploration minimal and delegate the actual work.
+
+## Workflow Configuration
+- storyPlanning.enabled = {{STORY_PLANNING_ENABLED}}, storyValidation.enabled = {{STORY_VALIDATION_ENABLED}}, storyValidation.maxFixCycles = {{STORY_VALIDATION_MAX_FIX_CYCLES}}
+- epicPlanning.enabled = {{EPIC_PLANNING_ENABLED}}, epicValidation.enabled = {{EPIC_VALIDATION_ENABLED}}, epicValidation.maxFixCycles = {{EPIC_VALIDATION_MAX_FIX_CYCLES}}
+- finalValidation.enabled = {{FINAL_VALIDATION_ENABLED}}, finalValidation.maxFixCycles = {{FINAL_VALIDATION_MAX_FIX_CYCLES}}
+- Final validation is orchestrated by ralph.sh after all epics complete and merge cleanly in multi-epic runs. Do not try to perform final validation inside this epic session.
+
+## Model Selection Policy
+- Respect explicit ralph.config.yml agent model overrides when they are present:
+  - If RALPH_MODEL_STORY_PLANNER_EXPLICIT=1, use RALPH_MODEL_STORY_PLANNER for story planner work.
+  - If RALPH_MODEL_EPIC_PLANNER_EXPLICIT=1, use RALPH_MODEL_EPIC_PLANNER for epic planner work.
+  - If RALPH_MODEL_BUILDER_EXPLICIT=1, use RALPH_MODEL_BUILDER for builder work.
+  - If RALPH_MODEL_STORY_VALIDATOR_EXPLICIT=1, use RALPH_MODEL_STORY_VALIDATOR for story validator work.
+  - If RALPH_MODEL_EPIC_VALIDATOR_EXPLICIT=1, use RALPH_MODEL_EPIC_VALIDATOR for epic validator work.
+  - If RALPH_MODEL_FINAL_VALIDATOR_EXPLICIT=1, use RALPH_MODEL_FINAL_VALIDATOR for final validator work.
+  - If RALPH_MODEL_MERGER_EXPLICIT=1, use RALPH_MODEL_MERGER for merger work.
+- If there is no explicit override for that role, choose the model by task difficulty.
+- Default difficulty policy by backend:
+  - Claude: easy -> haiku, medium -> sonnet, difficult -> opus
+  - Copilot / Codex: easy -> gpt-5-mini, medium -> gpt-5.3-codex, difficult -> gpt-5.4
+  - OpenCode: easy -> zai-coding-plan/glm-4.7-flash, medium -> zai-coding-plan/glm-4.7, difficult -> zai-coding-plan/glm-5
+- If your runtime is Codex, use these exact named teammate roles when spawning:
+  - story planners: story_planner_easy, story_planner_medium, story_planner_difficult; epic planners: epic_planner_easy, epic_planner_medium, epic_planner_difficult
+  - builders: builder_easy, builder_medium, builder_difficult; story validators: story_validator_easy, story_validator_medium, story_validator_difficult
+  - epic validators: epic_validator_easy, epic_validator_medium, epic_validator_difficult; final validators: final_validator_easy, final_validator_medium, final_validator_difficult
+- If your runtime is OpenCode, use these exact agent names when spawning with the Task tool:
+  - story-planner, epic-planner, builder, story-validator, epic-validator, final-validator, merger
+
+## Runtime-Specific Notes
+- Use the exact plan path shown above when the policy refers to the canonical epic plan file, and the exact epic state file path shown above for every story update. The PRD path is read-only context.
+- If your runtime is Claude, use Claude agent teams for delegated planner, builder, validator, and merger work instead of Claude subagents. Create teammates that read the canonical role prompt files under `prompts/agents/`, use direct teammate messaging when coordination helps, and keep validator reasoning independent from Builder reasoning.
+- If your runtime supports named sub-agents, use the dedicated story-planner, epic-planner, builder, story-validator, and epic-validator roles and choose their models using the policy above.
+- If a story fails validation and still has retries left, spawn a new Builder for the retry instead of reusing the previous Builder run.
+- If your runtime is Codex exec mode, `request_user_input` is unavailable. Never call it. Do not stop to ask the user questions. Make a reasonable assumption, continue, and report the assumption in your final summary only if it matters.
+
+Begin.

package/ralph.sh

@@ -8,6 +8,7 @@ set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 TEAM_LEAD_POLICY_FILE="${SCRIPT_DIR}/prompts/team-lead-policy.md"
+TEAM_LEAD_PROMPT_FILE="${SCRIPT_DIR}/prompts/team-lead-runtime.md"
 
 # --- Config ---
 PRD_FILE="${1:-prd.json}"
@@ -252,7 +253,7 @@ export RALPH_MODEL_MERGER="$MODEL_MERGER"
 case "$BACKEND" in
   claude)
     AGENT_CMD="claude"
-    AGENT_FLAGS="--agent team-lead --model $MODEL_TEAM_LEAD --dangerously-skip-permissions --print --verbose --output-format stream-json"
+    AGENT_FLAGS="--agent team-lead --model $MODEL_TEAM_LEAD --dangerously-skip-permissions --teammate-mode in-process --print --verbose --output-format stream-json"
     STREAM_FORMAT="stream-json"
     ;;
   copilot)
@@ -318,6 +319,11 @@ if [ ! -f "$TEAM_LEAD_POLICY_FILE" ]; then
   exit 1
 fi
 
+if [ ! -f "$TEAM_LEAD_PROMPT_FILE" ]; then
+  echo "Error: Team Lead prompt file not found at '$TEAM_LEAD_PROMPT_FILE'."
+  exit 1
+fi
+
 # --- Validate PRD file exists ---
 if [ ! -f "$PRD_FILE" ]; then
   echo "Error: PRD file '$PRD_FILE' not found."
@@ -545,7 +551,7 @@ else
   echo "  Mode: sequential"
 fi
 if [ -n "$WORKFLOW_PRESET" ]; then
-  echo "  Workflow: $WORKFLOW_PRESET (enabled phases: $(render_enabled_execution_phases))"
+  echo "  Workflow: $WORKFLOW_PRESET"
 else
   echo "  Execution phases enabled: $(render_enabled_execution_phases)"
 fi
@@ -676,14 +682,70 @@ ensure_loop_branch_ready() {
 
 ensure_loop_branch_ready
 
+epic_branch_name() {
+  local epic_id="$1"
+  echo "ralph/epic/${LOOP_BRANCH#ralph/}/${epic_id}"
+}
+
+find_pending_epic_loop_history_conflict() {
+  local epic_id="$1"
+  local epic_branch
+  epic_branch=$(epic_branch_name "$epic_id")
+
+  if git show-ref --verify --quiet "refs/heads/${epic_branch}" && git merge-base --is-ancestor "$epic_branch" "$LOOP_BRANCH" >/dev/null 2>&1; then
+    echo "pending epic branch '${epic_branch}' is already an ancestor of loop branch '${LOOP_BRANCH}'"
+    return 0
+  fi
+
+  local merge_subject
+  merge_subject=$(git log "$LOOP_BRANCH" --merges --format=%s --grep="^Merge branch '${epic_branch}' into " -n 1 2>/dev/null || true)
+  if [ -n "$merge_subject" ]; then
+    echo "loop branch '${LOOP_BRANCH}' already contains prior merge history for '${epic_branch}' (${merge_subject})"
+    return 0
+  fi
+
+  return 1
+}
+
+fail_on_pending_epic_git_state_mismatch() {
+  local mismatch_found=0
+
+  for epic_index in $(seq 0 $((TOTAL_EPICS - 1))); do
+    local epic_status epic_id conflict_reason
+    epic_status=$(rjq read "$PRD_FILE" ".epics[$epic_index].status" "pending")
+    [ "$epic_status" = "pending" ] || continue
+
+    epic_id=$(rjq read "$PRD_FILE" ".epics[$epic_index].id")
+    conflict_reason=$(find_pending_epic_loop_history_conflict "$epic_id" || true)
+    [ -n "$conflict_reason" ] || continue
+
+    if [ "$mismatch_found" -eq 0 ]; then
+      echo "Error: pending epics in '$PRD_FILE' conflict with the current loop branch state." >&2
+    fi
+    mismatch_found=1
+    echo "  [$epic_id] $conflict_reason" >&2
+  done
+
+  if [ "$mismatch_found" -eq 1 ]; then
+    echo "Fix the mismatch before rerunning Ralph:" >&2
+    echo "  1. Mark the already-merged epic(s) completed in '$PRD_FILE', or" >&2
+    echo "  2. Start from a fresh loop branch that does not already contain those merges." >&2
+    exit 1
+  fi
+}
+
+fail_on_pending_epic_git_state_mismatch
+
 # --- Worktree Management ---
-# Creates a git worktree at .worktrees/<epic_id> on branch ralph/<epic_id>,
+# Creates a git worktree at .worktrees/<epic_id> on a run-scoped branch under
+# the current loop branch name, rooted from the loop branch for this run.
 # rooted from the loop branch for this run.
 # If the worktree already exists and is valid (e.g. from an interrupted run),
 # it is reused as-is. Otherwise, any stale entries are cleaned up first.
 create_epic_worktree() {
   local epic_id="$1"
-  local branch_name="ralph/${epic_id}"
+  local branch_name
+  branch_name=$(epic_branch_name "$epic_id")
   local worktree_path="${RALPH_RUNTIME_DIRNAME}/.worktrees/${epic_id}"
   local add_output
   local retry_output
@@ -1245,11 +1307,55 @@ LOOP_STARTED_AT=$(date +%s)
 # Cleanup worktrees on exit only when NOT interrupted (on interrupt, worktrees are preserved for resume)
 trap 'if [ "$INTERRUPTED" = false ]; then cleanup_all_worktrees; fi; [ -n "${CODEX_AGENT_RUNTIME_DIR:-}" ] && rm -rf "${CODEX_AGENT_RUNTIME_DIR}"; kill $(jobs -p) 2>/dev/null || true' EXIT
 
+render_team_lead_prompt() {
+  TEAM_LEAD_TEMPLATE_PATH="$TEAM_LEAD_PROMPT_FILE" \
+  TEAM_LEAD_TEMPLATE_PROJECT="$PROJECT" \
+  TEAM_LEAD_TEMPLATE_WORKTREE_ABS_PATH="$WORKTREE_ABS_PATH" \
+  TEAM_LEAD_TEMPLATE_WORKTREE_STATE_FILE="$WORKTREE_STATE_FILE" \
+  TEAM_LEAD_TEMPLATE_WORKTREE_PRD_PATH="$WORKTREE_PRD_PATH" \
+  TEAM_LEAD_TEMPLATE_LOOP_BRANCH="$LOOP_BRANCH" \
+  TEAM_LEAD_TEMPLATE_EPIC_BRANCH="$EPIC_BRANCH" \
+  TEAM_LEAD_TEMPLATE_ROOT_DIR="$ROOT_DIR" \
+  TEAM_LEAD_TEMPLATE_WORKTREE_MERGE_RESULT_FILE="$WORKTREE_MERGE_RESULT_FILE" \
+  TEAM_LEAD_TEMPLATE_EPIC_JSON="$EPIC_JSON" \
+  TEAM_LEAD_TEMPLATE_WORKTREE_PLAN_FILE="$WORKTREE_PLAN_FILE" \
+  TEAM_LEAD_TEMPLATE_EPIC_PLANNED="$EPIC_PLANNED" \
+  TEAM_LEAD_TEMPLATE_WORKTREE_PLAN_EXISTS="$WORKTREE_PLAN_EXISTS" \
+  TEAM_LEAD_TEMPLATE_PENDING_STORIES_JSON="$PENDING_STORIES_JSON" \
+  TEAM_LEAD_TEMPLATE_TEAM_LEAD_POLICY="$TEAM_LEAD_POLICY" \
+  TEAM_LEAD_TEMPLATE_STORY_PLANNING_ENABLED="$STORY_PLANNING_ENABLED" \
+  TEAM_LEAD_TEMPLATE_STORY_VALIDATION_ENABLED="$STORY_VALIDATION_ENABLED" \
+  TEAM_LEAD_TEMPLATE_STORY_VALIDATION_MAX_FIX_CYCLES="$STORY_VALIDATION_MAX_FIX_CYCLES" \
+  TEAM_LEAD_TEMPLATE_EPIC_PLANNING_ENABLED="$EPIC_PLANNING_ENABLED" \
+  TEAM_LEAD_TEMPLATE_EPIC_VALIDATION_ENABLED="$EPIC_VALIDATION_ENABLED" \
+  TEAM_LEAD_TEMPLATE_EPIC_VALIDATION_MAX_FIX_CYCLES="$EPIC_VALIDATION_MAX_FIX_CYCLES" \
+  TEAM_LEAD_TEMPLATE_FINAL_VALIDATION_ENABLED="$FINAL_VALIDATION_ENABLED" \
+  TEAM_LEAD_TEMPLATE_FINAL_VALIDATION_MAX_FIX_CYCLES="$FINAL_VALIDATION_MAX_FIX_CYCLES" \
+  node <<'NODE'
+const fs = require('fs');
+
+const templatePath = process.env.TEAM_LEAD_TEMPLATE_PATH;
+const template = fs.readFileSync(templatePath, 'utf8');
+const rendered = template.replace(/\{\{([A-Z0-9_]+)\}\}/g, (_match, key) => {
+  const value = process.env[`TEAM_LEAD_TEMPLATE_${key}`];
+  return value === undefined ? '' : value;
+});
+
+process.stdout.write(rendered);
+NODE
+}
+
 # process_epic_result: derive epic result from prd.json story passes and update PRD status
 process_epic_result() {
   local epic_index="$1"
   local epic_id
   epic_id=$(rjq read "$PRD_FILE" ".epics[$epic_index].id")
+  local merge_status=""
+  merge_status=$(read_epic_merge_result_field "$epic_id" .status "" 2>/dev/null || true)
+  local merge_mode=""
+  merge_mode=$(read_epic_merge_result_field "$epic_id" .mode "unknown" 2>/dev/null || true)
+  local merge_details=""
+  merge_details=$(read_epic_merge_result_field "$epic_id" .details "" 2>/dev/null || true)
 
   local total_stories
   total_stories=$(rjq length "$PRD_FILE" ".epics[$epic_index].userStories")
@@ -1257,11 +1363,34 @@ process_epic_result() {
   passed_stories=$(rjq count-where "$PRD_FILE" ".epics[$epic_index].userStories" "passes=true")
 
   if [ "$passed_stories" -eq "$total_stories" ] && [ "$total_stories" -gt 0 ]; then
+    if [ "$merge_status" = "merge-failed" ]; then
+      echo ""
+      echo "  [$epic_id] MERGE FAILED — all stories passed but merge did not complete"
+      [ -n "$merge_details" ] && echo "  [$epic_id] Merge details: $merge_details"
+      rjq set "$PRD_FILE" ".epics[$epic_index].status" '"merge-failed"'
+      FAILED=$((FAILED + 1))
+      echo "[$epic_id] MERGE FAILED (${merge_details:-team lead merge failed}) — $(date)" >> "$PROGRESS_FILE"
+      return
+    fi
+
+    if [ "$merge_status" != "merged" ]; then
+      echo ""
+      echo "  [$epic_id] MERGE FAILED — all stories passed but Team Lead did not record a merge result"
+      rjq set "$PRD_FILE" ".epics[$epic_index].status" '"merge-failed"'
+      FAILED=$((FAILED + 1))
+      echo "[$epic_id] MERGE FAILED (missing team lead merge result artifact) — $(date)" >> "$PROGRESS_FILE"
+      return
+    fi
+
     echo ""
     echo "  [$epic_id] PASSED — all stories completed ($passed_stories/$total_stories)"
     rjq set "$PRD_FILE" ".epics[$epic_index].status" '"completed"'
     COMPLETED=$((COMPLETED + 1))
     echo "[$epic_id] PASSED — $(date)" >> "$PROGRESS_FILE"
+    if [ "$merge_status" = "merged" ]; then
+      echo "  [$epic_id] Merge successful (team lead, ${merge_mode:-unknown})"
+      echo "[$epic_id] MERGED (team lead ${merge_mode:-unknown}) — $(date)" >> "$PROGRESS_FILE"
+    fi
   elif [ "$passed_stories" -gt 0 ]; then
     echo ""
     echo "  [$epic_id] PARTIAL — $passed_stories/$total_stories stories passed"
@@ -1305,6 +1434,38 @@ NODE
   mv "$tmp_file" "$state_file"
 }
 
+reset_epic_merge_result_file() {
+  local epic_id="$1"
+  rm -f "${STATE_DIR}/merge-${epic_id}.json"
+}
+
+read_epic_merge_result_field() {
+  local epic_id="$1"
+  local field_path="$2"
+  local default_value="$3"
+  local result_file="${STATE_DIR}/merge-${epic_id}.json"
+
+  [ -f "$result_file" ] || return 1
+  rjq read "$result_file" "$field_path" "$default_value"
+}
+
+delete_epic_branch() {
+  local epic_id="$1"
+  local branch_name
+  branch_name=$(epic_branch_name "$epic_id")
+  git branch -d "$branch_name" 2>/dev/null || true
+}
+
+verify_epic_branch_merged() {
+  local epic_id="$1"
+  local branch_name
+  branch_name=$(epic_branch_name "$epic_id")
+
+  git show-ref --verify --quiet "refs/heads/${branch_name}" || return 1
+  git show-ref --verify --quiet "refs/heads/${LOOP_BRANCH}" || return 1
+  git merge-base --is-ancestor "$branch_name" "$LOOP_BRANCH" 2>/dev/null
+}
+
 read_epic_state_passed() {
   local epic_id="$1"
   local state_file="${STATE_DIR}/${epic_id}.json"
@@ -1390,122 +1551,35 @@ spawn_epic_bg() {
   WORKTREE_PATH=$(create_epic_worktree "$EPIC_ID")
   local WORKTREE_ABS_PATH
   WORKTREE_ABS_PATH="$(cd "${ROOT_DIR}/${WORKTREE_PATH}" && pwd)"
+  local EPIC_BRANCH
+  EPIC_BRANCH=$(epic_branch_name "$EPIC_ID")
   ensure_worktree_runtime_link "$WORKTREE_ABS_PATH"
   local WORKTREE_PRD_PATH="${WORKTREE_ABS_PATH}/${PRD_REL_PATH}"
   local WORKTREE_STATE_FILE="${WORKTREE_ABS_PATH}/${RALPH_RUNTIME_DIRNAME}/state/${EPIC_ID}.json"
   local WORKTREE_PLAN_FILE="${WORKTREE_ABS_PATH}/${RALPH_RUNTIME_DIRNAME}/plans/plan-${EPIC_ID}.md"
+  local WORKTREE_MERGE_RESULT_FILE="${WORKTREE_ABS_PATH}/${RALPH_RUNTIME_DIRNAME}/state/merge-${EPIC_ID}.json"
   local WORKTREE_PLAN_EXISTS="false"
   if [ -f "$WORKTREE_PLAN_FILE" ]; then
     WORKTREE_PLAN_EXISTS="true"
   fi
 
   init_epic_state_file "$EPIC_ID" "$EPIC_INDEX"
+  reset_epic_merge_result_file "$EPIC_ID"
 
   echo "  Spawning [$EPIC_ID] in worktree $WORKTREE_PATH"
 
   local TEAM_LEAD_POLICY
   TEAM_LEAD_POLICY="$(cat "$TEAM_LEAD_POLICY_FILE")"
-
-  local TEAM_PROMPT="You are the Team Lead for this epic. Read the epic below and execute it.
-
-## Project
-$PROJECT
-
-## Working Directory
-ALL work for this epic MUST happen in this directory: $WORKTREE_ABS_PATH
-Do NOT modify files outside this directory, except for the epic state file below.
-
-## Project Setup Strategy
-- Ralph does not preinstall dependencies or preselect build/test commands for this repo.
-- Before delegating implementation, inspect the repository and infer the correct setup, build, and test commands from project context.
-- Check repo instructions first: 'AGENTS.md', 'README*', contributor docs, and project-local guidance files.
-- Prefer repo-defined task runners or scripts such as 'Makefile', 'justfile', 'Taskfile.yml', package scripts, wrapper scripts, or documented commands.
-- Then inspect ecosystem manifests such as 'package.json', 'pyproject.toml', 'requirements.txt', 'Cargo.toml', 'go.mod', 'Gemfile', 'pom.xml', 'build.gradle*', 'mix.exs', 'Dockerfile', and 'docker-compose*.yml'.
-- Prefer explicit repository commands over generic ecosystem defaults.
-- Only fall back to generic defaults when the repository is unambiguous.
-- If setup remains ambiguous after inspection, stop guessing and fail the story attempt with a short concrete reason describing what you found.
-
-## Epic State File
-$WORKTREE_STATE_FILE
-
-## PRD File Path (read-only context)
-$WORKTREE_PRD_PATH
-
-## Epic
-$EPIC_JSON
-
-## Plan File
-If this epic has planned=true in the PRD, the canonical implementation plan is:
-$WORKTREE_PLAN_FILE
-
-## Planning Status
-- epic.planned = ${EPIC_PLANNED}
-- canonical_plan.exists = ${WORKTREE_PLAN_EXISTS}
-- If a usable canonical plan already exists, do NOT spawn the epic planner. Use it even if epic.planned is false.
-- Only spawn the epic planner when epicPlanning.enabled = 1 and there is no usable canonical plan for this epic.
-
-## Stories To Plan And Execute
-Only these stories should be planned or worked in this run. Stories omitted here are already passed and must be treated as done context only.
-$PENDING_STORIES_JSON
-
-## Canonical Team Lead Policy
-$TEAM_LEAD_POLICY
-
-## Workflow Configuration
-- storyPlanning.enabled = ${STORY_PLANNING_ENABLED}
-- storyValidation.enabled = ${STORY_VALIDATION_ENABLED}
-- storyValidation.maxFixCycles = ${STORY_VALIDATION_MAX_FIX_CYCLES}
-- epicPlanning.enabled = ${EPIC_PLANNING_ENABLED}
-- epicValidation.enabled = ${EPIC_VALIDATION_ENABLED}
-- epicValidation.maxFixCycles = ${EPIC_VALIDATION_MAX_FIX_CYCLES}
-- finalValidation.enabled = ${FINAL_VALIDATION_ENABLED}
-- finalValidation.maxFixCycles = ${FINAL_VALIDATION_MAX_FIX_CYCLES}
-- Final validation is orchestrated by ralph.sh after all epics complete and merge cleanly in multi-epic runs. Do not try to perform final validation inside this epic session.
-
-## Model Selection Policy
-- Respect explicit ralph.config.yml agent model overrides when they are present.
-  - If RALPH_MODEL_STORY_PLANNER_EXPLICIT=1, use RALPH_MODEL_STORY_PLANNER for story planner work.
-  - If RALPH_MODEL_EPIC_PLANNER_EXPLICIT=1, use RALPH_MODEL_EPIC_PLANNER for epic planner work.
-  - If RALPH_MODEL_BUILDER_EXPLICIT=1, use RALPH_MODEL_BUILDER for builder work.
-  - If RALPH_MODEL_STORY_VALIDATOR_EXPLICIT=1, use RALPH_MODEL_STORY_VALIDATOR for story validator work.
-  - If RALPH_MODEL_EPIC_VALIDATOR_EXPLICIT=1, use RALPH_MODEL_EPIC_VALIDATOR for epic validator work.
-  - If RALPH_MODEL_FINAL_VALIDATOR_EXPLICIT=1, use RALPH_MODEL_FINAL_VALIDATOR for final validator work.
-  - If RALPH_MODEL_MERGER_EXPLICIT=1, use RALPH_MODEL_MERGER for merger work.
-- If there is no explicit override for that role, choose the model by task difficulty.
-- Default difficulty policy by backend:
-  - Claude: easy -> haiku, medium -> sonnet, difficult -> opus
-  - Copilot / Codex: easy -> gpt-5-mini, medium -> gpt-5.3-codex, difficult -> gpt-5.4
-  - OpenCode: easy -> zai-coding-plan/glm-4.7-flash, medium -> zai-coding-plan/glm-4.7, difficult -> zai-coding-plan/glm-5
-- If your runtime is Codex, use these exact named teammate roles when spawning:
-  - story planners: story_planner_easy, story_planner_medium, story_planner_difficult
-  - epic planners: epic_planner_easy, epic_planner_medium, epic_planner_difficult
-  - builders: builder_easy, builder_medium, builder_difficult
-  - story validators: story_validator_easy, story_validator_medium, story_validator_difficult
-  - epic validators: epic_validator_easy, epic_validator_medium, epic_validator_difficult
-  - final validators: final_validator_easy, final_validator_medium, final_validator_difficult
-- If your runtime is OpenCode, use these exact agent names when spawning with the Task tool:
-  - story-planner
-  - epic-planner
-  - builder
-  - story-validator
-  - epic-validator
-  - final-validator
-  - merger
-
-## Runtime-Specific Notes
-- Use the exact plan path shown above when the policy refers to the canonical epic plan file.
-- Use the exact epic state file path shown above for every story update. The PRD path is read-only context.
-- If your runtime supports named sub-agents, use the dedicated story-planner, epic-planner, builder, story-validator, and epic-validator roles and choose their models using the policy above.
-- If a story fails validation and still has retries left, spawn a new Builder for the retry instead of reusing the previous Builder run.
-- If your runtime is Codex exec mode, \`request_user_input\` is unavailable. Never call it. Do not stop to ask the user questions. Make a reasonable assumption, continue, and report the assumption in your final summary only if it matters.
-
-Begin."
+  local TEAM_PROMPT
+  TEAM_PROMPT="$(render_team_lead_prompt)"
 
   # Run agent in background; write all output to log file (no console streaming in parallel mode)
   if [ "$STREAM_FORMAT" = "stream-json" ]; then
     (
       if [ "$BACKEND" = "opencode" ]; then
         run_opencode_exec "$WORKTREE_ABS_PATH" "$TEAM_PROMPT" team-lead "$MODEL_TEAM_LEAD" > "$EPIC_LOG" 2>&1
+      elif [ "$BACKEND" = "claude" ]; then
+        echo "$TEAM_PROMPT" | env CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS="${CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS:-1}" $AGENT_CMD $AGENT_FLAGS > "$EPIC_LOG" 2>&1
       else
         echo "$TEAM_PROMPT" | $AGENT_CMD $AGENT_FLAGS > "$EPIC_LOG" 2>&1
       fi
@@ -1525,9 +1599,10 @@ Begin."
   LAST_SPAWN_LOG="$EPIC_LOG"
 }
 
-# merge_wave: merges completed epic branches back to the loop branch sequentially.
-# Takes epic IDs as arguments. Clean merges succeed without AI intervention.
-# On conflict, spawns the merger agent. Logs all outcomes to progress.txt.
+# merge_wave: fallback merge pass for completed epic branches that were not already
+# merged by their original Team Lead sessions. Takes epic IDs as arguments.
+# Clean merges succeed without AI intervention. On conflict, hands the repo to a
+# tightly-scoped Team Lead takeover. Logs all outcomes to progress.txt.
 merge_wave() {
   local -a completed_epic_ids=("$@")
 
@@ -1546,7 +1621,8 @@ merge_wave() {
   fi
 
   for epic_id in "${completed_epic_ids[@]}"; do
-    local branch_name="ralph/${epic_id}"
+    local branch_name
+    branch_name=$(epic_branch_name "$epic_id")
 
     # Check if branch exists
     if ! git show-ref --verify --quiet "refs/heads/${branch_name}"; then
@@ -1617,11 +1693,11 @@ merge_wave() {
         continue
       fi
 
-      # Conflicts detected — attempt AI resolution via merger agent
-      echo "  [$epic_id] conflicts detected — spawning merger agent..."
-      echo "[$epic_id] merge conflicts — attempting AI resolution — $(date)" >> "$PROGRESS_FILE"
+      # Conflicts detected — hand off the current merge state to the Team Lead.
+      echo "  [$epic_id] conflicts detected — team lead takeover..."
+      echo "[$epic_id] merge conflicts — team lead takeover — $(date)" >> "$PROGRESS_FILE"
 
-      local merge_prompt="You are the Merger Agent. Resolve the git merge conflicts.
+      local merge_prompt="You are the Team Lead. Take over this merge conflict resolution directly.
 
 ## Context
 - Target branch: ${target_branch}
@@ -1632,14 +1708,20 @@ merge_wave() {
 ${conflicted_files}
 
 ## Instructions
-1. For each conflicted file listed above, read the full file to see the conflict markers
-2. Run: git log --oneline ${target_branch}..${branch_name} (what the epic branch changed)
-3. Run: git log --oneline ${branch_name}..${target_branch} (what target changed since branch point)
-4. Resolve each conflict by combining both sides' intent
-5. Stage each resolved file with: git add <filename>
-6. Do NOT commit — ralph.sh will create the merge commit
-7. Do NOT run git merge --abort
-8. If you cannot safely resolve a conflict, leave the conflict markers in place
+1. Stay in the current repository and operate on the existing in-progress merge state.
+2. Do NOT delegate. Do NOT spawn merger, builder, planner, or validator work.
+3. For each conflicted file listed above, read the full file and inspect the conflict markers.
+4. Run: git log --oneline ${target_branch}..${branch_name} to see what the epic branch changed.
+5. Run: git log --oneline ${branch_name}..${target_branch} to see what changed on the target branch.
+6. Resolve each conflict by combining both sides' intent where possible.
+7. Stage each resolved file with: git add <filename>.
+8. Do NOT commit. ralph.sh will create the merge commit after all conflicts are resolved.
+9. Do NOT run git merge --abort.
+10. If you cannot safely resolve a conflict, leave the conflict markers in place.
+
+When you are finished, print exactly one final line:
+- MERGE_SUCCESS
+- MERGE_FAILED
 
 Begin resolving."
 
@@ -1647,18 +1729,18 @@ Begin resolving."
 
       case "$BACKEND" in
         claude)
-          echo "$merge_prompt" | $AGENT_CMD --agent merger --model "$MODEL_MERGER" --dangerously-skip-permissions --print --verbose --output-format stream-json > "$merge_log" 2>&1 || true
+          echo "$merge_prompt" | $AGENT_CMD --agent team-lead --model "$MODEL_TEAM_LEAD" --dangerously-skip-permissions --print --verbose --output-format stream-json > "$merge_log" 2>&1 || true
           ;;
         copilot)
           COPILOT_MERGE_PROMPT="$merge_prompt" \
-            script -q /dev/null /bin/sh -lc 'exec gh copilot -- --agent merger --allow-all --no-ask-user --stream on -p "$COPILOT_MERGE_PROMPT"' \
+            script -q /dev/null /bin/sh -lc 'exec gh copilot -- --agent team-lead --allow-all --no-ask-user --stream on -p "$COPILOT_MERGE_PROMPT"' \
             > "$merge_log" 2>&1 || true
           ;;
         codex)
-          MODEL_TEAM_LEAD="$MODEL_MERGER" run_codex_exec "$ROOT_DIR" "$merge_prompt" > "$merge_log" 2>&1 || true
+          run_codex_exec "$ROOT_DIR" "$merge_prompt" > "$merge_log" 2>&1 || true
           ;;
         opencode)
-          run_opencode_exec "$ROOT_DIR" "$merge_prompt" merger "$MODEL_MERGER" > "$merge_log" 2>&1 || true
+          run_opencode_exec "$ROOT_DIR" "$merge_prompt" team-lead "$MODEL_TEAM_LEAD" > "$merge_log" 2>&1 || true
           ;;
       esac
 
@@ -1710,7 +1792,8 @@ collect_pending_merge_epics() {
     epic_id=$(rjq read "$PRD_FILE" ".epics[$epic_index].id")
     [ -n "$epic_id" ] || continue
 
-    local branch_name="ralph/${epic_id}"
+    local branch_name
+    branch_name=$(epic_branch_name "$epic_id")
     if git show-ref --verify --quiet "refs/heads/${branch_name}"; then
       pending_merge_ids+=("$epic_id")
     fi
@@ -1735,7 +1818,9 @@ recover_pending_merges() {
   echo "  --- Recovering completed epic branches before ${context} ---"
   local epic_id
   for epic_id in "${pending_merge_ids[@]}"; do
-    echo "  [$epic_id] Recovered pending merge from existing epic branch"
+    local branch_name
+    branch_name=$(epic_branch_name "$epic_id")
+    echo "  [$epic_id] Recovered pending merge from existing epic branch (${branch_name})"
     echo "[$epic_id] RECOVERED PENDING MERGE (${context}) — $(date)" >> "$PROGRESS_FILE"
   done
 
@@ -2147,18 +2232,30 @@ while true; do
         [ "$passed_s_prd" -gt "$passed_s" ] && passed_s="$passed_s_prd"
         local all_done=false
         [ "$passed_s" -eq "$total_s" ] && [ "$total_s" -gt 0 ] && all_done=true
+        local live_merge_status=""
+        live_merge_status=$(read_epic_merge_result_field "$finished_epic_id" .status "" 2>/dev/null || true)
+        local merge_recorded=false
+        if [ "$live_merge_status" = "merged" ] || [ "$live_merge_status" = "merge-failed" ]; then
+          merge_recorded=true
+        fi
+        local epic_flow_complete=false
+        if [ "$all_done" = true ] && [ "$merge_recorded" = true ]; then
+          epic_flow_complete=true
+        fi
 
-        if [ "$process_finished" = true ] || [ "$all_done" = true ]; then
-          # Treat fully-passed stories in the PRD as the authoritative completion
-          # signal, even if the backend session is still idling.
-          if [ "$process_finished" = false ]; then
+        if [ "$process_finished" = true ] || [ "$epic_flow_complete" = true ]; then
+          # Only terminate an in-flight session early after the Team Lead has
+          # written the merge result artifact. Fully-passed stories alone are
+          # not enough to declare the epic session complete.
+          if [ "$process_finished" = false ] && [ "$epic_flow_complete" = true ]; then
             terminate_process_tree "${active_pids[$slot]}"
           fi
           wait "${active_pids[$slot]}" 2>/dev/null || true
 
-          # If the process exited before the epic reached all stories passed,
-          # consider it a crash and retry when possible.
-          if [ "$all_done" = false ]; then
+          # If the process exited before the epic reached full completion
+          # (stories passed plus merge result recorded), consider it a crash
+          # and retry when possible.
+          if [ "$epic_flow_complete" = false ]; then
             local retry_count
             retry_count="$(get_crash_retry_count "$finished_epic_id")"
             if [ "$retry_count" -lt "$MAX_CRASH_RETRIES" ]; then
@@ -2183,14 +2280,25 @@ while true; do
 
           echo "  [$finished_epic_id] finished — processing result"
           project_state_to_prd "$finished_epic_id" || true
+          local merge_status
+          merge_status=$(read_epic_merge_result_field "$finished_epic_id" .status "" 2>/dev/null || true)
+          if [ "$merge_status" = "merged" ] && ! verify_epic_branch_merged "$finished_epic_id"; then
+            echo "  [$finished_epic_id] Team Lead reported merge success but scripted check failed"
+            echo "[$finished_epic_id] MERGE CHECK FAILED (team lead reported merged) — $(date)" >> "$PROGRESS_FILE"
+            reset_epic_merge_result_file "$finished_epic_id"
+            merge_status=""
+          fi
           process_epic_result "${active_indices[$slot]}"
-          # Track completed epics for merge_wave
+          # Track completed epics for merge_wave only when the Team Lead did not already merge.
           local post_status
           post_status=$(rjq read "$PRD_FILE" ".epics[${active_indices[$slot]}].status" "pending")
-          if [ "$post_status" = "completed" ]; then
+          if [ "$post_status" = "completed" ] && [ "$merge_status" != "merged" ]; then
             wave_completed_ids+=("$finished_epic_id")
           fi
           cleanup_epic_worktree "$finished_epic_id"
+          if [ "$merge_status" = "merged" ]; then
+            delete_epic_branch "$finished_epic_id"
+          fi
           unset 'active_pids[$slot]'
           unset 'active_indices[$slot]'
           unset 'active_start_times[$slot]'
@@ -2260,9 +2368,7 @@ while true; do
   fi
 done
 
-if ! recover_pending_merges "finalization"; then
-  initialize_counters
-fi
+recover_pending_merges "finalization" || true
 initialize_counters
 
 if ! run_final_validation_cycle; then