From 4dd9a74be79c4b785cb4fb49d295b8a8f36a28fc Mon Sep 17 00:00:00 2001
From: Jeroen Schweitzer <jpmschweitzer@gmail.com>
Date: Tue, 21 Apr 2026 17:28:44 +0200
Subject: [PATCH] add decisions-validate pre-push gate

One new Makefile target (tools/scripts/plan decisions validate)
wired as a prerequisite of push-check so malformed records fail
locally before they reach a reviewer. Parser dry-run is cheap
(~100ms) and stays within the <90s pre-push budget.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 CHANGELOG.md | 3 +++
 Makefile     | 6 +++++-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 900eae23..258d09df 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -50,6 +50,9 @@ heading, and (b) bumping `project.yaml` `version:` in the same commit.
   [`D-040`](decisions/process.md#d-040-python-stopgap-under-toolsscriptsplan)
   / [`R-011`](decisions/rejected.md#r-011-permanent-stopgap).
 
+- `make decisions-validate` — cheap parser dry-run wired into
+  `push-check`. Catches malformed records before push.
+
 ### Removed
 
 - `docs/ADRs/` directory — content lifted into `decisions/` as D/R
diff --git a/Makefile b/Makefile
index 2e0a14de..f183a55c 100644
--- a/Makefile
+++ b/Makefile
@@ -160,8 +160,12 @@ security: ## Dart advisory review + ptyc source review (manual — no floating d
 
 # -- pre-push gate -------------------------------------------------------
 
+.PHONY: decisions-validate
+decisions-validate: ## Parser dry-run over decisions/*.md (cheap pre-push gate).
+	tools/scripts/plan decisions validate
+
 .PHONY: push-check
-push-check: test test-a11y ## Pre-push gate: fast unit + widget + golden + a11y (<90s).
+push-check: decisions-validate test test-a11y ## Pre-push gate: decisions + fast unit + widget + golden + a11y (<90s).
 
 .PHONY: hooks
 hooks: ## Install the repo's git hooks (points core.hooksPath at .githooks/).