Why this matters
CI checks keep ADR quality high and prevent drift.
Add a CI job that validates docs/adr/ files: filename pattern, required sections, valid Status, presence of PR/issue links, and optional schema (YAML front matter).
CI checks keep ADR quality high and prevent drift.
Side-by-side examples engineers can pattern-match during review.
Pipeline has no ADR validation.jobs: adr-lint → validate docs/adr/.md; fail on missing 'Status' or broken links.ci: adr-lint checks docs/adr/.mdNo CI rule for ADRsFrom the same buckets as this rule.
For changes that affect architecture, data models, external APIs, security posture, deployment topology, or cost (>10%), create an ADR in docs/adr/ using the standard template (Context, Decision, Consequences) and link the PR and issue IDs.