adr-check

name	adr-check
description	Run ADR conformance checks, explain failures, and identify required ADR/doc updates for the current change.

ADR Check

Use this skill when the change touches architecture, workflows, hooks, shared contracts, or guardrail files.

Steps

1. Identify changed files:

git diff --name-only HEAD

2. Run the fast ADR guard on changed files:

python3 scripts/adr_guard/adr_guard.py --changed --level fast

3. If the fast guard fails:

   • Report the exact rule ids and files.
   • Fix the code or docs.
   • Re-run the guard.

4. If guardrail files changed, verify that one of these changed too:

   • docs/adr/**
   • shifter/shifter_platform/documentation/docs/technical/dev/adr-enforcement.md
   • technical index pages linking to ADR enforcement docs

5. If a temporary waiver is genuinely required:

   • add it to docs/adr/exceptions.yaml
   • include rule_id, owner, reason, and expires_on
   • keep the waiver as narrow as possible with checks and paths

6. Before completion, run the CI profile:

python3 scripts/adr_guard/adr_guard.py --all --level ci

Output

Report:

• checks run
• violations found or “ADR guard clean”
• ADR/doc files updated
• any exception added and its expiry