What is an Architecture Decision Record (ADR)?

An ADR is a short document that captures a significant architectural decision, the context in which it was made, the options considered, and the resulting trade-offs.

Where does Claude store the created ADRs?

The records are stored as Markdown files directly in your repository, usually within a dedicated 'adr/' folder, ensuring they are version-controlled alongside your code.

How does this skill help with team communication?

It provides a standardized format and process for recording decisions, ensuring all team members—and future hires—understand the reasoning behind technical choices.

Can I modify an ADR once it has been accepted?

ADRs are intended to be append-only historical records. If a decision changes, the skill helps you create a new ADR that marks the previous one as 'Superseded'.

Architect ADR Creator

Name: Architect ADR Creator
Author: rayk

byrayk

•

Learning & Documentation

Generate standardized Architecture Decision Records (ADRs) to document technical choices, trade-offs, and historical rationale.

This skill automates the creation and maintenance of Architecture Decision Records (ADRs) following standardized conventions. It guides users through capturing the context, drivers, and trade-offs of architectural choices, ensuring a transparent history of technical decisions is preserved. By enforcing a standardized template and an append-only lifecycle, it helps development teams understand the 'why' behind their codebase, facilitating easier onboarding, improved knowledge sharing, and more informed future refactoring.

Key Features

01Explicit trade-off analysis for multiple architectural options

02Automated indexing and linking within project architecture documentation

03Automatic sequential numbering and file naming conventions

041 GitHub stars

05Standardized ADR template generation following industry best practices

06Decision lifecycle management (Proposed, Accepted, Superseded)

Use Cases

01Recording the rationale and trade-offs for a major architectural shift or refactoring

02Maintaining a historical log of superseded technical decisions for future maintainers

03Documenting the choice of a specific database, framework, or cloud provider

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rayk/lucid-toolkit create-adr

For use in Claude.ai and ChatGPT

Download Skill