story-splitting

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

Updated May 18, 2024
One-click install
npx skills add https://github.com/joshhornby/dotfiles --skill story-splitting-joshhornby
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-splitting
Source: https://github.com/joshhornby/dotfiles/tree/main/.claude/skills/story-splitting
Command: npx skills add https://github.com/joshhornby/dotfiles --skill story-splitting-joshhornby

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 (backend, frontend, database) instead of independently valuable user-facing slices. ## Core Features & Use Cases - Vertical Slice Decomposition: Reframe broad requirements into child stories that each deliver a whole user-visible capability, validated against the INVEST quality bar and a feedback triad. - Named Splitting Patterns: Apply SPIDR, Hamburger Method, Humanizing Work patterns, Bill Wake's twenty ways, and walking skeleton/tracer bullet techniques via an on-demand pattern catalog. - Structured Output: Produce a split artifact with a recommended first slice, split candidates table, parking lot, and warnings that feeds directly into implementation planning. - Use Case: Given an epic like "build online banking portal", reframe it into capabilities such as "customers can pay bills", then split into a first slice like "buyer can pay one invoice by card and receive a confirmation" with explicit deferrals and acceptance examples. ## Quick Start Ask the assistant to split a large story or epic into small end-to-end vertical slices, for example: "Split this epic about invoice payments into independently valuable child stories."

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 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 capability, not a technical layer.

What is the difference between vertical slices and component tasks?

A vertical slice changes behavior visible to a real user or external system and runs through the real production path. Component tasks like "build the API" or "add the database table" are work items inside a story, not independently valuable stories.

What is the SPIDR technique for splitting user stories?

SPIDR splits stories by Spike, Path, Interface, Data, and Rules. Use it as a quick checklist: isolate a happy path, one channel, a data subset, or a scoped business rule, and reserve spikes for specific unanswered questions.

When should I use the Hamburger Method for story splitting?

Use it when the team keeps decomposing work into technical layers. List the layers, list simpler-to-richer 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 internal-only?

Yes, if the release constraint is stated explicitly, such as internal-only, demo-only, or disposable tracer. Safety, legal, privacy, and security requirements must never be deferred without a clear non-release constraint.

When should I not use story splitting?

Do not use it to resolve open product decision trees, to produce implementation tasks, or to inspect an existing plan for gaps. Use decision-making skills first, then split, then hand the selected child story to implementation planning.