adr/madr resource
Markdown Architectural Decision Records observed · 2026-08-28
Health v2 · maintenance only
67/100
- Activity 99
- Release rhythm 8
- Longevity 100
Flags: no_license
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.
- gap_med: n/a
- age_days: 3333
- days_rel: 715
- days_push: 9
- n_releases_24m: 1
Adoption not part of the score
2423 stars · 466 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded
MADR is a set of Markdown templates for writing Architectural Decision Records (ADRs) in a lean, structured format. It provides full, minimal, and bare template variants plus documentation on applying ADRs to projects.
Use cases
- document architectural decisions in markdown
- set up an ADR process for my team
- find a lightweight ADR template
- record design decisions with rationale
- standardize decision records across projects
When to choose
- you want a simple, tool-agnostic Markdown format for ADRs
- you need both detailed and minimal template variants
- you want a widely adopted, community-maintained ADR template
When to avoid
- you need full ADR tooling like scaffolding CLI or linting built in
- you require a non-Markdown or database-backed decision log
Facets
learning-resource · maturity active
documentation markdown documentation developer-tools web-development cross-platform adr architecture-decisions template markdown
2 sources
- readme: https://github.com/adr/madr · fetched 2026-08-28 · 6cd4dfba95ba
- homepage: https://adr.github.io/madr/ · fetched 2026-08-29 · 2f404d52c5b9
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| adr/madr | main | 67 |
For agents
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem