mad-decompose

What problem does it solve?

Large feature design documents are difficult to manually break into manageable, dependency-ordered milestones without missing implementation gaps, creating unreviewable large PRs, or introducing integration risks between horizontal work layers. This Skill eliminates that manual overhead by automating the full decomposition workflow with built-in validation guardrails.

Core Features & Use Cases

• Parallel Gap Analysis: Spawns 3 specialized agent analysts to map existing code, backlog items, and design document features to identify unplanned work.
• Validated Milestone Grouping: Synthesizes analysis into dependency-ordered, vertical-slice milestones with automatic size calibration, DAG validation, and integration point documentation.
• Batched Idea Generation: Produces scoped idea.md files for each milestone that align with MAD kit standards, ready to feed into the /mad-spec workflow.
• Use Case: If you have a 2000-line feature design covering 20 API endpoints and 12 data entities, this Skill will automatically split it into 6-8 shippable milestones, each with a fully scoped idea file and a reviewable milestone map.

Quick Start

Use the mad-decompose skill to decompose your feature design document at docs/design/feature-overview.md into dependency-ordered, shippable milestones with generated idea files.