Markdown Template

ADR Template

A ready-to-use Architecture Decision Record template in Markdown format. Copy and customize for your projects.

Download Your Free ADR Template

Get started with documenting architectural decisions using this comprehensive template.

Download Template

Template Preview

# ADR [Number]: [Title]

## Status
[Proposed | Accepted | Deprecated | Superseded]

## Context
What is the issue that we're seeing that is motivating this decision or change?

## Decision
What is the change that we're proposing and/or doing?

## Consequences
What becomes easier or more difficult to do because of this change?

### Positive
- Benefit 1
- Benefit 2

### Negative
- Trade-off 1
- Trade-off 2

### Risks
- Risk 1
- Risk 2

## Alternatives Considered
What other options did we evaluate?

### Alternative 1
- Description
- Why not chosen

### Alternative 2
- Description
- Why not chosen

What's Included

  • Complete ADR structure
  • Markdown format
  • Ready to customize
  • Git-friendly format

How to Use

  • 1 Download the template
  • 2 Save in your project's /docs folder
  • 3 Number your ADRs sequentially
  • 4 Fill in each section as you make decisions
  • 5 Commit to version control

Need Help Getting Started?

Not sure how to introduce ADRs to your team or how to use them effectively? Book a free discovery call and I'll help you get started with best practices.

Book Free Consultation