An Architecture Decision Record (ADR) is a document that captures a significant architectural decision, including the context in which it was made and the consequences it has for the project's future.

Where are these records stored?

ADRs are typically stored as Markdown files directly in your repository (e.g., in a .framework-blueprints/decisions/ folder), ensuring they are version-controlled alongside your code.

Can I change a decision after it is accepted?

Yes. The skill follows an ADR lifecycle where an old decision can be marked as SUPERSEDED or DEPRECATED when a new ADR is created to replace it, preserving the historical trail.

Why should I use this skill with Claude Code?

This skill enables Claude to guide you through a structured decision-making process, helping you evaluate alternatives and document trade-offs that are often lost in chat history or verbal meetings.

When is it appropriate to write an ADR?

You should write an ADR for significant choices like choosing a database, adopting a new framework, or making a breaking API change, rather than for trivial coding tasks.

Architecture Decision Records (ADRs)

Name: Architecture Decision Records (ADRs)
Author: Ankurjain1121

byAnkurjain1121

0•

Learning & Documentation

Documents technical choices, technology comparisons, and architectural rationale using standardized ADR templates to maintain a clear project history.

This skill empowers developers to capture the 'why' behind their technical architecture by formalizing the decision-making process within their workflow. It provides structured templates for Architecture Decision Records (ADRs) that include context, alternatives considered, pros and cons, and long-term consequences. By maintaining an immutable log of decisions, teams can onboard new members faster, avoid recurring debates on settled topics, and ensure that every major framework or infrastructure choice is backed by sound reasoning and documented trade-offs.

Key Features

01Side-by-side technology comparisons with pros, cons, and documentation references

020 GitHub stars

03Lifecycle management for proposed, accepted, deprecated, or superseded decisions

04Structured numbering scheme for categorized decision tracking (e.g., Security, Data, Operations)

05Standardized ADR templates featuring context, rationale, and consequences

06Integration with development phases from discovery to implementation planning

Use Cases

01Selecting a primary database or frontend framework for a new software project

02Recording security protocol choices and compliance rationale for future auditing

03Documenting the shift from a monolithic to a microservices architecture

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ankurjain1121/dev-workflow-skills architecture-decision-records

For use in Claude.ai and ChatGPT

Download Skill