Codewalkers/.planning/milestones/v1.3-ROADMAP.md

Milestone v1.3: Parallel Execution & UI Design

Status: SHIPPED 2026-02-02 Phases: 14-15 Total Plans: 11

Overview

Enable parallel phase execution with dependency tracking and design the frontend UI with markdown wireframes. Phases can now declare dependencies on other phases and execute concurrently when independent. Three UI screens designed as ASCII wireframes with component specifications.

Phases

Phase 14: Parallel Phase Execution

Goal: Add dependencies to phases (same pattern as tasks), enable concurrent execution of independent phases Depends on: Phase 13 (v1.2 complete) Plans: 8 plans

Plans:

• 14-01: Phase Dependencies Schema & Repository
• 14-02: Phase Domain Events
• 14-03: PhaseDispatchManager Port Interface
• 14-04: PhaseDispatchManager Adapter
• 14-05: tRPC Procedures
• 14-06: CLI Commands
• 14-07: Unit Tests
• 14-08: E2E Tests

Key deliverables:

• phase_dependencies table mirroring task_dependencies pattern
• Phase lifecycle events (queued, started, completed, blocked)
• PhaseDispatchManager port and DefaultPhaseDispatchManager adapter
• Dependency-ordered phase dispatch with in-memory queue
• tRPC procedures for phase dependencies and dispatch
• CLI commands under cw phase group
• E2E tests covering independent, sequential, diamond, and blocked scenarios

Key decisions:

• 14-01: phase_dependencies table mirrors task_dependencies exactly (same FK patterns, cascade delete)
• 14-02: Phase events follow task event naming pattern (phase:queued, phase:started, etc.)
• 14-03: PhaseDispatchManager methods use Phase suffix for clarity
• 14-04: In-memory Map for phaseQueue (same pattern as DefaultDispatchManager)
• 14-04: Sort ready phases by queuedAt (oldest first, no priority)
• 14-06: Phase commands as top-level cw phase group
• 14-08: E2E tests cover 4 core scenarios: independent, sequential, diamond, blocked

Phase 15: Frontend Wireframes

Goal: Markdown diagrams for initiative dashboard, phase/task breakdown, and agent inbox UI screens Depends on: Phase 14 Plans: 3 plans

Plans:

• 15-01: Initiative Dashboard Wireframe
• 15-02: Initiative Detail Wireframe
• 15-03: Agent Inbox Wireframe

Key deliverables:

• Initiative dashboard with status badges, progress bars, architect spawn actions
• Initiative detail with Phase → Task hierarchy, dependency visualization, agent assignments
• Agent inbox with multi-question Q&A, option groups, answer submission flow
• Component specifications for all UI elements (14 components total)
• Interaction notes for navigation, modals, and keyboard shortcuts

Key decisions:

• Simplified UI hierarchy to Initiative → Phase → Task (removed Plan layer)
• PhaseAccordion contains tasks directly (no intermediate PlanTree)
• Progress metrics show phases/tasks only (no plans count)

---

Milestone Summary

Key Decisions:

• Phase dependency pattern mirrors task dependency exactly for consistency
• In-memory queues for phase dispatch (same as task dispatch, no persistence for v1)
• Removed Plan layer from UI hierarchy — simplified to Initiative → Phase → Task
• Phase commands as top-level CLI group for direct access

Issues Resolved:

• None

Issues Deferred:

• None

Technical Debt Incurred:

• None

---

For current project status, see .planning/ROADMAP.md