npm package: @david-xpn/sdd-pm
Description: A meta-prompting, context engineering and spec-driven development system for Claude Code, OpenCode and Gemini. Fork of sdd-pm-cc by TÂCHES.
Author: TÂCHES
Latest version: 0.1.5

# sdd-pm

A meta-prompting, context engineering and spec-driven development system for Claude Code, OpenCode, and Gemini CLI.

This is a personal fork of [sdd-pm](https://github.com/glittercowboy/sdd-pm) by [TÂCHES (Lex Christopherson)](https://github.com/glittercowboy), extended with Notion/Jira sync and other workflow additions.

## What It Does

SDD solves context rot — the quality degradation that happens as Claude fills its context window. It gives Claude everything it needs to do the work *and* verify it, through structured context engineering, multi-agent orchestration, and atomic git commits.

Behind the scenes: XML prompt formatting, subagent orchestration, state management. What you see: a few `/sdd-pm:*` commands that just work.

## Install

```bash
npx @david-xpn/sdd-pm@latest
```

The installer prompts you to choose a runtime (Claude Code, OpenCode, Gemini) and location (global or local).

Verify with `/sdd-pm:help` inside your chosen runtime.

## Core Workflow

```
/sdd-pm:new-project          # Questions -> research -> requirements -> roadmap
/sdd-pm:discuss-phase 1      # Capture implementation decisions (optional)
/sdd-pm:plan-phase 1         # Research + plan + verify + auto-advance
/sdd-pm:verify-work 1        # Manual user acceptance testing
/sdd-pm:complete-milestone   # Archive milestone, tag release
/sdd-pm:new-milestone        # Start next version
```

## Commands

| Command | What it does |
|---------|--------------|
| `/sdd-pm:new-project` | Full initialization: questions, research, requirements, roadmap |
| `/sdd-pm:discuss-phase [N]` | Capture implementation decisions before planning |
| `/sdd-pm:plan-phase [N]` | Research + plan + verify + auto-complete + auto-advance |
| `/sdd-pm:verify-work [N]` | Manual user acceptance testing |
| `/sdd-pm:audit-milestone` | Verify milestone achieved its definition of done |
| `/sdd-pm:complete-milestone` | Archive milestone, tag release |
| `/sdd-pm:new-milestone` | Start next version |
| `/sdd-pm:progress` | Where am I? What's next? |
| `/sdd-pm:map-codebase` | Analyze existing codebase before new-project |
| `/sdd-pm:add-phase` | Append phase to roadmap |
| `/sdd-pm:insert-phase [N]` | Insert urgent work between phases |
| `/sdd-pm:remove-phase [N]` | Remove future phase, renumber |
| `/sdd-pm:pause-work` | Create handoff when stopping mid-phase |
| `/sdd-pm:resume-work` | Restore from last session |
| `/sdd-pm:settings` | Configure model profile and workflow agents |
| `/sdd-pm:debug [desc]` | Systematic debugging with persistent state |
| `/sdd-pm:help` | Show all commands |

## How It Works

### Context Engineering

| File | Purpose |
|------|---------|
| `PROJECT.md` | Project vision, always loaded |
| `research/` | Ecosystem knowledge |
| `REQUIREMENTS.md` | Scoped v1/v2 requirements with phase traceability |
| `ROADMAP.md` | Where you're going, what's done |
| `STATE.md` | Decisions, blockers, position across sessions |
| `PLAN.md` | Atomic task with XML structure, verification steps |
| `SUMMARY.md` | What happened, what changed, committed to history |

### Multi-Agent Orchestration

Every stage uses a thin orchestrator that spawns specialized agents, collects results, and routes to the next step. Your main context window stays at 30-40% while the heavy work happens in fresh subagent contexts.

### Atomic Git Commits

Each task gets its own commit immediately after completion — traceable, independently revertable, and meaningful for `git bisect`.

## Configuration

Settings live in `.planning/config.json`. Configure during `/sdd-pm:new-project` or update with `/sdd-pm:settings`.

### Model Profiles

| Profile | Planning | Execution | Verification |
|---------|----------|-----------|--------------|
| `quality` | Opus | Opus | Sonnet |
| `balanced` (default) | Opus | Sonnet | Sonnet |
| `budget` | Sonnet | Sonnet | Haiku |

Switch with `/sdd-pm:set-profile budget`.

## Fork Changes

This fork adds:
- Notion two-way sync (`/sdd-pm:sync-notion`)
- Jira import (`/sdd-pm:sync-jira`)
- External spec ingestion from Notion/Jira
- Various workflow refinements

## Credits

Originally created by [TÂCHES (Lex Christopherson)](https://github.com/glittercowboy) as [sdd-pm](https://github.com/glittercowboy/sdd-pm).

## License

MIT License. See [LICENSE](LICENSE) for details.