adr-compliance

Audit code against accepted ADRs and generate compliance reports.

5|3|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/zircote/adr --skill adr-compliance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr-compliance
Source: https://github.com/zircote/adr/tree/main/skills/adr-compliance
Command: npx skills add https://github.com/zircote/adr --skill adr-compliance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

ADR compliance ensures that architectural decisions are actually implemented in code, enabling teams to verify alignment, identify deviations, and manage architectural debt.

Core Features & Use Cases

  • Guidance on auditing code against accepted ADRs and enforcing decisions across codebases.
  • Methods for defining enforceable ADRs, automation patterns, and reporting of violations.
  • Use Case: A team wants to verify that new changes adhere to a specific ADR about technology choices and architectural patterns.

Quick Start

To start, ask Claude to run an ADR compliance check on your repository and generate a remediation plan.

Frequently Asked Questions about adr-compliance

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

FAQPage Schema
How do I audit code against accepted ADRs to detect prohibited architectural patterns?

ADR compliance auditing scans codebases across multiple languages and project structures to detect prohibited patterns, missing authorizations, and documentation gaps, generating a compliant or non-compliant report. This verifies that architectural decisions are actually implemented and identifies deviations.

How do I automate ADR enforcement within CI pipelines and pre-commit hooks?

ADR enforcement automation applies code analysis and pattern validation checks directly within CI pipelines and pre-commit hooks. This process intercepts non-compliant changes before integration, generating violation reports to manage architectural debt continuously.

What is architectural decision record compliance and when do I need to enforce it?

Architectural decision record compliance ensures accepted architectural decisions are actually implemented in code. Teams need ADR compliance to verify alignment, identify deviations from technology choices, and manage architectural debt when onboarding new changes or refactoring.

Can I check code for missing authorizations and documentation gaps across multiple project structures?

Yes, ADR compliance checks apply across multiple languages and project structures to detect missing authorizations and documentation gaps. It validates code against accepted ADRs and outputs a remediation plan to address identified violations.

What is the best way to define enforceable ADRs for code analysis?

Defining enforceable ADRs requires specifying concrete technology choices and architectural patterns that can be validated through automated code analysis. This enables pattern validation checks to detect prohibited implementations and generate accurate compliance reports.

How do I generate a remediation plan after identifying ADR violations in my repository?

After running an ADR compliance check on a repository, the tool generates a remediation plan detailing the non-compliant findings. This plan guides teams in correcting prohibited patterns, adding missing authorizations, and closing documentation gaps.