skills.rest
mvandermeulen
mvandermeulenCOMMUNITY
Explore all skills by this author →
GitHub

architecture-decision-records

Standardize creation and maintenance of Architecture Decision Records with predefined templates.

2|1|Updated Sep 16, 2024
Search Tags:#architecture#documentation#adr#engineering#best-practices#decision-making
One-click install
npx skills add https://github.com/mvandermeulen/nvim --skill architecture-decision-records-mvandermeulen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision-records
Source: https://github.com/mvandermeulen/nvim/tree/main/.claude/skills/architecture-decision-records
Command: npx skills add https://github.com/mvandermeulen/nvim --skill architecture-decision-records-mvandermeulen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the lack of historical context and rationale behind significant technical choices, preventing knowledge silos and ensuring team alignment on architectural direction.

Core Features & Use Cases

  • Structured Documentation: Provides standardized templates (MADR, Lightweight, Y-Statement) for capturing context, decisions, and consequences.
  • Lifecycle Management: Tracks the evolution of decisions from proposal through acceptance, deprecation, or supersession.
  • Use Case: When a team needs to decide between two database technologies, this skill provides the framework to document the trade-offs, ensuring future developers understand why a specific path was chosen.

Quick Start

Use the architecture-decision-records skill to generate a new ADR template for the proposed microservices migration.

Frequently Asked Questions about architecture-decision-records

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

FAQPage Schema
How do I document architectural decisions and technical rationale for engineering teams?▼

To document architectural decisions effectively, use Architecture Decision Records to capture technical rationale, design trade-offs, and system patterns. This standardizes record-keeping through predefined templates, preventing knowledge silos and ensuring team alignment on architectural evolution.

What templates are available for creating architecture decision records?▼

Available architecture decision record templates include MADR, Lightweight, and Y-Statement formats. These templates provide structured formats for consistently capturing context, decisions, and consequences for your engineering team's technology choices.

How does lifecycle management work for architecture decision records?▼

Architecture decision record lifecycle management tracks the evolution of decisions from proposal through acceptance, deprecation, or supersession. This ensures historical context is maintained as system design patterns and architectural direction shift over time.

When do I need to use architecture decision records for software engineering?▼

You need architecture decision records when your team makes significant technical choices, such as deciding between database technologies or planning a microservices migration. They document trade-offs so future developers understand why a specific architectural path was chosen.

What is the best way to standardize technical decision documentation across an engineering team?▼

The best way to standardize technical decision documentation is by applying predefined ADR templates and a structured lifecycle management process. This framework eliminates knowledge silos and enforces consistent record-keeping for all architectural evolution.

Related Skills

Explore More Software Engineering Skills→
jtvarisjtvaris

architecture-decision

Generate Architecture Decision Records with context, constraints, and alternatives.

Community
Intermediate
shirulotshirulot

architecture-decision-records

Create and maintain Architecture Decision Records with structured templates.

Community
Intermediate
abhishekdutta18abhishekdutta18

ai-first-engineering

Establish best practices and review protocols for AI-assisted coding workflows.

Community
Advanced
GeargrindadminGeargrindadmin

architecture

Analyze architectural trade-offs and document decisions with ADR templates.

Community
Intermediate