Guide
Everything from the project's README, one section per page — in reading order.
- What is an architecture decision record?
- How to start using ADRs
- How to start using ADRs with tools
- How to start using ADRs with git
- Claude Code skills for ADRs
- File name conventions for ADRs
- Suggestions for writing good ADRs
- ADR example templates
- Teamwork advice for ADRs
- Teamwork questions for ADRs
- Next step concepts for ADRs
- Architecture diagrams & views & viewpoints
- Fitness functions for decisions as code
- Decision guardrails for pull requests
- For more information