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.