Structured MADR
active Tech Stack:
YAMLJSON SchemaADRSpecification
Structured MADR extends Markdown Architectural Decision Records with machine-readable YAML frontmatter, making ADRs queryable, validatable, and trackable by both humans and automated tooling.
What It Adds
Standard MADR gives you readable decision documents. Structured MADR adds:
- YAML frontmatter with typed fields for status, date, deciders, and relationships
- JSON Schema for validation in CI pipelines
- Compliance tracking across repositories
- Tool integration through a well-defined schema
Why It Matters
ADRs rot when they live as plain markdown nobody checks. Structured frontmatter lets you build linters, dashboards, and compliance gates that keep decisions current and enforceable.
Specification
The full specification is published at smadr.dev.