adr-check
Run ADR conformance checks, explain failures, and identify required ADR/doc updates for the current change.
SKILL.md.claude/skills/adr-check/SKILL.md
GitHubADR Check
Use this skill when the change touches architecture, workflows, hooks, shared contracts, or guardrail files.
Steps
- Identify changed files:
git diff --name-only HEAD
- Run the fast ADR guard on changed files:
python3 scripts/adr_guard/adr_guard.py --changed --level fast
If the fast guard fails:
- Report the exact rule ids and files.
- Fix the code or docs.
- Re-run the guard.
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
If a temporary waiver is genuinely required:
- add it to
docs/adr/exceptions.yaml - include
rule_id,owner,reason, andexpires_on - keep the waiver as narrow as possible with
checksandpaths
- add it to
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