← ClaudeAtlas

adr-generatorlisted

Create comprehensive Architectural Decision Records (ADRs). Researches the destination directory to detect existing template conventions, gathers context, determines next ADR number, generates the ADR, validates completeness, and saves. Supports multiple ADR formats (MADR, Nygard, Alexandrian, project canonical). Use when documenting technical decisions or creating new ADR files. Use when you say "write an ADR", "document this decision". Do NOT use to debate or review an existing ADR (use adr-review).
rjmurillo/ai-agents · ★ 34 · AI & Automation · score 79
Install: claude install-skill rjmurillo/ai-agents
# ADR Generator Create well-structured Architectural Decision Records that document technical decisions with clear context, rationale, consequences, and alternatives. ## Triggers | Trigger Phrase | Operation | |----------------|-----------| | `create an ADR` | Full ADR generation workflow | | `generate ADR` | Full ADR generation workflow | | `write an architecture decision record` | Full ADR generation workflow | | `new ADR for` | Targeted ADR for a specific decision | | `document this architecture decision` | Full ADR generation workflow | --- ## Quick Start ```text # These all work: create an ADR for database selection new ADR for authentication strategy document this architecture decision about event sourcing generate ADR for switching from REST to gRPC ``` --- ## When to Use | Situation | Use This Skill? | |-----------|----------------| | New architectural decision needs documenting | Yes | | Changing an existing system or pattern | Yes (includes Prior Art Investigation) | | Reviewing or validating an existing ADR | No, use `adr-review` skill | | Minor implementation detail, not architectural | No | --- ## Process ### Phase G1: Gather Collect required information from the user: - **Decision Title**: Clear, concise name - **Context**: Problem statement, technical constraints, business requirements - **Decision**: Chosen solution with rationale - **Alternatives**: Options considered (at least 2) and rejection reasons - **Stakeholders**: People or teams involve