adr-review

Review code against project ADRs and report violations with fixes.

1|Updated Nov 14, 2025

Search Tags:#architecture #code review #refactoring #adr #compliance #standards

Ready to run

npx skills add https://github.com/zgagnon/skills --skill adr-review-zgagnon

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: adr-review
Source: https://github.com/zgagnon/skills/tree/main/adr-review
Command: npx skills add https://github.com/zgagnon/skills --skill adr-review-zgagnon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures code adheres to established Architecture Decision Records (ADRs), preventing architectural drift and maintaining consistency during development and code reviews.

Core Features & Use Cases

ADR Compliance Checking: Systematically reviews code against all project ADRs.
Violation Reporting: Identifies specific lines of code that violate ADRs and suggests fixes.
Use Case: During a code review, use this Skill to verify that a new feature's implementation follows the project's ADRs regarding error handling patterns and test structure, flagging any deviations.

Quick Start

Use the adr-review skill to check the code in the 'src/utils' directory against all project ADRs.

Frequently Asked Questions about adr-review

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

FAQPage Schema

How do I check code for compliance with Architecture Decision Records during a code review?▼

To check code for ADR compliance during code review, this Skill systematically scans your codebase against all project Architecture Decision Records, identifies specific lines that violate documented decisions, and reports violations with suggested fixes to enforce architectural standards.

What is the best way to prevent architectural drift when refactoring code?▼

Preventing architectural drift during refactoring requires validating code changes against established ADRs. This Skill reviews refactored code for compliance with documented architectural standards, automatically flagging deviations and providing specific fixes to maintain consistency.

How does automated ADR compliance checking work for existing source directories?▼

Automated ADR compliance checking works by comparing source code in specified directories against all project Architecture Decision Records. This Skill detects violations of documented architectural standards and outputs specific lines of code that deviate, along with recommended fixes.

Can I enforce architectural standards automatically without manually comparing code to ADRs?▼

Yes, you can enforce architectural standards automatically by running this Skill on target directories like 'src/utils'. It evaluates the code against all project ADRs without manual comparison, directly reporting any violations and suggesting specific fixes to prevent deviations.

What limitations should I expect when enforcing ADR compliance across a large codebase?▼

When enforcing ADR compliance across a large codebase, this Skill relies entirely on the existence and quality of your project's Architecture Decision Records. It checks code against documented decisions and reports violations, but requires accurate ADRs to effectively prevent architectural deviations.