skills.rest
baotoq
baotoqCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/baotoq/micro-commerce --skill architecture-decision-records-baotoq
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
oaustegardoaustegard
137

versioning-skills

Initialize Git repositories and commit changes for skill directories.

Community
Basic
mwguerramwguerra
35

taskmanager

Convert PRD content into a hierarchical tasks.json task graph.

Community
Advanced
tja688tja688

grill-with-docs

Cross-reference project plans against CONTEXT.md and ADR files.

Community
Advanced
ev3rlitev3rlit

architecture-decision-records

Manage architecture decision records with standardized templates and lifecycle statuses.

Community
Advanced