story-splitting

Split epics and large stories into small end-to-end vertical slices using SPIDR and Hamburger patterns.

3|Updated Nov 8, 2014
One-click install
npx skills add https://github.com/mintuz/.dotfiles --skill story-splitting-mintuz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-splitting
Source: https://github.com/mintuz/.dotfiles/tree/main/agents/.agents/skills/story-splitting
Command: npx skills add https://github.com/mintuz/.dotfiles --skill story-splitting-mintuz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Large stories, epics, and backlog items are too big to deliver, test, and learn from in small batches, and naive decomposition produces technical component tasks instead of independently valuable user-facing slices. ## Core Features & Use Cases - Vertical Slice Decomposition: Reframe broad requirements into child stories that each deliver a complete user-visible capability through the real production path, avoiding component or layer splits. - Pattern Catalog: Apply SPIDR, Hamburger Method, Humanizing Work patterns, and Bill Wake's twenty splitting approaches when a story resists simple decomposition. - Quality Validation: Check every child story against INVEST criteria and a red-flag checklist before handing off to implementation planning. - Use Case: Given an epic like "build online banking portal," reframe it into capabilities such as "customers can pay bills," then produce a first walking-skeleton slice plus a table of follow-up slices with acceptance examples and release constraints. ## Quick Start Ask the assistant to split a large epic or backlog item into small end-to-end stories using the story-splitting skill.

Frequently Asked Questions about story-splitting

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

FAQPage Schema
How do I split a large user story or epic into smaller stories?

Reframe the parent as an actor, capability, and outcome, then surface examples and split along dimensions like path, interface, data, rules, or quality. Each child story must deliver an end-to-end user-visible behavior, not a technical layer.

What is the difference between vertical slices and component stories?

Vertical slices deliver a complete user-visible behavior through all layers, while component stories split work by backend, frontend, or database tasks. Component splits delay integration and produce no independently testable value.

What is the SPIDR technique for splitting user stories?

SPIDR splits stories by Spike, Path, Interface, Data, and Rules. It is a quick checklist for finding a narrower story that still stands alone, with spikes used last for genuine implementation uncertainty.

When should I use the Hamburger Method for story splitting?

Use the Hamburger Method when the team keeps decomposing work into technical layers. List the layers, define simplest-to-richest options per layer, then take a first bite across every layer so the result stays end-to-end.

Can a split story be non-releasable or hidden behind a flag?

Yes, if the release constraint is explicit. A slice may be internal-only, demo-only, or flag-hidden, but it must state why it is non-releasable and what would make it releasable, and never defer legal or safety requirements.

What are common mistakes when splitting user stories?

Common mistakes include splitting by process steps or technical layers, letting the product owner split alone, overusing spikes, forcing all business rules into the first slice, and creating children that all depend on each other before testing.