Skip to content
ADR Plugin

ADR Plugin

Complete lifecycle management for Architectural Decision Records. Create, review, update, supersede, and export ADRs with multi-format support and compliance auditing.
Get Started View on GitHub

Multi-Format Support

Seven ADR formats including MADR, Nygard, Y-Statement, Alexandrian, Business Case, Tyree-Akerman, and Structured MADR.

Full Lifecycle

Create, list, update, supersede, search, and export ADRs. Complete lifecycle management from proposal to deprecation.

Compliance Auditing

Audit code changes against accepted ADRs. Detect violations and ensure architectural decisions are followed.

Research Assistant

Research context, options, and best practices for architectural decisions. Analyze codebases and search the web.

Quick Start

Section titled “Quick Start”
Terminal window
# Install the plugin
claude install gh:zircote/adr


# Set up ADR configuration
/adr:setup


# Create your first ADR
/adr:new

What is ADR Plugin?

Section titled “What is ADR Plugin?”

ADR Plugin is a Claude Code plugin for managing Architectural Decision Records. It provides commands, agents, and skills that cover the full ADR lifecycle — from research and authoring through compliance verification and export.

Key capabilities:

  • 7 commands — Setup, create, list, update, supersede, search, and export ADRs
  • 3 agents — Author (detects decisions), Compliance (audits code), Researcher (gathers context)
  • 12 skills — Fundamentals, formats, quality review, compliance, decision drivers, and integration
  • 10 reference docs — Decision criteria, review checklists, examples, templates, and patterns