Skills
Creating Artifacts
Create a new Architecture Decision Record (ADR) using MADR format. Use when the user wants to document an architectural decision, says…
/sdd:adr [short description of the decision] [--review] [--module <name>]Create a specification with requirements, scenarios, and design rationale. Use when the user wants to write a spec, formalize requirements,…
/sdd:spec [capability name or ADR reference] [--review] [--module <name>]Sprint Planning
Break an existing spec into trackable issues in your issue tracker. Use when the user says "plan a sprint", "create issues from spec",…
/sdd:plan [spec-name or SPEC-XXXX] [--review] [--scrum] [--project <name>] [--no-projects] [--branch-prefix <prefix>] [--no-branches] [--module <name>]Retroactively group existing issues into tracker-native projects. Use when the user says "organize issues", "group issues into projects",…
/sdd:organize [SPEC-XXXX or spec-name] [--project <name>] [--dry-run] [--module <name>]Retroactively add branch naming and PR convention sections to existing issue bodies. Use when the user says "add branch names to issues",…
/sdd:enrich [SPEC-XXXX or spec-name] [--branch-prefix <prefix>] [--dry-run] [--module <name>]Implementation
Pick up tracker issues and implement them in parallel using git worktrees. Use when the user says "work on issues", "implement the spec",…
/sdd:work [SPEC-XXXX | issue numbers | (empty = propose from backlog)] [--max-agents N] [--draft] [--dry-run] [--no-tests] [--module <name>] [--loop [--max-iterations N] [--max-prs N] [--max-minutes N] [--max-dollars N] [--lock={skip|wait|force}] [--resume] [--budget-file PATH]] [--no-chain]Review and merge PRs produced by /sdd:work using reviewer-responder agent pairs. Use when the user says "review PRs", "review the spec…
/sdd:review [SPEC-XXXX or PR numbers] [--pairs N] [--no-merge] [--dry-run] [--module <name>] [--loop [--pr N] [--max-iterations N] [--max-prs N] [--max-minutes N] [--max-dollars N] [--lock={skip|wait|force}] [--resume] [--budget-file PATH]]Drift Detection
Quick-check code against ADRs and specs for drift. Use when the user says "check for drift", "does this match the spec", or wants a fast…
/sdd:check [target] [--module <name>]Comprehensive audit of design artifact alignment across the project. Use when the user says "audit the architecture", "full drift report",…
/sdd:audit [scope] [--review] [--scrum] [--module <name>]Discovery
Discover implicit architectural decisions and spec-worthy subsystems in an existing codebase. Use when the user says "discover…
/sdd:discover [scope] [--module <name>] [--with-graphs]Unified semantic exploration skill combining qmd hybrid retrieval with cgg call graph generation. Use when the user says "search the…
/sdd:search [query] [--output markdown|json] [--unfiltered] [--module <name>]Documentation
Generate a documentation site from your ADRs and specs. Use when the user says "generate docs", "create a docs site", or wants to publish…
/sdd:docs [project name or options] [--module <name>]Build and query the SDD artifact graph. Use when the user wants to validate frontmatter edges, find impact/ancestors/chain for an ADR or…
/sdd:graph <verb> [<artifact-id>] [--scope <subtree>] [--module <name>] [--table | --mermaid | --json]Index a repository's ADRs, OpenSpec specs, and source code into qmd collections for hybrid (BM25 + vector + reranker) semantic search. Use…
/sdd:index [add|update|embed|status|remove] [--module <name>] [--foreground|--skip] [--reprobe]Session Management
Set up CLAUDE.md with SDD plugin references for architecture-aware sessions. Use when the user installs the plugin, says "initialize sdd",…
/sdd:init [--module <name>]Load ADR and spec context into the session for architecture-aware responses. Use when the user says "prime context", "load architecture",…
/sdd:prime [topic] [--module <name>]Lifecycle Management
List all architecture decisions and specs with their status. Use when the user asks "what decisions have we made", "list ADRs", "show…
/sdd:list [filter: adr|spec|all] [--module <name>]Change the status of an ADR or spec (e.g., proposed to accepted, draft to review). Use when the user says "accept ADR", "approve the spec",…
/sdd:status [ADR-XXXX or SPEC-XXXX] [new status] [--module <name>] [--keep-refinement]File a feedback issue against the SDD plugin (joestump/claude-plugin-sdd) when an agent encounters significant friction with one of its…
/sdd:report-friction [skill-name] [--label bug|documentation|enhancement|usability] [--from-file <path>]