story-to-plan

Convert INVEST stories into vertical slice plans with governance context.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/juan-estrada-itti/way-of-work-tools --skill story-to-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-to-plan
Source: https://github.com/juan-estrada-itti/way-of-work-tools/tree/main/skills/story-to-plan
Command: npx skills add https://github.com/juan-estrada-itti/way-of-work-tools --skill story-to-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert INVEST stories into actionable execution plans by loading governance context (ADRs, api-contract, CLAUDE.md) and turning the story into a structured vertical slice plan with explicit consume/produce declarations.

Core Features & Use Cases

  • Loads governance context (ADRs, api-contract, CLAUDE.md) to ensure plans align with architectural constraints.
  • Decomposes a story into vertical slices (DB/BE/FE/Tests) with explicit consume/produce namespaces.
  • Outputs a standard plan file plan-H<N>.md ready for the task-dependency-analyzer to build the DAG and execute the plan.

Quick Start

Provide an INVEST story and trigger the story-to-plan skill to generate the executable plan at docs/06-plans/plan-H<N>.md.

Frequently Asked Questions about story-to-plan

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

FAQPage Schema
How do I convert an INVEST story into an executable vertical plan?

Converting an INVEST story into an executable vertical plan involves loading governance context such as ADRs, API contracts, and CLAUDE.md. The story is then decomposed into vertical slices (DB/BE/FE/Tests) with explicit consume and produce declarations to create a standard plan file.

How does story decomposition handle architectural governance and API contracts?

Story decomposition handles architectural governance by loading ADRs, API contracts, and CLAUDE.md to ensure generated plans align with existing constraints. This governance context dictates the structure of the vertical slices and their stable namespace declarations.

Can I generate vertical slice plans for both greenfield and brownfield stories?

Yes, you can generate vertical slice plans for both greenfield and brownfield stories. The approach decomposes stories into vertical slices across DB, BE, FE, and Tests while applying the loaded governance context to fit the specific project environment.

What is the standard output file format for vertical slice planning?

The standard output file format for vertical slice planning is a markdown file named plan-H<N>.md. This file is generated in the docs/06-plans/ directory and contains the structured vertical slices ready for dependency analysis.

Do I need a task-dependency-analyzer to execute the generated plan file?

Yes, the generated plan-H<N>.md file is designed to be consumed by a task-dependency-analyzer. The analyzer uses the file's structured vertical slices and consume/produce declarations to build a DAG and execute the plan.

What are the limitations of using vertical slices with stable namespaces for story planning?

A limitation of using vertical slices with stable namespaces is that it requires pre-existing governance context like ADRs and API contracts to function correctly. Without these governance files, the generated plan may not align with your project's architectural constraints.