epic-framing

Frames epics as coherent bets with shared outcomes, rollup acceptance criteria, and sequenced child features.

3|2|Updated Aug 24, 2026
One-click install
npx skills add https://github.com/hero-engine/hero --skill epic-framing-hero-engine
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: epic-framing
Source: https://github.com/hero-engine/hero/tree/main/domains/pm/skills/epic-framing
Command: npx skills add https://github.com/hero-engine/hero --skill epic-framing-hero-engine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Product teams often create epics that are just labels over unrelated stories sharing a topic but no shared outcome, making it impossible to know when the epic is truly done or why the work belongs together. This Skill provides a three-part framing discipline that keeps an epic coherent. ## Core Features & Use Cases - Coherence Test: Determines whether a set of features genuinely shares one outcome or should be split into separate initiatives, features, bugs, or chores. - Three-Part Frame: Produces a Why stated in outcome terms, a rollup acceptance line the child features sum to, and sequenced children with dependency, value-first, or risk-first ordering rationale. - Splitting Guidance: Identifies when an epic is too large, incoherent, or actually initiative-sized and should be reframed. - Use Case: When a story-writer flags an over-large feature as really an epic, use this Skill to test coherence, write the Why and rollup acceptance line, and sequence the child features with real ordering rationale. ## Quick Start Ask the AI to frame a new epic from your initiative or large PRD using the epic-framing skill, including the shared outcome, rollup acceptance criteria, and sequenced child features.

Frequently Asked Questions about epic-framing

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

FAQPage Schema
How do I write a good epic in product management?▼

Write an epic with three parts: a Why naming the shared outcome in outcome terms, a rollup acceptance line describing the integrated behavior the child features sum to, and sequenced children each with a one-line ordering rationale based on dependency, value, or risk.

How to tell if features belong in one epic or should split?▼

Apply the coherence test: the child features must share one outcome such that delivering some but not all still moves that outcome. If they share only a topic like billing with no common outcome, split them into separate features, bugs, or their own coherent epic.

What is the difference between an epic, initiative, and feature?▼

An epic is a mid-tier grouping: coarser than a feature because it needs decomposition to deliver, and finer than an initiative because it is a specific slice of a strategic bet rather than the whole bet. Initiative-sized work should be framed with roadmap framing instead.

When should an epic be split into smaller epics?▼

Split an epic when it would take more than a couple of cycles, has 15 or more children, or when no single Why covers all children. Split along the sub-outcome seam rather than arbitrarily, and never force an epic over independent features sharing only a tag.

Why is 'done when all child stories are done' a bad epic acceptance criterion?▼

That is a status check, not an acceptance line, because children can all be done while the integrated behavior still fails. A rollup acceptance line names the aggregate end-to-end condition that proves the bet landed, revealing missing children when it stays false.