zircote/adr

3 stars · Last commit 2026-06-03

Claude Code plugin for complete ADR lifecycle management with multi-format support (MADR, Nygard, Y-Statement), compliance auditing, and configurable workflows

README preview

# ADR Plugin

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Claude Code Plugin](https://img.shields.io/badge/Claude_Code-Plugin-blueviolet)](https://github.com/anthropics/claude-code)
[![CI](https://github.com/zircote/adr/actions/workflows/ci.yml/badge.svg)](https://github.com/zircote/adr/actions/workflows/ci.yml)
[![Version](https://img.shields.io/badge/version-0.2.0-green.svg)](https://github.com/zircote/adr/releases)

Complete lifecycle management for Architectural Decision Records (ADRs): create, update, supersede, search, audit compliance, and export.

## Features

- **Multi-Format Support** - MADR, Structured MADR, Nygard, Y-Statement, Alexandrian, Business Case, Tyree-Akerman
- **Full Lifecycle Management** - Create, update, supersede, deprecate, archive
- **Compliance Auditing** - Proactive checks of code against accepted ADRs
- **Research Assistant** - Codebase analysis and web research for decision context
- **Proactive ADR Detection** - Agent suggests capturing architectural discussions
- **Git Integration** - Track changes, auto-commit, blame history
- **Export Options** - HTML, JSON, PDF for documentation and sharing
- **Configurable Workflow** - Custom statuses, numbering, templates
- **Multi-Directory Support** - Project-level and module-level ADRs

View full repository on GitHub →