Phase 7: Multi-Agent Orchestration

[laynepenney]

Summary

Implement IPC-based multi-agent orchestration for parallel task execution.

Reference Implementation

Based on Codi-TS orchestrate/:

• Commander process manages worker agents
• Workers run in isolated git worktrees
• Permission requests bubble up via Unix sockets
• Human-in-the-loop approval for all operations

Components to Implement

Child Agent

• Agent wrapper with IPC-based permissions
• Spawn sub-agents in separate processes
• Task assignment and progress tracking

IPC Protocol

• Unix socket server/client
• Message types: handshake, permission_request, status_update, task_complete
• Newline-delimited JSON format

Commander

• Orchestrate multiple workers
• Route permission requests to user
• Aggregate results
• Handle worker failures gracefully

Worktrees

• Git worktree creation/cleanup
• Branch management per worker
• Merge conflict handling

Dependencies

• tokio for async IPC
• git2 0.19 for worktree management

Related

• Depends on: Phase 6 TUI (merged)
• Depends on: Phase 5.5 Session (merged)

Estimated Effort

~4 weeks, ~6 person-weeks