skills.rest
justinpbarnett
justinpbarnettCOMMUNITY
Explore all skills by this author →
Website𝕏@justinpbarnettGitHub

decompose

Decompose large feature specifications into structured task graphs with mini-spec files.

Updated Mar 9, 2026
Search Tags:#project management#task management#workflow automation#decomposition#agile development#spec breakdown
One-click install
npx skills add https://github.com/justinpbarnett/claude --skill decompose-justinpbarnett
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: decompose
Source: https://github.com/justinpbarnett/claude/tree/main/skills/decompose
Command: npx skills add https://github.com/justinpbarnett/claude --skill decompose-justinpbarnett

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill tackles the challenge of overwhelming feature specifications by intelligently breaking them down into smaller, actionable sub-tasks, making complex projects more manageable for individuals and teams.

Core Features & Use Cases

  • Automatic Decomposition: Analyzes feature specs and determines if decomposition is necessary based on complexity.
  • Task Graph Generation: Creates a structured task graph with dependencies and stages for decomposed features.
  • Mini-Spec Creation: Generates focused mini-specs for each sub-task, detailing scope and steps.
  • Use Case: When a user provides a large feature spec for a new user authentication system, this skill can break it down into distinct tasks like "Data Model and Migration," "Service Logic," "API Endpoints," and "Frontend Components," each with its own mini-spec and defined dependencies.

Quick Start

Use the decompose skill to break down the spec file 'specs/feat-user-auth.md' into smaller tasks.

Frequently Asked Questions about decompose

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

FAQPage Schema
How do I break down large feature specifications into manageable tasks?▼

Feature specifications are decomposed into smaller, focused sub-tasks with defined dependencies and stages. The process analyzes implementation steps, file touchpoints, and inter-step dependencies to generate a structured task graph and mini-spec files for each sub-task.

What is task graph generation for complex development workflows?▼

Task graph generation creates a structured visual map of decomposed feature sub-tasks, outlining their dependencies and sequential stages. It enables parallel processing and agent execution by clarifying inter-step relationships within complex development workflows.

How do I split a complex spec into mini-specs for parallel processing?▼

Splitting a complex spec involves analyzing its implementation steps and file touchpoints to generate focused mini-spec files. Each mini-spec details the specific scope and steps for an individual sub-task, enabling parallel processing across independent development stages.

Does spec breakdown work for agile development and task management?▼

Spec breakdown supports agile development by transforming overwhelming feature specifications into structured, actionable sub-tasks. It integrates with task management by defining dependencies and stages, making complex projects manageable for teams and automated agents.

When do I need to decompose a feature specification?▼

Decomposition is necessary when a feature specification is too complex for direct implementation. The process analyzes the spec's complexity to determine if breaking it down into smaller sub-tasks with defined dependencies is required for manageable execution.

What is the best way to manage dependencies in decomposed task workflows?▼

Managing dependencies in decomposed workflows involves generating a structured task graph that maps inter-step relationships. This graph defines sequential stages and file touchpoints, ensuring sub-tasks are executed in the correct order for parallel processing.

Related Skills

Explore More Software Engineering Skills→
dan1901dan1901
1

spec-validator

Validate Spec-Driven Development artifacts across feature directories and generate a report of findings and recommendations.

Community
Basic
EanLeeEanLee

writing-plans

Generate step-by-step implementation plans for software development tasks.

Community
Advanced
liujiarui0918liujiarui0918

using-task-list

Create, track, and update tasks with dependencies and statuses.

Community
Intermediate
eduwxyzeduwxyz
10

dev-workflow

Execute a complete development workflow with planning, implementation, testing, and review.

Community
Advanced