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.