sdd-state-management

Track SDD change set state and phase gates across Full, Vibe, and Bug lanes.

4|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/shanepadgett/agent-extensions --skill sdd-state-management
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-state-management
Source: https://github.com/shanepadgett/agent-extensions/tree/main/skills/sdd-state-management
Command: npx skills add https://github.com/shanepadgett/agent-extensions --skill sdd-state-management

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides structured governance for SDD change sets by tracking state, lanes, and gates throughout the lifecycle, ensuring visibility and accountability.

Core Features & Use Cases

  • Lane-based workflow governance: Full, Vibe, and Bug lanes coordinate ideation through finish to support consistent delivery.
  • Central state file: state is stored at changes/<name>/state.md with fields Lane, Phase, Phase Status, Pending, and Notes to capture decisions and progress.
  • Phase-gate discipline: defines transitions (ideation → proposal → specs → discovery → tasks → plan → implement → reconcile → finish) and guides completion checks.
  • Thoughts directory (optional): optional workspace for deep investigations that preserve context for future work.

Quick Start

Create a new changes/sdd-state-management/state.md and begin updating Lane, Phase, Phase Status, and Notes as work progresses.

Frequently Asked Questions about sdd-state-management

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

FAQPage Schema
How do I track SDD change set state and phase gates?

Track SDD state by creating a state.md file at changes/<name>/state.md, updating Lane, Phase, Phase Status, and Notes fields to enforce transitions and maintain visibility across the software development lifecycle.

What is the phase-gate transition sequence in SDD workflows?

SDD phase gates follow the sequence: ideation → proposal → specs → discovery → tasks → plan → implement → reconcile → finish, guiding completion checks and coordinating progress across development lanes.

Can I use SDD state management for bug fixes and vibe coding?

Yes, SDD state management supports Full, Vibe, and Bug lanes, allowing software development teams to coordinate ideation through finish across different work types while maintaining consistent phase-gate governance.

What's the best way to preserve context during deep software investigations?

Use the optional Thoughts directory within your SDD change set to preserve context for future work, storing deep investigation notes alongside the central state.md tracking file.

How do I start tracking state for a new software development change set?

Create a new changes/<name>/state.md file and begin updating the Lane, Phase, Phase Status, and Notes fields as work progresses through the defined phase gates from ideation to finish.