Skip to content
cccskills
FreePublished on GitHub

adr-check

Run ADR conformance checks, explain failures, and identify required ADR/doc updates for the current change.

The English summary is being prepared. Showing the original description.

PaloAltoNetworks/shifter

Run score Not tested

See how to install

Files included (1)

  • SKILL.md1.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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
  1. Run the fast ADR guard on changed files:
python3 scripts/adr_guard/adr_guard.py --changed --level fast

  1. If the fast guard fails:

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

  2. 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

  3. 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

  4. 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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

architecture-review

Free

Review a change for architectural drift, guardrail weakening, and ADR impact before shipping.

The English summary is being prepared. Showing the original description.

PaloAltoNetworks/shifter7Updated Oct 24, 2026

aws-tenant-standup

Free

Stand up or rebuild an AWS Shifter tenant end to end (teardown, bootstrap, secrets, image bakes, deploy via the real deploy.yml dispatch, health check, base-range smoke, and a POLARIS range walkthrough). AWS only. Use when asked to rebuild, redeploy, or stand up an AWS tenant such as proof or aws-dev from a clean state.

The English summary is being prepared. Showing the original description.

PaloAltoNetworks/shifter7Updated Oct 24, 2026

gh-workflow-monitor

Free

Monitor GitHub workflows, propose fixes for failures, and report status

The English summary is being prepared. Showing the original description.

PaloAltoNetworks/shifter7Updated Oct 24, 2026

ship

Free

Ship current branch — CI, SonarCloud, code review, security review, fix all issues, merge. Assumes code is already committed and pushed.

The English summary is being prepared. Showing the original description.

PaloAltoNetworks/shifter7Updated Oct 24, 2026

stage

Free

Stage files, run pre-commit, fix failures, loop until clean

The English summary is being prepared. Showing the original description.

PaloAltoNetworks/shifter7Updated Oct 24, 2026

See all skills by PaloAltoNetworks

Report a problem with this skill