skills.rest
gaberger
gabergerCOMMUNITY
Explore all skills by this author →
GitHub

hex-adr-review

Identifies deviations between git diffs and Architecture Decision Records in adrs docs.

4|Updated Mar 16, 2026
Search Tags:#architecture#adr#dependencies#compliance#code-review#git-diff
One-click install
npx skills add https://github.com/gaberger/hex --skill hex-adr-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hex-adr-review
Source: https://github.com/gaberger/hex/tree/main/.claude/skills/hex-adr-review
Command: npx skills add https://github.com/gaberger/hex --skill hex-adr-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams enforce architectural governance by automatically comparing code changes against existing Architecture Decision Records (ADRs) to surface deviations and misalignments.

Core Features & Use Cases

  • ADR conformance checks: verify that changes adhere to declared architectural decisions and boundaries.
  • Violation reporting: flag modifications that contradict ADRs and suggest ADR updates when needed.
  • PR-review assist: streamline code reviews by surfacing governance concerns early and guiding corrective actions.

Quick Start

Review the current change set against the ADRs and report any deviations.

Frequently Asked Questions about hex-adr-review

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

FAQPage Schema
How do I check code changes against architecture decision records?▼

To check code changes against architecture decision records, you can automatically parse git diffs, map modified files to ADRs documented in docs/adrs, and flag compliant, warning, or violation statuses for architectural boundaries.

What is ADR conformance checking in code review?▼

ADR conformance checking in code review is the process of verifying that code changes adhere to declared architectural decisions and boundaries, helping teams enforce architectural governance by automatically comparing modifications against existing ADRs.

Can I automate ADR violation reporting for pull requests?▼

Yes, you can automate ADR violation reporting for pull requests by parsing git diffs to flag modifications that contradict established ADRs, surfacing governance concerns early and suggesting ADR updates when needed to streamline reviews.

Does this ADR review tool work with any codebase governed by decision records?▼

Yes, this ADR review tool applies to any codebase governed by ADRs, especially when changes touch architectural boundaries, dependencies, or module interfaces, requiring no specific dependencies or components to function.

When should I update an architecture decision record during code review?▼

You should update an architecture decision record during code review when modifications contradict existing ADRs, as automated violation reporting flags these deviations and suggests ADR updates to maintain architectural governance and alignment.

Related Skills

Explore More Software Engineering Skills→
rvdbreemenrvdbreemen
4

judge

Review staged git diffs against accepted architectural decision records.

Community
Advanced
zgagnonzgagnon
1

adr-review

Review code against project ADRs and report violations with fixes.

Community
Advanced
dd-xiaozhidd-xiaozhi
2

fitness-run

Execute structural fitness functions to validate layer boundaries and OpenAPI contracts.

Community
Advanced
haginothaginot

architecture-guardian

Validate TypeScript layer dependencies and report import violations.

Community
Advanced