Story Decomposition

Decompose user stories into atomic tasks with acceptance criteria and YAML output.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mkolb22/zen-plugin --skill story-decomposition
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Story Decomposition
Source: https://github.com/mkolb22/zen-plugin/tree/main/skills/story-decomposition
Command: npx skills add https://github.com/mkolb22/zen-plugin --skill story-decomposition

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Break down high-level user stories and epics into atomic, estimable tasks with explicit acceptance criteria, enabling reliable planning and delivery.

Core Features & Use Cases

  • INVEST-compliant decomposition: verifies independence, negotiability, value, estimability, small size, and testability.
  • Decomposition strategies: by workflow steps, business rules, data variations, user roles, and CRUD operations.
  • Task breakdown templates: outputs structured YAML for tasks with IDs, estimations, and acceptance criteria.
  • Acceptance criteria patterns: Gherkin, checklist, and rule-based formats.
  • Dependency mapping: hard/soft/external dependencies with visualization-ready graphs.

Quick Start

Provide a high-level story or epic and let the Skill generate decomposed stories, tasks, and a dependency graph.

Frequently Asked Questions about Story Decomposition

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

FAQPage Schema
How do I decompose large agile user stories into estimable tasks?

Decomposing large user stories involves breaking them down by workflow steps, business rules, data variations, user roles, or CRUD operations. This generates atomic, estimable tasks complete with clear acceptance criteria and dependency mappings for reliable agile planning.

What is INVEST validation in agile story decomposition?

INVEST validation in story decomposition verifies that generated tasks meet Independence, Negotiability, Value, Estimability, Small size, and Testability criteria. This ensures decomposed user stories are actionable and ready for reliable agile delivery.

How do I write acceptance criteria for decomposed story tasks?

Acceptance criteria for decomposed story tasks can be written using Gherkin, checklist, or rule-based formats. These patterns structure requirements clearly, ensuring each atomic task is testable and meets the necessary validation standards.

Can I map hard and soft dependencies when breaking down user stories?

Yes, you can map hard, soft, and external dependencies when breaking down user stories. This decomposition process outputs visualization-ready dependency graphs alongside structured YAML tasks to clarify sequencing and constraints for agile planning.

Does this story breakdown tool output structured YAML for task estimations?

Yes, this story breakdown approach outputs structured YAML for tasks complete with IDs, estimations, and acceptance criteria. It applies decomposition templates to produce YAML-ready tasks and dependency mappings for agile workflows.

What is the best way to break down high-level epics for agile delivery?

The best way to break down high-level epics for agile delivery is applying INVEST-compliant decomposition strategies. This verifies story value and testability while generating atomic tasks with explicit acceptance criteria and dependency graphs.