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

学習とドキュメンテーション

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.

主な機能

Comprehensive capturing of trade-offs, risks, and implementation consequences
Support for multiple ADR formats including MADR, Lightweight, and Y-Statement
Automated ADR index generation and directory structure management
Lifecycle management guidance for linking and superseding related decisions
Systematic tracking of decision status (Proposed, Accepted, Superseded, Deprecated)
0 GitHub stars

ユースケース

Documenting high-stakes technology choices like framework or database selection
Recording the rationale for complex API design patterns or security architectures
Managing 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

Download Skill

GitHub

概要