sdd:adr

Files (1)

• SKILL.md

SKILL.md (first lines)

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}..."`.
```

From alfredoperez/sdd, MIT.

More from alfredoperez/sdd