adr-generator

Solid

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.

AI & Automation 33 stars 6 forks Updated today MIT

Install

View on GitHub

Quality Score: 79/100

Stars 20%
51
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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...

Details

Author
rjmurillo
Repository
rjmurillo/ai-agents
Created
5 months ago
Last Updated
today
Language
Markdown
License
MIT

Integrates with

Related Skills