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

•

学習とドキュメンテーション

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.

主な機能

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

ユースケース

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

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add atournayre/claude-marketplace adr

For use in Claude.ai and ChatGPT

Download Skill