adr-skills
adr-skills is an MCP server for Claude Code that automatically captures development conversations and uses Claude Opus to generate, review, and manage Architecture Decision Records (ADRs).
TL;DR: Install once, and every Claude Code session ends with a structured ADR saved to
~/.adr-mcp/adrs/— no manual writing required.
What problem does this solve?
Engineering teams make dozens of architectural decisions every week — which database to use, how to handle auth, whether to go monolith or microservices — but rarely write them down. Months later, nobody remembers why Redis was chosen over Memcached, or why the team avoided GraphQL.
adr-skills solves this by turning your existing Claude Code conversations into permanent, searchable ADR documents automatically.
How it works
- You have a normal development conversation in Claude Code
- When the session ends, the Stop Hook captures the transcript
- Claude Opus analyzes the conversation and extracts the architectural decision
- A structured markdown ADR is saved to
~/.adr-mcp/adrs/ADR-0001-*.md - Use
review_adrto score quality,link_adrsto map dependencies,check_stale_adrsto surface outdated decisions
