Show HN: ADRs for AI – Deliberation records for human–AI work, versioned in Git

Category: devtools

Tags: adr, ai-collaboration, documentation, claude-code, mcp, methodology

Score: 6.3/10 (Innovation: 6, Technical: 5, Documentation: 8, Utility: 6)

This project is a documentation methodology and template system for recording architectural deliberation records (ADRs) in human-AI collaboration workflows, primarily focused on Claude Code sessions. It packages templates, navigation codes, a Claude Code plugin, an MCP server, and a CLI to make AI-assisted decision-making persistent and grep-able in Git.

Target audience: backend devs, AI engineers, technical leads using Claude Code

Repository: https://adrs.systems · Python · Apache-2.0 · 19 stars

View on Hacker News