adr-check

Check codebase changes for ADR conformance and identify required updates.

3|3|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/PaloAltoNetworks/shifter --skill adr-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr-check
Source: https://github.com/PaloAltoNetworks/shifter/tree/main/.claude/skills/adr-check
Command: npx skills add https://github.com/PaloAltoNetworks/shifter --skill adr-check

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps maintain architectural decisions (ADR) conformance by checking the current codebase for adherence to ADRs, explaining failures, and identifying required updates.

Core Features & Use Cases

  • ADR Conformance Checks: Validate codebase against ADRs to ensure architectural consistency.
  • Explanation of Failures: Provide clear reasons for non-conformance, aiding in quick resolution.
  • Update Identification: Identify which ADRs need updating or creating based on the current change.
  • Use Case: When making changes to the architecture, use this Skill to ensure the changes are in line with the established ADRs and update the necessary documentation accordingly.

Quick Start

Run theadr-check skill to perform a conformance check on the current change.

Frequently Asked Questions about adr-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check codebase changes for architecture decision record conformance?

ADR conformance checks validate codebase changes against established architecture decision records by analyzing the code and documentation to identify non-conformances and explain failures.

What is the best way to identify which ADRs need updating after a codebase change?

Identifying ADR updates requires analyzing codebase changes to detect architectural shifts, which then highlights the specific architecture decision records that need creating or updating.

Why does my codebase change fail architectural integrity checks?

Codebase changes fail architectural integrity checks when they violate established ADRs. The conformance check explains failures by providing clear reasons for non-conformance to aid quick resolution.

When do I need to run an ADR conformance check during software development?

Run an ADR conformance check when making changes that affect architecture, ensuring the modifications align with established ADRs and maintaining architectural integrity in software development.

Can I analyze codebase changes without external dependencies to maintain architectural consistency?

Yes, this ADR conformance check operates without external dependencies, analyzing the codebase and ADR documentation directly to maintain architectural consistency.