Why use this skill instead of writing ADRs manually?

It ensures structural consistency, automates boring tasks like numbering, and uses AI to summarize context and consequences that you might otherwise overlook.

Where are the ADR files saved?

By default, the skill creates and manages ADR files within the docs/adr/ directory of your repository to keep documentation close to the code.

How does this skill determine the next ADR number?

The skill automatically analyzes the existing files in your docs/adr/ directory to identify the current sequence and increments it for the new record.

An Architecture Decision Record (ADR) is a short document that captures a significant architectural decision, including its context, the reasoning behind it, and its long-term consequences.

Architecture Decision Record (ADR) Generator

Name: Architecture Decision Record (ADR) Generator
Author: atournayre

byatournayre

•

Aprendizaje y Documentación

Generates structured Architecture Decision Records (ADRs) to document and track critical software architecture decisions.

The ADR skill empowers Claude Code to create and maintain professional Architecture Decision Records using a standardized RFC format. By analyzing your existing codebase and documentation, it automatically manages sequential numbering, integrates relevant project context, and ensures every decision includes a clear justification, consequence analysis, and list of alternatives. This skill is essential for maintaining a clear technical history and ensuring architectural alignment across development teams.

Características Principales

01Automatic sequential numbering by scanning existing docs

02Automatic directory management within docs/adr/

038 GitHub stars

04Standardized RFC-based ADR template generation

05Context-aware analysis of project-specific constraints

06Structured sections for status, consequences, and alternatives

Casos de Uso

01Recording trade-offs made during critical architectural pivots

02Justifying the adoption of specific design patterns like DDD

03Documenting the migration to a new framework or database

Architecture Decision Record (ADR) Generator

byatournayre

•

Aprendizaje y Documentación

Generates structured Architecture Decision Records (ADRs) to document and track critical software architecture decisions.

Características Principales

01Automatic sequential numbering by scanning existing docs

02Automatic directory management within docs/adr/

038 GitHub stars

04Standardized RFC-based ADR template generation

05Context-aware analysis of project-specific constraints

06Structured sections for status, consequences, and alternatives

Casos de Uso

01Recording trade-offs made during critical architectural pivots

02Justifying the adoption of specific design patterns like DDD

03Documenting the migration to a new framework or database