milestone-breakdown

Decompose architecture documents into milestones and features with speckit-compatible outputs.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/leonardoFu/speckit-wiggum-toolkit --skill milestone-breakdown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: milestone-breakdown
Source: https://github.com/leonardoFu/speckit-wiggum-toolkit/tree/main/.claude/skills/milestone-breakdown
Command: npx skills add https://github.com/leonardoFu/speckit-wiggum-toolkit --skill milestone-breakdown

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Breaks down complex software architectures into concrete milestones and features, enabling structured planning, traceability, and incremental delivery.

Core Features & Use Cases

  • Load architecture documents and identify top-level modules, layers, and components.
  • Group components into milestones with clear testable goals and defined dependencies.
  • Break milestones into independently verifiable features aligned with the speckit-specify format.
  • Generate governance and progress artifacts (docs/MILESTONES.md and docs/progress.md) to track execution.

Quick Start

Provide architecture docs (docs/ARCHITECTURE.md) to begin a guided breakdown and generate milestones and features.

Frequently Asked Questions about milestone-breakdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I break down complex software architecture into actionable milestones?

To break down complex software architecture into actionable milestones, you can load your architecture documents to identify top-level modules, group components into testable milestones with clear dependencies, and extract independently verifiable features for incremental delivery.

What is the best way to generate speckit-compatible milestones from architecture docs?

Generating speckit-compatible milestones from architecture docs involves decomposing top-level modules into milestones, extracting features aligned with the speckit-specify format, and mapping dependencies to produce structured planning and traceability artifacts.

How do I track progress and dependencies for software milestones?

To track progress and dependencies for software milestones, you can generate governance artifacts like docs/MILESTONES.md and docs/progress.md, which map component dependencies and monitor incremental delivery throughout the execution workflow.

Do I need a specific architecture document format to start the milestone breakdown?

You need to provide an architecture document, such as docs/ARCHITECTURE.md, to start the milestone breakdown. The process uses this input to identify layers and components, enabling the guided extraction of milestones and features.

How do I extract independently verifiable features from a milestone?

To extract independently verifiable features from a milestone, you break down grouped components into smaller features aligned with the speckit-specify format, ensuring each feature has clear testable goals and defined dependencies for traceability.