architecture-decision-records

Create and manage Architecture Decision Records with structured ADR format.

2|Updated May 15, 2026

Search Tags:#project management #ADR #software documentation #design decisions #architecture decision records

Ready to run

npx skills add https://github.com/bdbch/ai-dotfiles --skill architecture-decision-records-bdbch

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: architecture-decision-records
Source: https://github.com/bdbch/ai-dotfiles/tree/main/skills/architecture-decision-records
Command: npx skills add https://github.com/bdbch/ai-dotfiles --skill architecture-decision-records-bdbch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the documentation of architecture decisions, ensuring clarity, traceability, and maintainability of design choices.

Core Features & Use Cases

Structured ADR Format: Follows the ADR (Architecture Decision Record) format for consistency and clarity.
Lifecycle Management: Tracks the status of decisions (Proposed, Accepted, Deprecated, Superseded).
Template Integration: Provides templates and guidelines for writing effective ADRs.
Use Case: Ideal for teams that need to capture and communicate architectural decisions, ensuring all members understand the rationale behind design choices.

Quick Start

Generate a new Architecture Decision Record for a database choice by running the command: adr create db-choice.

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 architecture decisions for a software project?▼

Document architecture decisions using structured Architecture Decision Records that capture context, alternatives, and rationale. This ensures clarity, traceability, and maintainability of design choices across the development team.

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

An Architecture Decision Record is a structured document used to capture software design decisions. Use it when architectural integrity is critical and teams need to communicate the rationale behind design choices effectively.

How do I track the lifecycle status of a design decision?▼

Track the lifecycle status of a design decision by assigning states like Proposed, Accepted, Deprecated, or Superseded within the Architecture Decision Record. This maintains clear traceability of architectural decisions over time.

Can I use templates to write architecture decision records?▼

Yes, you can use provided templates and guidelines to write effective Architecture Decision Records. These templates enforce the ADR format to ensure consistency, clarity, and proper capture of design rationale.

How do I create a new Architecture Decision Record for a database choice?▼

Create a new Architecture Decision Record for a database choice by running the command `adr create db-choice`. This generates a new entry following the structured ADR template for immediate documentation.

What is the best way to manage software documentation for architectural changes?▼

The best way to manage software documentation for architectural changes is using Architecture Decision Records. They provide a consistent format for capturing context, alternatives, and rationale, ensuring long-term architectural integrity.