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

•

개발자 도구

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.

주요 기능

Explicit trade-off analysis for multiple architectural options
Automated indexing and linking within project architecture documentation
Automatic sequential numbering and file naming conventions
1 GitHub stars
Standardized ADR template generation following industry best practices
Decision lifecycle management (Proposed, Accepted, Superseded)

사용 사례

Recording the rationale and trade-offs for a major architectural shift or refactoring
Maintaining a historical log of superseded technical decisions for future maintainers
Documenting the choice of a specific database, framework, or cloud provider

소개

주요 기능

Explicit trade-off analysis for multiple architectural options
Automated indexing and linking within project architecture documentation
Automatic sequential numbering and file naming conventions
1 GitHub stars
Standardized ADR template generation following industry best practices
Decision lifecycle management (Proposed, Accepted, Superseded)

사용 사례

Recording the rationale and trade-offs for a major architectural shift or refactoring
Maintaining a historical log of superseded technical decisions for future maintainers
Documenting the choice of a specific database, framework, or cloud provider