docs(11-05): complete agent prompts plan

Tasks completed: 3/3
- Update spawnAgent to support mode
- Create comprehensive agent prompts module
- Add spawnArchitect tRPC procedures

SUMMARY: .planning/phases/11-architect-agent/11-05-SUMMARY.md
This commit is contained in:
Lukas May
2026-01-31 19:18:28 +01:00
parent c13985909a
commit 8d90a55f45
3 changed files with 115 additions and 6 deletions

View File

@@ -168,7 +168,7 @@ Plans:
- [x] 11-02: Initiative & Phase Repositories
- [x] 11-03: ClaudeAgentManager Mode Support
- [x] 11-04: Initiative & Phase tRPC Procedures
- [ ] 11-05: Architect Spawn Procedures
- [x] 11-05: Architect Spawn Procedures
- [ ] 11-06: CLI Commands
- [ ] 11-07: Unit Tests
- [ ] 11-08: E2E Tests
@@ -211,7 +211,7 @@ Phases execute in numeric order: 1 → 1.1 → 2 → 3 → 4 → 5 → 6 → 7
| 8.1. Agent Output Schema | v1.1 | 2/2 | Complete | 2026-01-31 |
| 9. Extended Scenarios | v1.1 | 2/2 | Complete | 2026-01-31 |
| 10. Multi-Question Schema | v1.2 | 4/4 | Complete | 2026-01-31 |
| 11. Architect Agent | v1.2 | 4/8 | In progress | - |
| 11. Architect Agent | v1.2 | 5/8 | In progress | - |
| 12. Phase-Task Decomposition | v1.2 | 0/? | Not started | - |
| 13. Real Claude E2E Tests | v1.2 | 0/? | Not started | - |

View File

@@ -10,11 +10,11 @@ See: .planning/PROJECT.md (updated 2026-01-31)
## Current Position
Phase: 11 of 13 (Architect Agent)
Plan: 4 of 8 in current phase
Plan: 5 of 8 in current phase
Status: In progress
Last activity: 2026-01-31 — Completed 11-03-PLAN.md
Last activity: 2026-01-31 — Completed 11-05-PLAN.md
Progress: █████░░░░░ 45%
Progress: █████░░░░░ 48%
## Performance Metrics
@@ -136,6 +136,9 @@ Recent decisions affecting current work:
- 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
- 11-05: Prompts exported from dedicated module for reusability
- 11-05: buildExecutePrompt takes taskDescription, not Initiative (worker agents work on tasks)
- 11-05: Architect procedures validate initiative exists before spawning
### Pending Todos
@@ -156,5 +159,5 @@ None.
## Session Continuity
Last session: 2026-01-31
Stopped at: Completed 11-03-PLAN.md (Mode-Aware Agent Spawning)
Stopped at: Completed 11-05-PLAN.md (Agent Prompts Module)
Resume file: None

View File

@@ -0,0 +1,106 @@
---
phase: 11-architect-agent
plan: 05
subsystem: agent
tags: [agent-prompts, trpc, architect, discuss-mode, breakdown-mode, execute-mode]
# Dependency graph
requires:
- phase: 11-03
provides: Mode-aware agent spawning, mode-specific completion handlers
- phase: 11-04
provides: Initiative and Phase tRPC procedures, repository context injection
provides:
- Comprehensive mode-specific agent prompts module
- spawnAgent procedure accepts mode parameter
- spawnArchitectDiscuss procedure for context gathering
- spawnArchitectBreakdown procedure for phase decomposition
affects: [11-06, 11-07, 11-08, cli-commands]
# Tech tracking
tech-stack:
added: []
patterns:
- "Prompt builder functions with Initiative context injection"
- "Architect spawn procedures with initiative validation"
key-files:
created:
- src/agent/prompts.ts
modified:
- src/agent/index.ts
- src/trpc/router.ts
key-decisions:
- "Prompts exported from dedicated module for reusability"
- "buildExecutePrompt takes taskDescription, not Initiative (worker agents work on tasks)"
- "Architect procedures validate initiative exists before spawning"
patterns-established:
- "Prompt builder pattern: function(entity, context?) => comprehensive prompt string"
# Metrics
duration: 2min
completed: 2026-01-31
---
# Phase 11 Plan 05: Agent Prompts Module Summary
**Comprehensive mode-specific agent prompts with architect spawn procedures for discuss and breakdown modes**
## Performance
- **Duration:** 2 min
- **Started:** 2026-01-31T18:14:36Z
- **Completed:** 2026-01-31T18:16:56Z
- **Tasks:** 3
- **Files modified:** 3
## Accomplishments
- Created prompts module with buildDiscussPrompt, buildBreakdownPrompt, buildExecutePrompt
- Updated spawnAgent procedure to accept mode parameter
- Added spawnArchitectDiscuss procedure for context-gathering mode
- Added spawnArchitectBreakdown procedure for phase decomposition mode
## Task Commits
Each task was committed atomically:
1. **Task 1: Update spawnAgent to support mode** - `4843b95` (feat)
2. **Task 2: Create comprehensive agent prompts module** - `773f6f9` (feat)
3. **Task 3: Add spawnArchitect tRPC procedures** - `c139859` (feat)
## Files Created/Modified
- `src/agent/prompts.ts` - Comprehensive prompts for discuss, breakdown, and execute modes
- `src/agent/index.ts` - Export prompts from module index
- `src/trpc/router.ts` - Mode param on spawnAgent, architect spawn procedures
## Decisions Made
1. **Prompts in dedicated module** - Separate file for reusability across manager implementations
2. **buildExecutePrompt takes task description** - Worker agents work on tasks, not initiatives
3. **Architect spawn validates initiative** - Prevents orphaned agents with missing initiative
## Deviations from Plan
None - plan executed exactly as written.
## Issues Encountered
None
## User Setup Required
None - no external service configuration required.
## Next Phase Readiness
- Agent prompts module ready for use by CLI commands
- Architect spawn procedures available via tRPC
- Ready for 11-06 (Architect CLI Commands) or 11-07 (E2E Tests)
---
*Phase: 11-architect-agent*
*Completed: 2026-01-31*