zircote

git-adr

active
View on GitHub
Tech Stack:
Python Git Notes CLI ADR

git-adr manages Architecture Decision Records (ADRs) using git notes—no files cluttering your repository, no merge conflicts, with AI-powered drafting support.

Features

  • No Files — ADRs stored in git notes, not in your working tree
  • No Conflicts — Git notes avoid merge conflicts with normal development
  • AI Drafting — Claude-powered ADR generation from natural language
  • CLI Interface — Full-featured command-line tool
  • CI Integration — Pre-push hooks and GitHub Actions templates

Usage

# Create a new ADR
git adr new "Use PostgreSQL for persistence"

# List all ADRs
git adr list

# Search ADRs
git adr search "database"

# AI-assisted drafting
git adr draft "We need to choose a message queue"