sdd

claude-plugin-sdd

A Claude Code plugin for architecture governance: ADRs, specifications, sprint planning, parallel implementation, code review, and documentation generation.

Skills

Skill	Invoke	Description
ADR	/sdd:adr [description] [--review]	Create an ADR using MADR format with Mermaid diagrams
Spec	/sdd:spec [capability] [--review]	Create spec.md + design.md with RFC 2119 requirements and Mermaid diagrams
Init	/sdd:init	Set up CLAUDE.md with architecture context for design-aware sessions
Prime	/sdd:prime [topic]	Load ADR and spec context into the session, optionally filtered by topic
Check	/sdd:check [target]	Quick-check code against ADRs and specs for drift
Audit	/sdd:audit [scope] [--review] [--scrum]	Comprehensive drift audit; use --scrum for team-triaged findings grouped into prioritized remediation themes
Docs	/sdd:docs [project name]	Generate docs with scaffold/integration modes and manifest-based upgrades
List	/sdd:list [adr|spec|all]	List all ADRs and specs with their status
Discover	/sdd:discover [scope]	Discover implicit architecture from an existing codebase
Plan	/sdd:plan [spec-name or SPEC-XXXX] [--scrum] [--review] [--project <name>] [--no-projects] [--branch-prefix <prefix>] [--no-branches]	Break a spec into trackable issues; use --scrum for a full team-groomed ceremony with spec audit, multi-agent grooming, and automatic organize + enrich
Organize	/sdd:organize [SPEC-XXXX or spec-name] [--project <name>] [--dry-run]	Retroactively group existing issues into tracker-native projects
Enrich	/sdd:enrich [SPEC-XXXX or spec-name] [--branch-prefix <prefix>] [--dry-run]	Add branch naming and PR conventions to existing issue bodies
Work	/sdd:work [SPEC-XXXX | issue numbers | (empty = propose from backlog)] [--max-agents N] [--draft] [--dry-run] [--no-tests] [--module <name>]	Pick up tracker issues and implement them in parallel using git worktrees
Review	/sdd:review [SPEC-XXXX or PR numbers] [--pairs N] [--no-merge] [--dry-run] [--module <name>]	Review and merge PRs using reviewer-responder agent pairs
Status	/sdd:status [ID] [status]	Change the status of an ADR or spec
Graph	/sdd:graph <verb> [<artifact-id>] [--scope <subtree>] [--module <name>] [--table|--mermaid|--json]	Build and query the artifact graph: validate, impact, ancestors, chain, orphans, cycles, backfill. ASCII DAG default; --json is the stable contract for downstream consumers

Install

Add to your project's .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "claude-plugin-sdd": {
      "source": {
        "source": "github",
        "repo": "joestump/claude-plugin-sdd"
      }
    }
  },
  "enabledPlugins": {
    "sdd@claude-plugin-sdd": true
  }
}

Then restart Claude Code. The plugin's 16 skills will be available as /sdd:init, /sdd:prime, /sdd:adr, /sdd:spec, /sdd:plan, /sdd:organize, /sdd:enrich, /sdd:work, /sdd:review, /sdd:check, /sdd:audit, /sdd:discover, /sdd:docs, /sdd:list, /sdd:status, and /sdd:graph.

Configuration

All configuration lives in your project's CLAUDE.md under a ### SDD Configuration section. No separate JSON config files are needed -- skills read and write configuration as markdown, keeping everything in one place.

Run /sdd:init to set up the initial configuration, or add it manually:

### SDD Configuration

#### Tracker
- **Type**: github
- **Owner**: your-org
- **Repo**: your-project

#### Branch Conventions
- **Enabled**: true
- **Prefix**: feature
- **Epic Prefix**: epic
- **Slug Max Length**: 50

#### PR Conventions
- **Enabled**: true
- **Close Keyword**: Closes
- **Ref Keyword**: Part of
- **Include Spec Reference**: true

#### Worktrees
- **Base Dir**: .claude/worktrees/
- **Max Agents**: 4
- **Auto Cleanup**: false
- **PR Mode**: ready

#### Review
- **Max Pairs**: 2
- **Merge Strategy**: squash
- **Auto Cleanup**: false

#### Projects
- **Default Mode**: per-epic
- **Views**: All Work, Board, Roadmap
- **Columns**: Todo, In Progress, In Review, Done
- **Iteration Weeks**: 2

All sections and keys are optional. Missing keys use sensible defaults. The tracker preference is saved automatically when you first use /sdd:plan.

Parallel Agent Tuning

Two additional top-level keys control parallel agent behavior:

## SDD Configuration

- **Max parallel agents**: 4
- **Hotspot threshold**: 50%

• Max parallel agents: Caps the number of concurrent worker agents in /sdd:work (CLI flag --max-agents overrides).
• Hotspot threshold: Percentage of recent PRs a file must appear in to be classified as a merge-conflict hotspot (used by /sdd:plan to serialize stories touching hot files).