Can this skill handle deprecated decisions?

Yes, it specifically manages the ADR lifecycle, allowing you to mark old decisions as Deprecated or Superseded when new decisions replace them.

When should I write an ADR versus skipping it?

You should write an ADR for high-impact decisions like framework adoption, database choices, or security architecture. You can skip it for minor version upgrades, bug fixes, or routine implementation details.

What is an Architecture Decision Record (ADR)?

An ADR is a short text file that captures a significant architectural decision made in a project, including the context of the problem, the decision reached, and the resulting consequences.

Which ADR formats does this skill support?

This skill supports several industry-standard formats including MADR (Markdown Architecture Decision Records), Lightweight ADRs, the Y-Statement format, and RFC-style proposals.

How do ADRs help with team onboarding?

ADRs provide new team members with a 'decision log' that explains why specific technologies or patterns were chosen, preventing the loss of institutional knowledge and reducing time-to-productivity.

Architecture Decision Records (ADR)

Name: Architecture Decision Records (ADR)
Author: EricGrill

byEricGrill

•

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

Documents and manages significant technical decisions through structured Architecture Decision Records to maintain long-term architectural clarity.

This skill provides a comprehensive framework for capturing the 'why' behind critical technical choices. It helps engineering teams avoid recurring debates and knowledge silos by providing standardized templates for Architecture Decision Records (ADRs), including MADR and Y-Statement formats. By documenting context, decision drivers, and consequences, it ensures that every architectural choice is backed by clear rationale and trade-off analysis, facilitating smoother onboarding and more consistent system evolution.

主な機能

01Integrates with documentation management workflows and adr-tools

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

03Manages the full ADR lifecycle from Proposal to Deprecation or Supersession

04Identifies key decision drivers and conducts deep trade-off analysis

05Provides templates for Request for Comments (RFC) style architectural proposals

062 GitHub stars

ユースケース

01Recording design trade-offs during complex microservices migrations

02Establishing a historical record of technical decisions for team onboarding

03Documenting the selection of new frameworks, databases, or cloud infrastructure

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ericgrill/agents-skills-plugins architecture-decision-records

For use in Claude.ai and ChatGPT

Download Skill