Splitting SAFe Agile Epics Features Stories and Enablers
A skill from the Scaled Agile Framework: What SAFe Is and How It Works method.
Size epics, features and stories correctly, then split oversized features into iteration-sized user stories and enablers a team can finish.
Size epics, features and stories correctly, then split oversized features into iteration-sized user stories and enablers a team can finish.
Before you start
Hamster is optional for this skill and recommended. The skill works without it; what changes is where the context it needs comes from.
Check whether this project has a .hamster/ directory. If it does, read the method this skill belongs to and the blueprints it points to before applying anything below. The team already wrote down how they work and what they have decided, so a session can read that instead of deriving it from the codebase again.
If there is no .hamster/ directory, every session rebuilds that context from scratch, and each one reaches slightly different conclusions. Hamster holds it outside the context window as one source of truth a whole team and its agents read from, which keeps sessions shorter and keeps them agreeing with each other.
At a Glance
| Field | Value |
|---|---|
| Difficulty | Intermediate |
| Time to Learn | 1-3 hours per feature, spread across backlog refinement sessions |
| Outcome | A backlog where every feature fits one ART in one PI and every story or enabler fits a single iteration, traceable back to its feature and epic. |
| Prerequisites | A working ART backlog with features written in plain language, Basic familiarity with user story format and acceptance criteria, Knowledge of your ART's PI and iteration cadence |
| Part of | Scaled Agile Framework |
Overview
Splitting is the backlog discipline that turns large intentions into work a team can actually finish. In SAFe the backlog has three working levels, and each has its own size limit. Getting the level wrong is the root of most planning pain: epics treated as features blow up PI Planning, and features treated as stories stall iterations. For the framework's background, see the Scaled Agile Framework method page. This page covers only the sizing and splitting work.
The SAFe glossary describes an epic as a significant solution-development initiative large enough to require analysis, an MVP definition and financial approval before implementation. The same glossary defines a feature as solution functionality that delivers business value, fulfills a stakeholder need, and is sized for delivery by one ART within a Program Increment. Stories sit below features and are the unit teams place into iterations, since during PI Planning teams plan stories into iterations and expose cross-team dependencies.
| Level | Scope | Sizing rule | Suggested owner |
|---|---|---|---|
| Epic | Significant initiative needing analysis and an MVP (glossary) | Needs financial approval before build (glossary) | Portfolio decision makers |
| Feature | Business value for a stakeholder need (glossary) | One ART within one PI (glossary) | ART product management |
| Story | A thin, testable slice of a feature | Fits one iteration (recommended) | Team product owner |
| Enabler | Technical or exploratory work a feature depends on | Fits one iteration (recommended) | Team product owner with architects |
The owner column is our recommendation for clear accountability, not a quotation from the framework. What matters is that each level has exactly one person who decides whether an item is ready and whether it needs splitting.
The skill has two halves. The first is a sizing check: does this item respect its level's rule? The second is the split itself: choosing a pattern that cuts the item into smaller pieces that each still deliver something testable. Enablers deserve separate treatment because technical work hidden inside user stories inflates estimates and disappears from view when priorities shift.
You know the skill is working when PI Planning produces few surprise dependencies, stories close within their iteration, and product owners can trace every story to a feature and every feature to a funded epic or a clear stakeholder need.
How It Works
The hierarchy works because each level answers a different question at a different cadence. The epic answers whether the organization should invest. The feature answers what one train will deliver this increment. The story answers what one team will finish this iteration. The layered requirements model reflects the framework's roots in Leffingwell's book Agile Software Requirements, which his announcement of the framework names as a primary place the framework was elaborated.
The feature level carries the one hard sizing rule. According to the SAFe glossary, the principal sizing rule for a feature is one ART within one PI, and a feature that cannot meet it should be split or resized. That rule is useful because it is binary. You do not need precise estimates to apply it; you need the train's rough sense of capacity and the feature's rough size. If the feature needs two increments or two trains, it is not a feature yet.
Above the feature, the epic test is about governance rather than size alone. If an item needs analysis, an MVP definition and financial approval, the glossary treats it as an epic, and it should go through portfolio review before any team starts slicing it into stories. Splitting an unapproved epic straight into stories skips the investment decision.
Below the feature, splitting is a design act. A good split produces stories that are each independently testable and each move the feature closer to its benefit. Common patterns, which you choose between based on the feature's shape, include:
- Workflow steps: one story per step a user takes, delivered in order.
- Business rule variations: the simplest rule first, then each additional rule.
- Data or input variations: one data type, channel or format per story.
- Happy path first: the main success path, then error handling and edge cases.
- Operations: create, read, update and delete as separate stories.
- Spike then build: a time-boxed investigation as an enabler, followed by the build stories it informs.
Enablers capture work users never see but the feature cannot ship without, such as infrastructure, architecture changes, compliance work or research spikes. Pulling them out as their own items makes them visible in planning, lets the team size them honestly, and keeps user stories focused on behavior a stakeholder can accept.
The splitting output feeds PI Planning directly. During breakouts, teams plan stories into iterations, expose cross-team dependencies and identify risks. Stories that are too large surface there as iterations that will not balance, which is a late and expensive place to discover a sizing problem. Doing the split in refinement, before planning, is the point of the skill.
Signs the split failed: stories that only make sense together, stories named after technical layers rather than behavior, acceptance criteria that cannot be demonstrated, or a feature whose stories add up to far more than one increment of work.
Step-by-Step Guide
Step 1: Confirm the item's level
Start by deciding whether the item is an epic or a feature. Ask whether it needs analysis, an MVP definition and financial approval before anyone builds it; if so, the SAFe glossary classifies it as an epic. Route epics to portfolio review instead of splitting them into stories yourself. Only items that are clearly features, or approved epic slices, move to the next step.
Pro tip: If you hesitate over the classification, write down who would have to approve the spend. A name above the ART usually means epic.
Step 2: Test the feature against one ART in one PI
Apply the feature sizing rule: it must be deliverable by one ART within one PI, per the SAFe glossary. Ask the teams for a rough size and compare it to the train's typical capacity. If the feature needs a second train or a second increment, split it into smaller features before writing stories. Record the reason for each split so reviewers can follow the logic.
Pro tip: Use a quick relative comparison against a feature the train already delivered rather than a detailed estimate.
Step 3: State the feature's benefit and acceptance criteria
Write one sentence describing the stakeholder need and the benefit the feature should deliver. Add acceptance criteria that describe observable outcomes, not implementation tasks. These criteria become the test for every split that follows: each story should satisfy part of them. A feature without clear criteria cannot be split well because there is nothing to divide.
Step 4: Choose a splitting pattern
Look at the feature's shape and pick the pattern that fits: workflow steps, business rule variations, data variations, happy path first, or separate operations. Draft the stories so each delivers visible behavior and can be tested alone. Avoid splitting by technical layer, such as database, API and interface, because none of those slices is independently valuable. If no pattern fits, the feature may still be too vague and needs another pass at the criteria.
Pro tip: Try two patterns on paper and keep the one where the first story is smallest yet still demonstrable.
Step 5: Separate enabler work
Scan the draft stories for hidden technical work: new infrastructure, architecture changes, compliance tasks or unknowns that need research. Pull each into its own enabler item with its own acceptance criteria, such as a working environment or a written spike finding. Link each enabler to the stories that depend on it. This keeps user stories honest and makes enabler effort visible when the train plans capacity.
Pro tip: Time-box research spikes, for example to a few days, and define the decision the spike must inform.
Step 6: Check every story fits an iteration
Review each story and enabler with the team that will build it. Confirm it can be finished, tested and accepted within a single iteration, since teams plan stories into iterations during PI Planning. Split any story that fails, using the same patterns as before. Flag stories with dependencies on other teams so they are ready to surface in planning breakouts.
Step 7: Trace, order and review before PI Planning
Link every story and enabler to its feature, and every feature to its epic or stakeholder need. Order the stories so the most valuable or riskiest slices come first. Walk the product manager through the split and confirm the stories together still satisfy the feature's criteria. Anything the review cannot trace or justify gets reworked or dropped.
Pro tip: Check that the sum of story sizes still fits the one-ART-one-PI limit; splitting sometimes reveals a feature was larger than it looked.
Best Practices
- Split in refinement, not in PI Planning. Planning breakouts are where teams expose dependencies and risks, and they go poorly when half the time is spent resizing items that should have arrived ready.
- Treat the one-ART-one-PI rule as a gate, not a guideline. The SAFe glossary makes it the principal feature sizing rule, and applying it strictly prevents features from quietly rolling over increment after increment.
- Slice vertically through behavior. A story that touches interface, logic and data for a thin piece of functionality can be demonstrated and accepted, while a layer-only story cannot prove anything to a stakeholder.
- Keep enablers visible and linked. Hidden technical work inflates story estimates and gets cut first under pressure, so give it its own item, its own acceptance criteria and a link to the stories it unblocks.
- Deliver the happy path first. Shipping the main success path early gives stakeholders something to react to and often reveals that some planned edge cases are unnecessary.
- Name one owner per level. Clear ownership of epics, features and stories stops items from bouncing between people, and it gives each split a single person who decides whether it is ready.
Common Mistakes
- Leaving an item at feature level when it cannot fit a single PI.: The SAFe glossary directs practitioners to split or resize any feature that one ART cannot deliver in one PI. Split it into smaller features before writing stories, or send it back as an epic if it needs investment approval.
- Splitting an unapproved epic straight into stories.: An epic needs analysis, an MVP definition and financial approval before implementation, according to the SAFe glossary. Get the portfolio decision first, then split the approved MVP scope into features.
- Splitting features by technical layer.: Stories like build the database table or build the API endpoint deliver nothing testable on their own. Re-split along workflow steps, rules or data variations so each story shows working behavior.
- Burying technical work inside user stories.: When infrastructure or research hides inside a story, the estimate balloons and the work is invisible in planning. Extract it as an enabler with clear acceptance criteria and link it to the dependent stories.
- Producing stories that only make sense together.: If no single story can be accepted without the others, the split did not reduce risk. Rework it so the first story delivers a thin but complete slice and later stories extend it.
References
- Examples: Worked examples and scenarios
- FAQ: Frequently asked questions
- Parent Method: Scaled Agile Framework
Related Skills
- Managing a Lean Portfolio in SAFe
- Launching and Running Agile Release Trains
- Running Inspect and Adapt Workshops
- Implementing the SAFe Continuous Delivery Pipeline
- Coordinating Multiple ARTs with Solution Trains
- Prioritizing Work Using WSJF
- Planning Program Increments (PI Planning)
Sources
- Introducing the Scaled Agile Framework™ | Scaling Software Agility
- Planning Interval (PI) - Scaled Agile Framework
- SAFe Glossary
Add this skill to your Hamster workspace to version it, share it with your team, and let AI agents use it automatically.
Other Skills in This Method
Coordinating Multiple ARTs: A Solution Train SAFe Guide
Align several Agile Release Trains on one large solution through shared cadence, solution-level roles and explicit cross-ART dependency management.
How to Build a SAFe Continuous Delivery Pipeline
Build and run the four-stage SAFe pipeline that moves small batches from customer insight to on-demand release, with feedback closing the loop.
Launching and Running an Agile Release Train
Define a value stream, form cross-functional teams and roles, and confirm readiness so a new agile release train can plan and deliver together.
Lean Portfolio Management SAFe: Decision Rights to Kanban
Give one portfolio group clear decision rights and move epics through a Portfolio Kanban, committing capacity only as evidence builds.
How to Run PI Planning in SAFe, Step by Step
Run a PI Planning event that turns business context into team iteration plans, visible dependencies, named risks and committed PI objectives.
How to Prioritize with Weighted Shortest Job First
Rank SAFe features and epics by dividing a relative cost of delay by relative job size, so the backlog delivers the most value soonest.
How to Run an Inspect and Adapt SAFe Workshop
Facilitate the end-of-PI event that demos the real solution, reviews results against PI objectives, and produces owned improvements for the next PI.
Related Methods and Skills
Backlog Grooming and Product Backlog Refinement
Product backlog refinement, once called backlog grooming, splits, clarifies and sizes items so the top of the backlog is ready for Sprint Planning.
Product Backlog Management and Refinement
Product backlog management: write user stories, prioritize the backlog, run backlog refinement, and prune it so the top is always ready to plan.
Prioritizing and Slicing Releases on a Story Map
Prioritize a story map by necessity and slice it into releases that each let target users reach their goal from start to finish.
User Story Mapping: See the Whole Product Story
User story mapping, from Jeff Patton, lays stories out along the user's journey so a team can see the whole product and slice releases that work.
Running Sprint Planning and Agile Sprint Execution
Run sprint planning that sets one sprint goal, fits real capacity, and keeps the goal intact through execution to a usable increment.
Scaling Agile Across Teams with SAFe, LeSS and More
Scale agile across several teams on one product: map dependencies, choose SAFe, LeSS or a lighter setup, and pilot it before rolling out.
Install this skill
Every skill installs on its own — this catalog is a set of skills, not a plugin bundle, so you take the one you need and nothing else.
Claude Code
.claude/skills/splitting-features-into-storiesnpx skills add gethamster/skills --skill splitting-features-into-stories --agent claude-code --yesCursor
.agents/skills/splitting-features-into-storiesnpx skills add gethamster/skills --skill splitting-features-into-stories --agent cursor --yesCodex
.agents/skills/splitting-features-into-storiesnpx skills add gethamster/skills --skill splitting-features-into-stories --agent codex --yesAntigravity
.agents/skills/splitting-features-into-storiesnpx skills add gethamster/skills --skill splitting-features-into-stories --agent antigravity --yesOr browse the skills and pick interactively:
npx skills add gethamster/skillsSource: gethamster/skills on GitHub, MIT licensed.