claude-plugin-sdd

claude-plugin-design

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

Skills

Skill	Invoke	Description
ADR	/design:adr [description] [--review]	Create an ADR using MADR format with Mermaid diagrams
Spec	/design:spec [capability] [--review]	Create spec.md + design.md with RFC 2119 requirements and Mermaid diagrams
Init	/design:init	Set up CLAUDE.md with architecture context for design-aware sessions
Prime	/design:prime [topic]	Load ADR and spec context into the session, optionally filtered by topic
Check	/design:check [target]	Quick-check code against ADRs and specs for drift
Audit	/design:audit [scope] [--review] [--scrum]	Comprehensive drift audit; use --scrum for team-triaged findings grouped into prioritized remediation themes
Docs	/design:docs [project name]	Generate docs with scaffold/integration modes and manifest-based upgrades
List	/design:list [adr|spec|all]	List all ADRs and specs with their status
Discover	/design:discover [scope]	Discover implicit architecture from an existing codebase
Plan	/design: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	/design:organize [SPEC-XXXX or spec-name] [--project <name>] [--dry-run]	Retroactively group existing issues into tracker-native projects
Enrich	/design:enrich [SPEC-XXXX or spec-name] [--branch-prefix <prefix>] [--dry-run]	Add branch naming and PR conventions to existing issue bodies
Work	/design: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	/design:review [SPEC-XXXX or PR numbers] [--pairs N] [--no-merge] [--dry-run] [--module <name>]	Review and merge PRs using reviewer-responder agent pairs
Status	/design:status [ID] [status]	Change the status of an ADR or spec

Install

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

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

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

Configuration

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

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

### Design Plugin 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 /design:plan.

Parallel Agent Tuning

Two additional top-level keys control parallel agent behavior:

## Design Plugin Configuration

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

• Max parallel agents: Caps the number of concurrent worker agents in /design: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 /design:plan to serialize stories touching hot files).

Development

Clone the repo and run Claude Code from the project directory:

git clone https://github.com/joestump/claude-plugin-design.git
cd claude-plugin-design
claude