adr

Create, list, and supersede immutable architectural decision records.

3|Updated May 13, 2025
One-click install
npx skills add https://github.com/wcygan/anton --skill adr-wcygan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/wcygan/anton/tree/main/.claude/skills/adr
Command: npx skills add https://github.com/wcygan/anton --skill adr-wcygan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Architectural decisions need to be recorded in a durable, auditable place so teams can understand why choices were made and how they relate to the system over time.

Core Features & Use Cases

  • Create new ADRs with a standard frontmatter and structured body.
  • List and filter ADRs by status, affects category, or decider.
  • Supersede old decisions while preserving history and enabling traceability.

Quick Start

Write an ADR that captures a new architectural decision and then list current ADRs to see its placement.

Frequently Asked Questions about adr

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

FAQPage Schema
How do I record architectural decisions so my team can trace why choices were made?

You record architectural decisions as immutable ADR files with standard frontmatter for status, date, affects, and deciders. This preserves historical context and creates an auditable trace of why choices were made over time.

What is the best way to supersede outdated architectural decisions without losing history?

Superseding outdated architectural decisions is handled by linking old ADRs to new ones while preserving the original immutable files. This enables full traceability and prevents edits to settled decisions, ensuring historical context is never lost.

How do I list and filter existing architecture decision records by status or category?

You list and filter existing architecture decision records by status, affects category, or decider. This allows teams to quickly query and view current ADRs stored under the context/adrs/ directory.

Can I edit an architectural decision record after it has been settled and finalized?

Settled architectural decision records cannot be edited because the ADR body enforces immutability. Instead of modifying a settled decision, you create a new ADR and supersede the outdated one to maintain a clear audit trail.

What schema does an architecture decision record need for governance and traceability?

An architecture decision record requires a standard frontmatter schema enforcing status, date, affects, and deciders. This structured metadata ensures proper governance and enables accurate filtering of decisions across the system.