decomposing-feature-to-stories

Decompose Feature specs into atomic Gherkin Story scenarios with ≤7 stories and BSP ordering.

1|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/simonheimlicher/spx-claude --skill decomposing-feature-to-stories
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decomposing-feature-to-stories
Source: https://github.com/simonheimlicher/spx-claude/tree/main/plugins/spx/skills/decomposing-feature-to-stories
Command: npx skills add https://github.com/simonheimlicher/spx-claude --skill decomposing-feature-to-stories

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Break down large, unclear Feature specs into atomic, testable Story specs expressed as Gherkin scenarios.

Core Features & Use Cases

  • Identify atomic outcomes within a Feature that can be expressed as standalone Gherkin scenarios.
  • Split the Feature into a bounded number of Stories (≤7) while preserving integration outcomes and quality gates.
  • Use BSP-based ordering to capture dependencies between Stories and guide implementation.

Quick Start

Provide a Feature spec and run the decomposition workflow to produce 1–7 Story specs with associated BSP orderings.

Frequently Asked Questions about decomposing-feature-to-stories

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

FAQPage Schema
How do I decompose a feature into agile stories using Gherkin scenarios?

Decomposing a feature into agile stories involves identifying atomic outcomes within the feature and expressing them as standalone Gherkin scenarios. This ensures each story is testable and preserves integration outcomes and quality gates.

What is the maximum number of stories a feature should be split into?

A feature should be split into a maximum of seven stories. This bounded decomposition ensures the feature remains manageable while preserving integration outcomes, quality gates, and allowing for explicit dependency ordering.

How do I order agile story dependencies during feature splitting?

You order agile story dependencies during feature splitting by applying BSP-based ordering. This method captures dependencies between stories to guide implementation and ensure integration outcomes are preserved.

When do I need to split a feature spec into BDD stories?

You need to split a feature spec into BDD stories when you have large, unclear feature requirements that must be broken down into atomic, testable story specs expressed as Gherkin scenarios.

Can I use BSP ordering to manage dependencies between Gherkin stories?

Yes, you can use BSP-based ordering to capture and manage dependencies between Gherkin stories. This approach guides the implementation sequence while ensuring each story remains atomic and testable.