How do I handle decisions that have been changed later?

The skill utilizes an ADR lifecycle where new decisions can 'supersede' old ones, and outdated decisions are marked as 'deprecated' while remaining in the history for context.

What is an Architecture Decision Record (ADR)?

An ADR is a short document that captures a significant architectural decision, the context in which it was made, and the resulting consequences for the project's future.

When should I write an ADR instead of just a code comment?

Use an ADR for high-impact choices like choosing a database, adopting a new framework, or defining integration patterns. Code comments should explain 'how', while ADRs explain 'why' at a system level.

What formats does this skill support?

The skill supports multiple formats including MADR (Markdown Architecture Decision Records), lightweight summaries for smaller teams, and Y-statements for concise rationale capturing.

Can this skill help with RFCs?

Yes, it includes a template for RFC-style (Request for Comments) records, which are ideal for proposing major changes before a final decision is reached.

Architecture Decision Records (ADR) Manager

Name: Architecture Decision Records (ADR) Manager
Author: sla-te

bysla-te

0•

学习与文档

Document and manage significant technical decisions using standardized Architecture Decision Record (ADR) patterns and lifecycle management.

This skill empowers developers to capture the context, rationale, and consequences of critical architectural choices through a structured ADR workflow. It provides a comprehensive suite of templates—ranging from lightweight summaries to detailed RFC-style documents—ensuring that institutional knowledge is preserved and technical debt is minimized. By establishing a clear history of decision-making, the skill helps teams maintain a version-controlled repository of why specific technologies were chosen, how they were implemented, and when they were eventually superseded or deprecated.

主要功能

01Standardized ADR templates including MADR, Y-Statement, and Lightweight formats

02Guidelines for organizing ADR directories and automated indexing

03Structured framework for documenting decision drivers, trade-offs, and consequences

04Patterns for deprecation records and migration planning

050 GitHub stars

06Comprehensive lifecycle tracking from Proposed and Accepted to Deprecated and Superseded

使用场景

01Documenting the selection of core infrastructure like databases, languages, or frameworks

02Providing historical context for new team members during technical onboarding

03Recording the rationale behind major API design patterns or security architecture changes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sla-te/copilot-converter architecture-decision-records

For use in Claude.ai and ChatGPT

Download Skill