Skip to main content
Code Guide
Agent

adr-writer.md

Architecture Decision Record generator: read-only, Opus

When to use this

  • After making a significant architectural decision that future devs need to understand
  • When your team wants a lightweight, git-based ADR process without heavyweight tooling
  • Before refactoring something established so the original reasoning is captured

How to use

  1. Open the template on GitHub and copy its content: agents/adr-writer.md
  2. Place the file inside .claude/agents/ in your project (or globally in ~/.claude/ to share across all projects).
  3. Edit the Markdown content to match your project conventions, team constraints, and specific context.

Related templates