skills.rest
DucCuong159
DucCuong159COMMUNITY
Explore all skills by this author →
GitHub

architecture-decision-records

Create and manage Architecture Decision Records documenting technical decisions and trade-offs.

Updated Aug 11, 2026
Search Tags:#documentation#adr#technical design#architecture decisions#decision records#madr#adr-tools
One-click install
npx skills add https://github.com/DucCuong159/Realtime-chatapp --skill architecture-decision-records-duccuong159
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision-records
Source: https://github.com/DucCuong159/Realtime-chatapp/tree/main/.agent/skills/architecture-decision-records
Command: npx skills add https://github.com/DucCuong159/Realtime-chatapp --skill architecture-decision-records-duccuong159

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams lose track of why significant technical decisions were made, making it hard to onboard new members, review past choices, or avoid repeating mistakes. This Skill provides structured templates and workflows for capturing the context, options, and consequences of architectural decisions. ## Core Features & Use Cases - Multiple ADR Templates: Includes MADR standard format, lightweight ADR, Y-Statement, deprecation, and RFC-style templates for different decision types. - Lifecycle Management: Covers ADR statuses (Proposed, Accepted, Deprecated, Superseded, Rejected), directory structure, index maintenance, and adr-tools automation commands. - Review Process: Provides checklists for pre-submission, review, and post-acceptance steps to ensure decisions are properly vetted. - Use Case: When choosing between PostgreSQL and MongoDB for a new service, use this Skill to write an ADR documenting decision drivers, considered options with pros and cons, the final rationale, and consequences for future maintainers. ## Quick Start Write an architecture decision record for adopting Redis as our caching layer, including the context, considered alternatives, and consequences.

Frequently Asked Questions about architecture-decision-records

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write an architecture decision record?▼

An ADR documents the context requiring a decision, the options considered with pros and cons, the final decision with rationale, and the consequences. Use the MADR template for significant decisions or the lightweight template for smaller choices, then store it in a docs/adr directory.

When should I write an ADR versus skipping it?▼

Write an ADR for significant decisions like framework adoption, database technology choices, API design patterns, and security architecture. Skip ADRs for minor version upgrades, bug fixes, routine maintenance, and small implementation details.

What is the difference between MADR and Y-Statement ADR formats?▼

MADR is a full template with sections for context, decision drivers, considered options, and consequences. Y-Statement is a single-sentence format capturing context, decision, alternatives, and accepted trade-offs, suited for quick documentation.

How do I deprecate or supersede an existing ADR?▼

Never modify an accepted ADR. Instead, write a new ADR that references and supersedes the old one, update the old ADR's status to Deprecated or Superseded, and link both records. The adr-tools command 'adr new -s N' automates superseding.

What tools automate ADR management?▼

adr-tools is a command-line utility that initializes ADR directories, creates numbered records, supersedes existing ADRs, links related decisions, and generates a table of contents. Install it via Homebrew with 'brew install adr-tools'.

Related Skills

Explore More Software Engineering Skills→
Negentropy-LabyNegentropy-Laby
3

architecture-decision

Document architectural decisions with context, constraints, and trade-offs.

Official
Advanced
CarlosQ96CarlosQ96

architecture-decision

Generates Architecture Decision Records with rationale, trade-offs, and outcomes from user input.

Community
Advanced
snuffomegasnuffomega

architecture-decision-records

Document technical decisions with context, options, trade-offs, and consequences.

Community
Intermediate
HeyItsGilbertHeyItsGilbert
1

rfc

Draft and manage structured RFCs with lifecycle states and ADR cross-linking.

Community
Advanced