architecture-decision-records

Create standardized Architecture Decision Records with lifecycle guidance and an index.

Updated Jan 26, 2026

Search Tags:#architecture #templates #documentation #adr #governance #traceability

Ready to run

npx skills add https://github.com/erikhoward/agent-rules --skill architecture-decision-records-erikhoward

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: architecture-decision-records
Source: https://github.com/erikhoward/agent-rules/tree/main/claude/skills/architecture-decision-records
Command: npx skills add https://github.com/erikhoward/agent-rules --skill architecture-decision-records-erikhoward

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture Decision Records capture the context, decision, and consequences of significant technical choices to improve traceability and future maintenance.

Core Features & Use Cases

Standardized ADR templates to document decisions consistently across teams.
Lifecycle guidance from proposed to superseded, with references to related ADRs.
Governance and onboarding support by providing a central repository and discoverable index.

Quick Start

Create a new ADR document for a notable architectural decision using the MADR-style template.

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 for better traceability?▼

Document architectural decisions by capturing context, decisions, and consequences as Architecture Decision Records. This standardizes technical choices into consistent records, improving future maintenance and traceability across teams.

What is an Architecture Decision Record and when should I use one?▼

An Architecture Decision Record captures the context, decision, and consequences of significant technical choices. Apply ADRs when documenting notable architecture decisions, reviewing past choices, or establishing governance for future changes.

How do I create a new ADR using a standardized template?▼

Create a new ADR document for your architectural decision using the MADR-style template. This enforces a consistent structure across teams, providing lifecycle guidance from proposed to superseded with references to related records.

How do I manage the lifecycle of an Architecture Decision Record?▼

Manage ADR lifecycles using built-in guidance that tracks status from proposed to superseded. The system links related records through references, maintaining a discoverable index for governance and onboarding review.

Does this ADR template work for team governance and onboarding?▼

Yes, ADRs support governance and onboarding by providing a central repository with a discoverable index. New team members can review past architectural decisions and their consequences to understand technical context quickly.

What is the best way to structure architecture documentation for technical choices?▼

The best way to structure architecture documentation is using standardized ADR templates that enforce consistent formatting. This approach captures context, decisions, and consequences while maintaining an accessible index for discovery.