adr-generatorlisted
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