gsd-mvp-phase

Validate an As/I want/So-that user story and update ROADMAP.md for MVP-mode planning.

1|Updated Sep 6, 2015
One-click install
npx skills add https://github.com/deerawan/dotfiles --skill gsd-mvp-phase-deerawan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-mvp-phase
Source: https://github.com/deerawan/dotfiles/tree/main/claude/skills/gsd-mvp-phase
Command: npx skills add https://github.com/deerawan/dotfiles --skill gsd-mvp-phase-deerawan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you convert a vague phase idea into a clear, MVP-mode vertical slice plan, so you can reliably delegate to the planner-side workflow without guessing what to include.

Core Features & Use Cases

  • Structured user story capture: Prompts for an “As a / I want to / So that” user story using three structured questions to validate input shape.
  • SPIDR-based size splitting: Checks whether the story is too large and, if so, guides the user through Spike/Paths/Interfaces/Data/Rules to decide how to split across phases.
  • ROADMAP modernization + delegation: Writes the phase section with Mode: mvp and reformats Goal:, then delegates planning to /gsd plan-phase <N> using the roadmap as the source of truth.

Quick Start

Run gsd-mvp-phase for the phase number you already created in ROADMAP.md so it can validate your story, update the ROADMAP to MVP mode, and then kick off plan-phase for that phase.

Frequently Asked Questions about gsd-mvp-phase

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

FAQPage Schema
How do I plan an MVP phase as a vertical slice?

To plan an MVP phase as a vertical slice, you need a validated user story and a roadmap. This skill guides you through capturing the story, checking its size, and updating the roadmap to delegate planning.

How does SPIDR splitting work for user stories?

SPIDR splitting evaluates whether a user story is too large by checking Spikes, Paths, Interfaces, Data, and Rules. It helps you decide how to split an oversized story across multiple phases to constrain scope.

How do I validate an As/I want/So that user story for MVP planning?

Validating an As/I want/So that user story for MVP planning involves answering three structured questions to ensure the input shape is correct. This format is required before updating the roadmap for phase delegation.

When should I constrain phase scope during MVP planning?

You should constrain phase scope during MVP planning when a vertical slice is too large to implement efficiently. Applying SPIDR checks helps split the work across phases to maintain a manageable MVP scope.

Can I use MVP mode planning without an existing phase in the roadmap?

No, MVP mode planning requires an existing phase number in your ROADMAP.md. The workflow enforces phase existence and status guards before writing the MVP mode and delegating to the planner.

What is the best way to delegate a constrained MVP phase to a planner?

The best way to delegate a constrained MVP phase is to write Mode: mvp and a reformatted Goal to ROADMAP.md. This establishes the roadmap as the source of truth before kicking off the plan-phase workflow.