architecture-decision-records

Capture and manage architectural decisions with standardized ADR templates.

98|25|Updated Mar 14, 2020

Search Tags:#architecture #documentation #adr #governance #architecture-decision #decision-record

Ready to run

npx skills add https://github.com/baotoq/micro-commerce --skill architecture-decision-records-baotoq

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: architecture-decision-records
Source: https://github.com/baotoq/micro-commerce/tree/main/.agents/skills/architecture-decision-records
Command: npx skills add https://github.com/baotoq/micro-commerce --skill architecture-decision-records-baotoq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture teams often struggle to capture, justify, and reuse significant architectural decisions across projects, leading to knowledge loss and inconsistent designs.

Core Features & Use Cases

Standard ADR templates (MADR or lightweight) and lifecycle tracking to record context, options, decisions, and consequences.
Cross-referencing related ADRs and maintaining an auditable history to support onboarding and governance.
Review workflows and governance practices to ensure decisions are revisited and deprecated appropriately.

Quick Start

Create a new ADR by copying the template to docs/adr and filling in the context, decision, 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 document architectural decisions to ensure traceability across projects?▼

You can document architectural decisions using standardized ADR templates like MADR or lightweight formats to capture context, options, decisions, and consequences. This ensures traceability and prevents knowledge loss across multiple projects.

What is the best way to structure an architecture decision record for governance?▼

Structure architecture decision records for governance using standardized templates that track the decision lifecycle, apply formal review workflows, and maintain an auditable history to ensure decisions are revisited and deprecated appropriately.

Can I link related ADRs to maintain an audit trail of architectural changes?▼

Yes, you can cross-reference related ADRs to maintain an auditable history of architectural changes. Cross-referencing supports onboarding and governance by linking the context and consequences of interconnected decisions across projects.

How do I create a new ADR using the MADR template?▼

Create a new ADR by copying the MADR or lightweight template to your docs/adr directory. Fill in the context, decision, and consequences sections to standardize your architectural governance and record keeping.

Does this ADR skill support integration with existing architecture documentation tooling?▼

Yes, this skill supports integration with ADR tooling and index generation. This allows you to manage the formal review process and generate navigable indexes directly within your existing architecture documentation workflows.