aped-epics

Decompose PRDs into user-value epics with exact FR coverage validation.

2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/yabafre/aped-claude --skill aped-epics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aped-epics
Source: https://github.com/yabafre/aped-claude/tree/main/src/templates/skills/aped-epics
Command: npx skills add https://github.com/yabafre/aped-claude --skill aped-epics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill turns a PRD into an organized epic and story plan, ensuring every FR maps to exactly one epic and that coverage is validated before implementation.

Core Features & Use Cases

  • User-value epic decomposition: Groups functionality by what users can accomplish, not by technical layers.
  • Story list planning (no story files): Produces a per-epic story list with clear user outcomes and FR mapping, leaving story file creation to the next skill.
  • FR coverage discipline: Validates that every PRD FR appears in the plan and surfaces a running coverage matrix during design.
  • Ticket readiness (optional): Seeds ticket/milestone planning when a ticket system is configured, after user confirmation gates.

Quick Start

Run aped-epics when you want to break your PRD into epics and a story list, and then confirm the A/P/C gate when prompted.

Frequently Asked Questions about aped-epics

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

FAQPage Schema
How do I break down a PRD into epics and user stories?

PRD decomposition into epics groups functionality by user value rather than technical layers, producing a per-epic story list with clear outcomes and FR mapping. It enforces exact FR-to-epic coverage validation before writing planning artefacts.

What is user story mapping and how does it help product planning?

User story mapping organizes product requirements into user-value epics, ensuring every functional requirement maps to exactly one epic. This prevents coverage gaps and keeps planning focused on user accomplishments rather than technical architecture.

Do I need an existing PRD and architecture document before creating epics?

Yes, epic decomposition requires loading upstream PRD, architecture, and UX inputs along with APED configuration. These provide the functional requirements and design context needed to validate FR-to-epic coverage accurately.

How do I validate that every functional requirement is covered by an epic?

FR coverage validation runs during epic design and surfaces a running coverage matrix checking that every PRD functional requirement maps to exactly one epic. It gates user approval before writing outputs to ensure no requirement is missed.

Can I seed tickets and milestones from a story list without creating individual story files?

Yes, epic decomposition produces a per-epic story list and planning artefacts like epics.md without creating story files. When a ticket system is configured, it seeds ticket and milestone planning after user confirmation gates are passed.

What's the best way to decompose requirements into epics without splitting by technical layers?

User-value epic decomposition groups functionality by what users can accomplish, validating FR coverage and producing a story list with clear user outcomes. An approval gate ensures the plan meets coverage requirements before artefacts are written or tickets synced.