skills.rest
ArogyaReddy
ArogyaReddyCOMMUNITY
Explore all skills by this author →
GitHub

architecture-decision-records

Document architectural decisions with standardized templates and metadata.

Updated Apr 19, 2026
Search Tags:#architecture#templates#documentation#adr#governance#workflows
One-click install
npx skills add https://github.com/ArogyaReddy/https-github.com-wshobson-agents --skill architecture-decision-records-arogyareddy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision-records
Source: https://github.com/ArogyaReddy/https-github.com-wshobson-agents/tree/main/plugins/documentation-generation/skills/architecture-decision-records
Command: npx skills add https://github.com/ArogyaReddy/https-github.com-wshobson-agents --skill architecture-decision-records-arogyareddy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture decisions accumulate and drift without a standardized method to capture context, rationale, and future implications. This ADR skill provides a repeatable framework to document significant technical decisions, ensuring consistency, traceability, and onboarding across teams.

Core Features & Use Cases

  • Templates: Standard ADR formats (Standard ADR, Lightweight ADR, Y-Statement, RFC) for varied decision contexts.
  • Lifecycle & Index: Maintains status, dates, and links in an accessible ADR index for quick discovery.
  • Automation & Guidelines: Supports adr-tools-based workflows for creation, linking, and toc generation; includes review and governance guidance.

Quick Start

Create a new ADR using the standard template and complete 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 consistently across multiple projects?▼

Architecture decision records provide a repeatable framework to capture context, rationale, and future implications for significant technical decisions. This skill supplies standard templates, lifecycle stages, and an indexable history to prevent decisions from drifting over time.

What templates are available for writing architecture decision records?▼

Standard ADR, Lightweight ADR, Y-Statement, and RFC templates are available for varied decision contexts. Each template pairs with a YAML metadata schema capturing name and description to maintain an indexable history.

How do I manage the ADR lifecycle and maintain an indexable history of decisions?▼

You manage the ADR lifecycle by tracking status, dates, and links within an accessible ADR index for quick discovery. The skill supports adr-tools workflows for creation, linking, and table of contents generation to maintain history.

Does this ADR skill work with adr-tools for creating and linking records?▼

Yes, the skill supports adr-tools-based workflows for creation, linking, and toc generation. It also includes review and governance guidance to maintain architecture decision records across projects.

What is the best way to structure architectural governance and review workflows for ADRs?▼

The best way to structure architectural governance is to apply the skill's review and maintenance guidance alongside adr-tools workflows. This standardizes creation, tracks lifecycle stages, and links decisions within an accessible index.

Related Skills

Explore More Software Engineering Skills→
productengineeredproductengineered

v2-schema-reference

Define v2.0 schema fields and constraints for epics, stories, and tasks.

Community
Intermediate
gaiastudio-aigaiastudio-ai
2

gaia-index-docs

Indexes Markdown, XML, YAML, and CSV files in a folder into a linked table of contents in index.md.

Official
Intermediate
ccfccf

architecture-decision-records

Document architectural decisions with a MADR-style template and lifecycle.

Community
Advanced
bugrabilgebugrabilge
10

architecture-decision-records

Create and manage Architecture Decision Records using multiple templates.

Community
Intermediate