v1.2.0 - Configurable Body Structure

Configurable Body Structure

The validator now supports fully configurable body structure via the schema.body key, making it adaptable to custom ADR formats while maintaining structured-madr defaults.

Highlights

• Configurable Sections — Define required sections, optional sections, subsections, title patterns, and option heading requirements directly in the JSON schema's body key
• Backward Compatible — Falls back to structured-madr defaults when no body key is present
• Code Block Awareness — Fixes false-positive heading detection inside fenced code blocks
• CITATION.cff — Added academic citation metadata

Dependency Updates

Package	From	To
astro	5.17.2	6.1.3
@astrojs/starlight	0.37.6	0.38.2
eslint	9.39.2	10.2.0
ajv	8.17.1	8.18.0
glob	11.1.0	13.0.6
yaml	2.8.2	2.8.3

CI Updates

• actions/checkout v4 -> v6
• actions/setup-node v4 -> v6
• actions/upload-artifact v6 -> v7
• actions/download-artifact v6 -> v8.0.1
• actions/deploy-pages v4 -> v5
• withastro/action v5 -> v6

Full Changelog

v1.1.0...v1.2.0

v1.1.0 - GitHub Action Validator

GitHub Action Now Available on Marketplace

Validate your Structured MADR architectural decision records in CI/CD pipelines with a single workflow line.

Installation

- uses: zircote/structured-madr@v1
  with:
    path: docs/decisions

Highlights

• Shareable GitHub Action - Validate ADRs in any repository's CI/CD pipeline
• Comprehensive Validation - YAML frontmatter schema + body structure validation
• PR Annotations - See validation errors directly in pull request diffs
• Configurable - Adjust paths, patterns, strictness, and failure behavior

Features

Feature	Description
Frontmatter Validation	JSON Schema validation using ajv
Section Ordering	Validates all 12 required sections in correct order
Option Analysis	Checks for Advantages/Disadvantages/Risk Assessment
Audit Section	Ensures compliance tracking entries exist
GitHub Annotations	Inline errors and warnings in PR reviews

Action Inputs

Input	Default	Description
path	docs/decisions	Directory containing ADR files
pattern	**/*.md	Glob pattern for ADR files
schema	(built-in)	Custom JSON Schema path
strict	false	Fail on warnings
fail-on-error	true	Fail workflow on errors

Project ADRs (Dogfooding)

This release includes exemplar ADRs demonstrating the format:

• ADR-0001: Adopt Structured MADR Format for Project Documentation
• ADR-0002: Shareable GitHub Action for Structured MADR Validation

Full Changelog

v1.0.0...v1.1.0

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