When should I write an ADR instead of a regular document?

You should write an ADR for decisions that are difficult to reverse, such as choosing a database, adopting a new framework, or defining security protocols.

How does this skill help with team onboarding?

It creates a chronological 'decision log' that allows new team members to understand the historical context and rationale behind the current state of the codebase.

What formats does this skill support?

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

What is an Architecture Decision Record (ADR)?

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

Architecture Decision Records (ADR)

Name: Architecture Decision Records (ADR)
Author: drgaciw

bydrgaciw

0•

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

Standardizes the documentation of significant technical decisions by capturing context, rationale, and long-term consequences.

This skill provides a comprehensive framework for creating and managing Architecture Decision Records (ADRs), ensuring that the 'why' behind technical choices is preserved throughout a project's lifecycle. It offers a variety of specialized templates—ranging from the detailed MADR format to lightweight Y-statements—designed to document everything from framework adoption to technology deprecation. By using this skill, engineering teams can establish a transparent decision-making process that improves onboarding, facilitates architectural reviews, and maintains a clear audit trail of design trade-offs and their subsequent impacts.

主な機能

01Guidance for ADR management including directory structures and indexing

02Built-in review checklists to ensure documentation quality and stakeholder alignment

03Comparison frameworks for weighing pros, cons, and risks of technical options

04Standardized lifecycle management for proposed, accepted, and superseded decisions

050 GitHub stars

06Comprehensive templates for MADR, Lightweight, and Y-Statement formats

ユースケース

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

02Recording significant API design patterns or security architecture shifts

03Creating a searchable historical record of technical trade-offs for team onboarding

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add drgaciw/academic-compliance-hub-glm architecture-decision-records

For use in Claude.ai and ChatGPT

Download Skill