Which ADR templates are supported by this skill?

The skill supports several industry-standard formats including MADR (Markdown Architectural Decision Records), Lightweight formats for small teams, Y-Statements, and RFC-style templates.

Is this skill compatible with existing CLI tools?

Yes, it follows standard directory structures and naming conventions (like NNNN-title.md) compatible with popular utilities such as adr-tools.

An Architecture Decision Record (ADR) is a document that captures a significant architectural decision, including its context, rationale, and the resulting consequences for the project.

How does this skill handle superseded decisions?

It follows a specific lifecycle workflow that allows you to mark older records as Superseded or Deprecated while automatically linking them to the new decision records.

Why should I use this skill with Claude Code?

It helps Claude generate structured, professional documentation for your decisions, ensuring no critical trade-offs or rationales are forgotten during the development process.

Architecture Decision Records (ADRs)

Name: Architecture Decision Records (ADRs)
Author: nguyendinhquocx

bynguyendinhquocx

0•

Aprendizaje y Documentación

Standardizes the documentation of significant technical decisions and their rationales using industry-proven ADR templates.

This skill empowers developers to capture the 'why' behind their technical choices, ensuring long-term architectural clarity and smoother team onboarding. By providing multiple templates—from lightweight Y-statements to comprehensive MADR formats—it guides Claude in documenting decision drivers, considered options, and downstream consequences. Whether you're selecting a new database or deprecating legacy services, this skill helps maintain a searchable, version-controlled history of your project's evolution, preventing architectural amnesia and facilitating better peer reviews.

Características Principales

01Comprehensive capturing of trade-offs, risks, and implementation consequences

02Support for multiple ADR formats including MADR, Lightweight, and Y-Statement

03Automated ADR index generation and directory structure management

04Lifecycle management guidance for linking and superseding related decisions

05Systematic tracking of decision status (Proposed, Accepted, Superseded, Deprecated)

060 GitHub stars

Casos de Uso

01Documenting high-stakes technology choices like framework or database selection

02Recording the rationale for complex API design patterns or security architectures

03Managing the deprecation of legacy components and their migration paths

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nguyendinhquocx/code-ai architecture-decision-records

For use in Claude.ai and ChatGPT

Características Principales

01Comprehensive capturing of trade-offs, risks, and implementation consequences

02Support for multiple ADR formats including MADR, Lightweight, and Y-Statement

03Automated ADR index generation and directory structure management

04Lifecycle management guidance for linking and superseding related decisions

05Systematic tracking of decision status (Proposed, Accepted, Superseded, Deprecated)

060 GitHub stars

Casos de Uso

01Documenting high-stakes technology choices like framework or database selection

02Recording the rationale for complex API design patterns or security architectures

03Managing the deprecation of legacy components and their migration paths

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nguyendinhquocx/code-ai architecture-decision-records

For use in Claude.ai and ChatGPT