shai-story-decomposition

Decompose product features into user stories with 2-3 BDD scenarios saved as .story.md files.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/kirillshilin/instructions --skill shai-story-decomposition
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shai-story-decomposition
Source: https://github.com/kirillshilin/instructions/tree/main/src/shai-product/skills/shai-story-decomposition
Command: npx skills add https://github.com/kirillshilin/instructions --skill shai-story-decomposition

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Decomposes product features into actionable user stories with clear, testable acceptance criteria, enabling faster sprint planning and more reliable delivery.

Core Features & Use Cases

  • Decomposes each feature into individual stories with a concise statement and 2-3 BDD scenarios.
  • Supports creation of {brief-name}.story.md files under docs/stories/ ready for the next stage.
  • Provides a repeatable workflow linking feature-mapping, story writing, and task breakdown.

Quick Start

Input a feature description or feature map and generate individual story files with 2–3 BDD scenarios, saved as {brief-name}.story.md under docs/stories.

Frequently Asked Questions about shai-story-decomposition

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

FAQPage Schema
How do I break down product features into actionable user stories with BDD scenarios?▼

To break down features into actionable user stories, decompose each feature into individual stories with 2-3 BDD acceptance criteria. This ensures clear, testable requirements that enable faster sprint planning and reliable delivery.

What is the best way to write user stories with acceptance criteria for sprint planning?▼

The best way to write user stories for sprint planning is generating individual story files with concise statements and 2-3 BDD scenarios. This structured approach provides clear, testable acceptance criteria for reliable development.

Can I use a standalone feature description to generate user stories, or do I need a feature map?▼

You can use a standalone feature description to generate user stories. The decomposition process applies to both standalone feature descriptions and outputs from a feature-mapping workflow, creating individual story files with BDD acceptance criteria.

How do I save user stories as markdown files with YAML frontmatter for task breakdown?▼

To save user stories for task breakdown workflows, generate each story as a {brief-name}.story.md file under the docs/stories directory. These files include YAML frontmatter for loading into the task breakdown workflow.

How many acceptance criteria should each user story have when decomposing features?▼

Each user story should have 2-3 acceptance criteria when decomposing features. These are structured as BDD scenarios to ensure the stories are testable and ready for implementation in the next development sprint.

Does this story decomposition approach work with feature-mapping and task breakdown workflows?▼

Yes, this story decomposition approach provides a repeatable workflow linking feature-mapping, story writing, and task breakdown. It generates story files with YAML frontmatter designed specifically for loading into downstream task breakdown workflows.