sdd-adr

name	sdd:adr
description	SDD — Spec-Driven Development: scaffold a new Architectural Decision Record.

Usage: /sdd:adr <slug> — <slug> is kebab-case, descriptive (e.g., cache-strategy, auth-provider-choice).

Steps

1. Validate inputs

Require $ARGUMENTS (the slug). If empty, stop: Usage: /sdd:adr <slug>.

Slug rules: 2–4 words, kebab-case. If invalid, suggest a corrected version.

2. Determine ADR number

Scan .sdd/decisions/*.md. Find the highest existing 4-digit prefix. New ADR number is highest + 1, zero-padded to 4 digits (e.g., 0001, 0002, ..., 0042).

If .sdd/decisions/ doesn't exist, prompt: Run /sdd:init first. and stop.

3. Create file

Write .sdd/decisions/{NNNN}-{slug}.md from lib/templates/adr.md, substituting:

• {NNNN} → 4-digit number from Step 2
• {Title} → ask user via AskUserQuestion for a one-line title (or derive Title Case from slug if user accepts)
• {TODAY} → current date (YYYY-MM-DD)
• {deciders} → git config user.name (default), user can override

4. Summary

✓ ADR {NNNN} drafted

📂 .sdd/decisions/{NNNN}-{slug}.md

Status: Proposed
Title: {Title}

Edit the file to fill Context, Decision, Rationale, Alternatives, and Consequences sections.
Commit when ready: `git add .sdd/decisions/{NNNN}-{slug}.md && git commit -m "docs(adr): add ADR {NNNN}..."`.