Structured MADR v1.0.0

Structured MADR v1.0.0

Machine-Readable Architectural Decision Records for the AI Era

Highlights

• YAML Frontmatter: Machine-parseable metadata for tooling integration
• Hierarchical Decision Drivers: Primary and secondary drivers for clear prioritization
• Risk Assessment: Technical, schedule, and ecosystem risk ratings per option
• Split Consequences: Positive, negative, and neutral outcomes
• Audit Section: Built-in compliance tracking with findings tables

What's Included

• SPECIFICATION.md - Formal RFC-style specification
• schemas/structured-madr.schema.json - JSON Schema for validation
• templates/template.md - Full template with guidance
• templates/template-bare.md - Minimal template for experienced users
• examples/ - Real-world example ADRs

Documentation

• Specification
• Contributing Guide

License

MIT License