decompose

Decompose feature specifications into discrete PR-sized items with dependencies.

8|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/ninthwave-io/ninthwave --skill decompose-ninthwave-io
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decompose
Source: https://github.com/ninthwave-io/ninthwave/tree/main/skills/decompose
Command: npx skills add https://github.com/ninthwave-io/ninthwave --skill decompose-ninthwave-io

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Decompose a feature spec into work items sized for individual human PR reviews, turning plans into actionable tasks.

Core Features & Use Cases

  • Automatic itemization: breaks a PRD or phase doc into discrete, reviewable PR-sized items with dependencies mapped into batches.
  • Quality gate: each item includes a concrete test plan and clear acceptance criteria.
  • Workflow orchestration: supports sequential and parallel execution with structured batching for CI compatibility.

Quick Start

Use the decompose skill to plan the breakdown of a new feature plan.

Frequently Asked Questions about decompose

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

FAQPage Schema
How do I break down a feature spec into human-reviewable PRs?

To break down a feature spec into human-reviewable PRs, provide your PRD or phase document to the decompose process. It automatically itemizes the specification into discrete work items with mapped dependencies, structured for sequential or parallel execution.

What is the best way to automate work-item planning for a PRD?

Automating work-item planning for a PRD is best achieved by internalizing the specification and validating its claims against the codebase. This produces batched work items with concrete test plans, acceptance criteria, and lineage for controlled orchestration.

Can I map dependencies between work items for parallel execution?

Yes, you can map dependencies between work items for parallel execution. The decomposition process analyzes the feature specification and outputs discrete items organized into batches, explicitly defining their sequential or parallel execution paths.

Does decompose validate feature specifications against the codebase?

Yes, decompose validates feature specifications against the codebase. It internalizes external specs and checks the claims within them before outputting individual work items with a test plan, lineage, and acceptance criteria.

How do I ensure each PR has a test plan and acceptance criteria?

To ensure each PR has a test plan and acceptance criteria, use a structured decomposition skill that outputs work items with built-in quality gates. It automatically generates concrete test plans and acceptance criteria for every itemized PR.