task-decomposition

Generate epics, user stories, and atomic tasks from PRD and architecture documents.

1|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/Porkbutts/porkbutts-n-taters --skill task-decomposition-porkbutts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: task-decomposition
Source: https://github.com/Porkbutts/porkbutts-n-taters/tree/main/skills/task-decomposition
Command: npx skills add https://github.com/Porkbutts/porkbutts-n-taters --skill task-decomposition-porkbutts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill translates a product requirements document (PRD) and architectural design into a structured, actionable task plan for engineering teams.

Core Features & Use Cases

  • Epic, story, and task generation: Converts high-level requirements into a hierarchical plan with clear acceptance criteria.
  • Documentation output: Produces docs/TASKS.md that can be shared with stakeholders and used to guide sprints.
  • Use Case: Given a PRD and architecture.md, generate a complete tasks breakdown ready for review.

Quick Start

Run the task-decomposition skill to generate docs/TASKS.md from docs/PRD.md and docs/ARCHITECTURE.md.

Frequently Asked Questions about task-decomposition

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

FAQPage Schema
How do I generate user stories and tasks from a PRD and architecture document?▼

To generate user stories and tasks from a PRD, use a task decomposition process that reads your docs/PRD.md and docs/ARCHITECTURE.md to output a structured docs/TASKS.md file. This translates high-level requirements into epics, stories, and atomic tasks.

What is the best way to break down epics into atomic, testable engineering tasks?▼

The best way to break down epics into atomic tasks is to align them with your architectural design, ensuring each task is independently executable and testable. This yields a hierarchical plan with clear acceptance criteria.

Can I create a sprint-ready task breakdown without manual outlining?▼

Yes, you can create a sprint-ready task breakdown by processing your existing PRD and architecture documents. The system automatically translates these inputs into a structured engineering plan, producing a shared TASKS.md file.

What format does the task plan output use for sharing with stakeholders?▼

The task plan output uses a markdown format, specifically generating a docs/TASKS.md file. This document contains the hierarchical breakdown of epics, user stories, and atomic tasks, making it easy to share with stakeholders.

Do I need both a PRD and architecture document to generate a task breakdown?▼

Yes, you need both a PRD and an architecture document to generate a complete task breakdown. The process reads docs/PRD.md and docs/ARCHITECTURE.md to ensure the resulting tasks align with both product requirements and technical design.