← ClaudeAtlas

decisionlisted

Record an architecture decision as an ADR. Use when making significant technology choices, pattern adoptions, or convention changes.
ajyadav013/claude-kit · ★ 12 · AI & Automation · score 75
Install: claude install-skill ajyadav013/claude-kit
Record an architecture decision as an ADR. The user will describe the decision as: $ARGUMENTS ## Steps 1. **Read the ADR index**: Read `docs/architecture/decisions/README.md` to find the next available number (look at the last row in the Index table, increment by 1). 2. **Read the template**: Read the [ADR template](adr-template.md) for the output structure. 3. **Generate the slug**: Convert the title argument to a slug (e.g., "Temporal over Celery" → "temporal-over-celery"). Lowercase, hyphens, no special characters. 4. **Gather context**: Based on the decision topic, explore the codebase to understand: - What exists today (current state) - What alternatives were considered or could be considered - What the trade-offs are 5. **Write the ADR**: Create `docs/architecture/decisions/NNNN-{slug}.md` following the template. Fill in: - **Status**: `Proposed` for new decisions (the team must accept it) - **Date**: today's date - **Context**: the problem or force that motivates the decision - **Decision**: what is being decided - **Alternatives Considered**: at least 2 alternatives with pros/cons - **Consequences**: at least 1 positive, 1 negative, and optionally neutral 6. **Update the index**: Add a new row to the Index table in `docs/architecture/decisions/README.md`. 7. **Commit**: Stage both files and commit with message: `adr: add NNNN — {Title}` 8. **Summarize**: Tell the user: - The ADR number and file path - A brief summary of what w