docs(11-03): complete mode-aware agent spawning plan

Tasks completed: 3/3
- Update AgentRepository for mode field
- Update ClaudeAgentManager for mode-specific schemas
- Add mode to AgentStoppedEvent reasons (already done in 11-01)

SUMMARY: .planning/phases/11-architect-agent/11-03-SUMMARY.md

.planning/STATE.md

@@ -12,7 +12,7 @@ See: .planning/PROJECT.md (updated 2026-01-31)
 Phase: 11 of 13 (Architect Agent)
 Plan: 4 of 8 in current phase
 Status: In progress
-Last activity: 2026-01-31 — Completed 11-04-PLAN.md
+Last activity: 2026-01-31 — Completed 11-03-PLAN.md
 
 Progress: █████░░░░░ 45%
 
@@ -131,6 +131,9 @@ Recent decisions affecting current work:
 - 11-01: Discuss mode outputs decisions array with topic/decision/reason structure
 - 11-01: Breakdown mode outputs phases array with number/name/description/dependencies
 - 11-01: AgentStoppedEvent reason extended with context_complete and breakdown_complete
+- 11-03: Mode extracted from spawn options with 'execute' default for backwards compatibility
+- 11-03: Separate handler methods per mode (handleExecuteOutput, handleDiscussOutput, handleBreakdownOutput)
+- 11-03: Resume uses mode-specific JSON schema for resumed sessions
 - 11-04: Repositories optional in tRPC context following existing pattern (agentManager, taskRepository)
 - 11-04: createPhasesFromBreakdown accepts pre-numbered phases for Architect breakdown output
 
@@ -153,5 +156,5 @@ None.
 ## Session Continuity
 
 Last session: 2026-01-31
-Stopped at: Completed 11-04-PLAN.md (Initiative & Phase tRPC Procedures)
+Stopped at: Completed 11-03-PLAN.md (Mode-Aware Agent Spawning)
 Resume file: None

.planning/phases/11-architect-agent/11-03-SUMMARY.md

@@ -0,0 +1,108 @@
+---
+phase: 11-architect-agent
+plan: 03
+subsystem: agent
+tags: [agent-mode, json-schema, zod, discriminated-union, typescript]
+
+# Dependency graph
+requires:
+  - phase: 11-architect-agent
+    plan: 01
+    provides: AgentMode type, mode-specific output schemas, JSON schemas for Claude CLI
+provides:
+  - Mode-aware agent spawning via ClaudeAgentManager
+  - Mode-specific JSON schema selection for Claude CLI
+  - Mode field in CreateAgentData for repository operations
+  - Mode-specific completion handlers (execute, discuss, breakdown)
+affects: [11-05, 11-06, 11-08]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns:
+    - "Mode-specific handler dispatch pattern in agent completion"
+    - "JSON schema selection by mode for Claude CLI integration"
+
+key-files:
+  created: []
+  modified:
+    - src/db/repositories/agent-repository.ts
+    - src/db/repositories/drizzle/agent.ts
+    - src/agent/manager.ts
+
+key-decisions:
+  - "Mode extracted from spawn options with 'execute' default for backwards compatibility"
+  - "Separate handler methods for each mode (handleExecuteOutput, handleDiscussOutput, handleBreakdownOutput)"
+  - "Resume uses mode-specific JSON schema (not hardcoded execute schema)"
+
+patterns-established:
+  - "Mode-aware handler dispatch: single entry point routes to mode-specific handlers"
+
+# Metrics
+duration: 2min
+completed: 2026-01-31
+---
+
+# Phase 11 Plan 03: Mode-Aware Agent Spawning Summary
+
+**ClaudeAgentManager updated to spawn agents with mode-specific JSON schemas and route completion handling by mode**
+
+## Performance
+
+- **Duration:** 2 min
+- **Started:** 2026-01-31T18:10:41Z
+- **Completed:** 2026-01-31T18:12:57Z
+- **Tasks:** 3 (Task 3 already complete from 11-01)
+- **Files modified:** 3
+
+## Accomplishments
+
+- Added mode field to CreateAgentData interface with 'execute' default
+- Updated DrizzleAgentRepository.create() to handle mode field
+- Added getJsonSchemaForMode() helper for mode-specific schema selection
+- Refactored handleAgentCompletion() into mode-specific handler methods
+- Updated spawn() to pass mode to repository and use correct JSON schema
+- Updated resume() to use mode-specific JSON schema
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Update AgentRepository for mode field** - `75f8887` (feat)
+2. **Task 2: Update ClaudeAgentManager for mode-specific schemas** - `937d24e` (feat)
+3. **Task 3: Add mode to AgentStoppedEvent reasons** - Already complete from 11-01
+
+## Files Created/Modified
+
+- `src/db/repositories/agent-repository.ts` - Added AgentMode import and mode field to CreateAgentData
+- `src/db/repositories/drizzle/agent.ts` - Updated create() to include mode with 'execute' default
+- `src/agent/manager.ts` - Added mode-specific schema imports, getJsonSchemaForMode(), and mode-specific handlers
+
+## Decisions Made
+
+1. **11-03: Mode extracted from options** - Default to 'execute' in spawn() for backwards compatibility
+2. **11-03: Separate handler methods per mode** - Clean separation of concerns for execute/discuss/breakdown output parsing
+3. **11-03: Resume uses mode-specific schema** - Agent's stored mode determines JSON schema for resumed sessions
+
+## Deviations from Plan
+
+None - plan executed exactly as written. Task 3 was already complete from Plan 11-01.
+
+## Issues Encountered
+
+None
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+
+- Mode-aware agent spawning complete and ready for 11-04 (Architect Agent Prompts)
+- All existing tests pass (384 tests)
+- Build successful with no type errors
+- Backwards compatible - default mode='execute' preserves existing behavior
+
+---
+*Phase: 11-architect-agent*
+*Completed: 2026-01-31*