creating-adrs

# ADR Creator

## 6-Phase Process

| Phase         | Actions                                                                  |
| ------------- | ------------------------------------------------------------------------ |
| 1. Pre-Check  | Run `./scripts/pre-check.sh "$TITLE"` (uses shared scripts)              |
| 2. Template   | Run `$HOME/.claude/scripts/select-adr-template.sh "$TITLE"`              |
| 3. References | Gather project docs, issues, external resources                          |
| 4. Validate   | Check required sections (Title, Status, Context, Decision, Consequences) |
| 5. Index      | Auto-generate `adr/README.md`                                            |
| 6. Recovery   | Handle missing dirs, duplicates, missing sections                        |

## Template Selection

Use script to auto-select template:

```bash
TEMPLATE=$("$HOME/.claude/scripts/select-adr-template.sh" "$TITLE")
```

| Template             | Use Case                   | Required Sections          |
| -------------------- | -------------------------- | -------------------------- |
| technology-selection | Library, framework choices | Options (min 3), Pros/Cons |
| architecture-pattern | Structure, design policy   | Context, Consequences      |
| process-change       | Workflow, rule changes     | Before/After comparison    |
| deprecation          | Retiring technology        | Migration plan, Timeline   |

## Directory Structure

```text
adr/
├── README.md          # Auto-generated index
├── 0001-*.md         # Sequential numbering
└── 0002-*.md
```

## References

| Topic     | Resource                      |
| --------- | ----------------------------- |
| MADR      | <https://adr.github.io/madr/> |
| Command   | `../../commands/adr.md`       |
| Templates | `../../templates/adr/`        |
| Scripts   | `./scripts/`                  |