zircote

git-adr

active
View on GitHub API Docs ADRs
Tech Stack:
PythonGit NotesCLIADR

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"