How adr/madr works
MADR is a Markdown format and set of templates for writing and maintaining Architectural Decision Records (ADRs). The main workflow is to choose a template, copy it into a project’s decisions directory, and adapt it for each decision; this repository also provides examples and guidance, and its docs are rendered with Jekyll. The graph reflects documented copying and rendering workflows; source excerpts do not show a software runtime or internal call structure.
Main entry points: decisions Decision Archive · adr-template.md Full Template · adr-template-minimal.md Minimal Template · adr-template-bare.md Bare Template
Components 11
ADR Templates
- Full Template
template/adr-template.md - Minimal Template
template/adr-template-minimal.md - Bare Template
template/adr-template-bare.md - Bare Minimal Template
template/adr-template-bare-minimal.md
Decision Records
- Decision Archive
docs/decisions - Published ADR Template
docs/decisions/adr-template.md
Guidance and Site
- Examples
docs/examples.md - Tooling Guide
docs/tooling.md - Documentation Home
docs/index.md
Other components
- ADR Author
- Jekyll Renderer
Connections 14
- ADR Author → Full Template: selects
- ADR Author → Minimal Template: selects
- ADR Author → Bare Template: selects
- ADR Author → Bare Minimal Template: selects
- ADR Author → Decision Archive: copies and adapts
- Full Template → Decision Archive: copied into
- Minimal Template → Decision Archive: copied into
- Bare Template → Decision Archive: copied into
- Bare Minimal Template → Decision Archive: copied into
- Full Template → Published ADR Template: mirrored as
- Jekyll Renderer → Documentation Home: renders docs
- Jekyll Renderer → Examples: renders docs
- Jekyll Renderer → Tooling Guide: renders docs
- Jekyll Renderer → Decision Archive: renders docs