validating-adr-compliance

Validate pull request changes against Architecture Decision Records for compliance.

Updated Jan 14, 2026

Search Tags:#architecture #adr #governance #code-review #pr-validation #adr-compliance

Ready to run

npx skills add https://github.com/axiomhq/validating-adr-compliance --skill validating-adr-compliance

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: validating-adr-compliance
Source: https://github.com/axiomhq/validating-adr-compliance/tree/main/.agents/skills/validating-adr-compliance
Command: npx skills add https://github.com/axiomhq/validating-adr-compliance --skill validating-adr-compliance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates PR code and related implementations adhere to Architecture Decision Records.

Core Features & Use Cases

Validating a PR implements an ADR correctly
Checking if code changes align with documented architectural decisions
Reviewing implementation details against ADR specifications
Identifying deviations from accepted architecture

Quick Start

Provide the ADR ID and the PR details to begin the automated compliance review.

Frequently Asked Questions about validating-adr-compliance

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

FAQPage Schema

How do I validate a pull request against architecture decision records?▼

To validate a pull request against architecture decision records, provide the ADR ID and PR details to trigger an automated compliance review that checks code, docs, and configuration changes for alignment.

What is ADR compliance validation in code review?▼

ADR compliance validation in code review is the process of identifying and verifying that PR changes correctly implement documented architectural decisions, ensuring traceability to ADR documents through oracle-backed automated analysis.

Can I check multiple ADRs in a single large pull request?▼

Yes, you can check multiple ADRs in a single large pull request. The validation process is designed to handle multi-ADR scenarios, reviewing implementation details across code and configuration to identify any deviations from accepted architecture.

How do I ensure code changes align with documented architectural decisions?▼

To ensure code changes align with documented architectural decisions, run an automated PR validation that reviews implementation details against ADR specifications, providing automated assurance that architectural governance is properly enforced.

What types of files does ADR compliance validation review in a PR?▼

ADR compliance validation reviews code, documentation, and configuration files within a PR where architecture decision records are involved, ensuring all related implementation changes adhere to the specified architectural decisions.

When do I need automated ADR alignment checks for PRs?▼

You need automated ADR alignment checks for PRs when you require traceability to architecture decision documents and automated assurance that code changes properly implement accepted architectural decisions without manual review bottlenecks.