Phase 4.7 -- Setup Wizard

Parent: #762 | Wave 3 | Absorbs: #238, #726, #728

Context

The setup wizard is the only current page with good UX. Rebuild it in React preserving the step flow logic while adding the features from #238, #726, and #728.

Scope

Preserved from current wizard

• Step-by-step flow with progress indicators
• Step validation and back-navigation
• Completion summary
• API calls (POST /setup/*)

New from #238 (company builder)

• Template selection with category grouping
• Agent customization (name, role, personality assignment)
• Provider assignment per agent
• Department configuration
• Mini org chart preview of the configured company

New from #726 (template comparison)

• Side-by-side template comparison view
• Cost estimator (projected monthly cost based on agent count, model selection)
• Category grouping (startup, enterprise, consultancy, etc.)

New from #728 (template variables)

• Sliders and toggles for team scaling (e.g. "Engineering team size: 3-8")
• Optional department toggles
• Variable-driven template customization

Data requirements

• GET /setup/* endpoints
• GET /providers/presets
• Template data from API

Deliverables

• Full setup wizard in React with all steps
• Template comparison view
• Cost estimator
• Template variable controls (sliders, toggles)
• Mini org chart preview
• Step validation and progress indicators
• Unit tests for step flow, cost calculation, validation
• Close feat: implement company builder interactive wizard (UI + API) #238, feat: template comparison view and cost estimator in setup wizard #726, feat: add template variables for team scaling and optional departments #728 as absorbed

Blocked by

• feat: interaction components and animation patterns #776 (interaction components)