# adr/madr

Markdown Architectural Decision Records

Repository: https://github.com/adr/madr
Canonical: https://ross.abutalabs.com/products/madr
Homepage: https://adr.github.io/madr/
Language: Markdown
License: NOASSERTION
License Family: other
Topics: architectural-decisions, architectural-decision-records, documentation, design-document, design-documents, hacktoberfest
Last push: 2026-08-24T22:32:59+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 8, longevity 100
- inputs: {"age_days": 3333, "days_push": 9, "days_rel": 715, "gap_med": null, "n_releases_24m": 1}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2423, forks 466 (observed 2026-08-28T04:06:50.497611+00:00)

## What it is
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
- artifact type: learning-resource
- maturity: active
- function: documentation, markdown
- domain: documentation, developer-tools, web-development
- platform: cross-platform
- tags: adr, architecture-decisions, template, markdown

## Member repositories
- adr/madr (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:50.497611+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:31:52.627478+00:00, confidence not recorded.
  - readme: https://github.com/adr/madr (fetched 2026-08-28T04:06:50.497611+00:00, sha 6cd4dfba95ba)
  - homepage: https://adr.github.io/madr/ (fetched 2026-08-29T10:13:08.834313+00:00, sha 2f404d52c5b9)
- Data as of 2026-08-30T08:39:29.467469+00:00.