feat(adr): MADR 4.0.0 tooling for adr new/check, plus a new adr init #484

Merged

hexajon merged 2 commits from issue-483-adr-align-the-adr-tooling-with-madr-4-exactly-docs into main

2026-09-14 15:41:03 +00:00

hexajon commented

2026-09-14 15:41:01 +00:00

Owner

Summary

Aligns madt_adr / madtea adr with MADR 4.0.0.

Layout detection: docs/decisions/ is MADR mode, docs/adr/ is the legacy mode (behaviour unchanged). A repo with both trees is an error. A repo with neither points at adr init.
New adr init action: creates docs/decisions/ with the MADR 4.0.0 templates (bare and explained), record 0000, and a README index.
adr new in MADR mode writes the bare MADR template with the status, date, decision-makers, optional impacts, title, and tracking substitutions. Numbering stays origin-first and is layout-aware.
adr check in MADR mode validates the YAML frontmatter (status grammar, date, mandatory sections in order, unique numbers, resolvable links, two-way supersedence) and, for an undecided record, that its tracking issues are open in the top-level repo (git config madtea.adr.topLevelRepo) and every impacts repo. --offline skips the forge round trip. Legacy docs/adr/ trees keep the current checks unchanged.
Vendors the MADR 4.0.0 templates verbatim from adr/madr tag 4.0.0 under internal/service/adr/madr/ (MIT OR CC0-1.0).

Refs #483. The repository's own docs/adr/ tree stays on the legacy format in this change; converting it to docs/decisions/ MADR is the follow-up pass under the same issue.

Refs #483

## Summary Aligns `madt_adr` / `madtea adr` with MADR 4.0.0. - Layout detection: `docs/decisions/` is MADR mode, `docs/adr/` is the legacy mode (behaviour unchanged). A repo with both trees is an error. A repo with neither points at `adr init`. - New `adr init` action: creates `docs/decisions/` with the MADR 4.0.0 templates (bare and explained), record 0000, and a README index. - `adr new` in MADR mode writes the bare MADR template with the status, date, decision-makers, optional impacts, title, and tracking substitutions. Numbering stays origin-first and is layout-aware. - `adr check` in MADR mode validates the YAML frontmatter (status grammar, date, mandatory sections in order, unique numbers, resolvable links, two-way supersedence) and, for an undecided record, that its tracking issues are open in the top-level repo (git config `madtea.adr.topLevelRepo`) and every `impacts` repo. `--offline` skips the forge round trip. Legacy `docs/adr/` trees keep the current checks unchanged. - Vendors the MADR 4.0.0 templates verbatim from adr/madr tag 4.0.0 under `internal/service/adr/madr/` (MIT OR CC0-1.0). Refs #483. The repository's own `docs/adr/` tree stays on the legacy format in this change; converting it to `docs/decisions/` MADR is the follow-up pass under the same issue. Refs #483

hexajon added 2 commits

2026-09-14 15:41:01 +00:00

wip(adr): #483 MADR 4.0.0 tooling build output (pre-fix-round checkpoint) 147ae9c232