How does this skill help Claude generate better code?

By maintaining ADRs in a structured format, Claude can reference your project's established architectural patterns and constraints to ensure generated code remains compliant with past decisions.

Can I modify an ADR once it is accepted?

ADRs are intended to be immutable historical records. If a decision changes, the practice is to create a new ADR that explicitly supersedes the previous one.

An Architecture Decision Record (ADR) is a lightweight document that captures an important architectural decision, the context in which it was made, and its resulting consequences.

Where are the ADR files stored in my repository?

The skill typically stores records in directories like 'ai-docs/decisions/' or 'docs/adr/' to ensure they are version-controlled alongside your source code.

ADR Documentation

Name: ADR Documentation
Author: MadAppGang

byMadAppGang

•

230

•

Learning & Documentation

Standardizes the creation of Architecture Decision Records to document technical trade-offs and long-term design rationale.

The ADR Documentation skill streamlines the process of capturing critical architectural decisions within your codebase. By providing a standardized framework for documenting technical context, considered alternatives, and long-term consequences, it ensures that institutional knowledge is preserved and easily accessible to both Claude and human developers. This skill helps teams maintain a clear history of the rationale behind their system design, facilitating smoother developer onboarding and preventing the re-evaluation of settled technical debates through immutable decision logs.

Key Features

01Lifecycle management for tracking proposed, accepted, and superseded decisions

02Standardized ADR templates featuring context, status, and consequences

03Automated sequential numbering and standardized file naming conventions

04230 GitHub stars

05Cross-referencing capabilities to link related architectural choices

06AI-optimized documentation structure for better Claude context integration

Use Cases

01Recording the rationale and trade-offs of breaking API changes

02Creating a searchable history of system evolution for new team members

03Documenting the selection of a primary database or framework

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add madappgang/claude-code adr-documentation

For use in Claude.ai and ChatGPT

Download Skill