adr

Initialize, create, supersede, list, search, and view ADR documents.

Updated Apr 28, 2026
One-click install
npx skills add https://github.com/suwandre/my-codex-config --skill adr-suwandre
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/suwandre/my-codex-config/tree/main/skills/adr
Command: npx skills add https://github.com/suwandre/my-codex-config --skill adr-suwandre

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture Decision Records (ADR) provide a formal, auditable trail of architectural choices, helping teams maintain context and rationale as systems evolve.

Core Features & Use Cases

  • Initialize ADR directory structure and templates
  • Create new ADRs with structured fields (Title, Status, Context, Decision, Consequences)
  • Supersede, list, search, and view ADRs across the project
  • Reuse ADR templates to ensure consistent documentation

Quick Start

Create a new ADR with a concise title describing the architectural decision.

Frequently Asked Questions about adr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document architectural decisions to preserve context and rationale?

You can initialize an ADR directory structure and create new records using predefined templates. These templates ensure consistent documentation of structured fields like Context, Decision, and Consequences across the project.

How do I manage superseded or outdated architecture decisions?

You can list, search, and view existing ADRs across the project to track their status. This workflow supports supersession, allowing you to link outdated records to new decisions and maintain an auditable history.

When do I need to start tracking architecture decisions for my project?

You should start tracking architectural decisions when formalizing structural choices for projects of varying sizes. Initializing an ADR directory establishes a centralized, auditable repository to preserve context and governance.

Can I reuse templates for consistent architecture decision documentation?

Yes, ADR templates support consistent documentation by standardizing structured fields like Title, Status, Context, Decision, and Consequences. Reusing templates ensures reliable formatting and contributes to governance practices.