Feature #130: Multi-Stage Planning with Sub-Agents

[warmonger0]

Implement new Analyze phase (Phase 0) for ADW workflows with sub-agent delegation.

Implementation Plan: See docs/architecture/IMPLEMENTATION_PLAN_MULTISTAGE_PLANNING.md

Overview

Add a discrete Analyze phase that runs BEFORE the Plan phase to decompose work into components using Claude Code sub-agents.

5 Implementation Phases

1. Data Types & State Extensions (1.5h)

   • Add ComponentAnalysis, DRYFinding, ContextAnalysis dataclasses
   • Extend ADWStateData with analysis fields

2. Sub-Agent Definitions (1.5h)

   • Create .claude/subagents/component_analyzer.md
   • Create .claude/subagents/dry_checker.md
   • Create .claude/subagents/context_calculator.md

3. Analyze Phase Script (2.0h)

   • Implement adws/adw_analyze_work_iso.py
   • Integrate Task tool for sub-agent spawning

4. Enhanced Plan Phase (2.0h)

   • Enhance adws/adw_plan_iso.py with 3-constraint framework
   • Add fallback to time-based heuristics if no analysis

5. Coupled Workflow & Integration (1.0h)

   • Create adws/adw_analyze_plan_iso.py
   • Update ALL_PHASES in orchestrator scripts
   • Add unit tests

Benefits

• 19% cost reduction (220k vs 271k tokens)
• Backward compatible (opt-in via --skip-analysis)
• DRY checking sub-agent prevents code duplication
• Context-aware phase boundaries (file count + token limits + logical coupling)

New 11-Phase Sequence

0. Analyze ← NEW
1. Plan ← Enhanced
2. Validate
3. Build
4. Lint
5. Test
6. Review
7. Document
8. Ship
9. Cleanup
10. Verify

Estimate: 8.0 hours

[warmonger0]

[ADW-AGENTS] ⚠️ Could Not Parse Workflow Command

I detected 'adw_' in your message but couldn't identify the workflow.

Available workflows:

• adw_plan_iso - Plan implementation with base model
• adw_plan_iso with advanced model - Use advanced model set
• adw_lightweight_iso - Quick fixes ($0.20-0.50)
• adw_patch_iso - Apply specific changes
• adw_build_iso adw-12345678 - Build (requires ADW ID)
• adw_test_iso adw-12345678 - Test (requires ADW ID)
• adw_ship_iso adw-12345678 - Ship to main (requires ADW ID)

Example usage:
adw_plan_iso with base model

[ADW-AGENTS]