decompose-requirements

Decompose feature requirements into phased task files with Gherkin scenarios.

2|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/yutna/vibe-next-template --skill decompose-requirements
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decompose-requirements
Source: https://github.com/yutna/vibe-next-template/tree/main/.claude/skills/decompose-requirements
Command: npx skills add https://github.com/yutna/vibe-next-template --skill decompose-requirements

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Decompose large requirements or feature requests into manageable, task-sized pieces that fit AI context windows, enabling predictable planning and traceable delivery.

Core Features & Use Cases

  • Gherkin-first decomposition: Convert requirements into stateful scenarios organized by transitions.
  • State machine coverage: Visualize and validate all possible states and transitions to prevent gaps.
  • End-to-end mapping: Provide output structures for downstream E2E test and implementation tasks.
  • Stepwise decomposition: Produce phase-based task files aligned to project milestones.

Quick Start

Provide a feature request or requirements document and let the skill generate phased tasks and Gherkin scenarios.

Frequently Asked Questions about decompose-requirements

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

FAQPage Schema
How do I break down complex feature requirements into manageable phased tasks?

You break down complex feature requirements by feeding a feature request or requirements document into a state machine and Gherkin scenario generator. This produces phased task files that map directly to E2E scenarios and project milestones for predictable, traceable delivery.

What is Gherkin-first decomposition for software requirements?

Gherkin-first decomposition is a planning approach that converts requirements into stateful scenarios organized by transitions. It enforces pattern matching, state machine definition, and Gherkin scenario generation to prevent coverage gaps in complex feature delivery.

How does state machine definition help validate feature requirements?

State machine definition validates feature requirements by visualizing and enforcing all possible states and transitions. This prevents gaps in complex feature planning and ensures the decomposed tasks cover every scenario mapped to the E2E testing output.

Can I use requirements decomposition to map tasks directly to E2E test scenarios?

Yes, requirements decomposition maps tasks directly to E2E test scenarios. The process enforces an end-to-end mapping step that provides output structures specifically designed for downstream E2E test and implementation tasks.

What's the best way to split large requirements documents for AI context windows?

The best way to split large requirements documents for AI context windows is phased, stepwise decomposition. Breaking requirements into task-sized pieces organized by state transitions and Gherkin scenarios enables predictable planning and traceable delivery within context limits.

Do I need Gherkin scenarios to decompose requirements into phased tasks?

Yes, Gherkin scenarios are needed to decompose requirements into phased tasks. The decomposition process enforces steps spanning pattern matching, state machine definition, and Gherkin scenario generation to yield a scalable, traceable plan.