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.