adr-review
Review code changes against accepted ADRs for compliance violations
Best for PR review workflowsWorks with GitHubLow risk
⌘source
- author
@ruvnet- repo
- ruvnet/ruflo
- language
- TypeScript
★46kstars
5.1kforks
May 5, 2026
✦overview.md
Key Features
- ·Detects ADR compliance violations
- ·Uses git diff to find changes
- ·Searches for semantically related ADRs
- ·Loads ADR decision and status
- ·Checks code changes against constraints
Use Cases
- →Before merging a PR to ensure architectural compliance
- →Periodic compliance checks on a codebase
- →After significant code changes to detect drift
- →Reviewing changes against multiple ADRs
Best for
- ✓PR review workflows
- ✓architecture governance
- ✓teams with ADRs
Not ideal for
- !projects without ADRs
- !non-code compliance checks
FAQs
name
adr-review
description
Review code changes against accepted ADRs for compliance violations
argument-hint:[--branch BRANCH]
allowed-tools:mcp__claude-flow__agentdb_hierarchical-query mcp__claude-flow__agentdb_causal-query mcp__claude-flow__memory_search Bash Read Grep Glob
ADR Review
Review code changes against accepted Architecture Decision Records to detect violations, drift, and non-compliance.
When to use
Before merging a PR, after significant code changes, or as part of a periodic compliance check. Use this to ensure code changes respect the architectural decisions the team has agreed upon.
Steps
-
Get diff -- Run
git diff main...HEAD --name-only(or the specified branch) to list changed files. Then rungit diff main...HEADto get the full diff content. -
Find relevant ADRs -- For each changed file:
Grepthe file for ADR references (ADR-\d+)Grepdocs/adr/for ADRs that mention the changed file paths or modules- Call
mcp__claude-flow__memory_searchwith the file path and change summary to find semantically related ADRs
-
Load ADR content --
Readeach relevant ADR file. Focus on:- The Decision section (what was decided)
- The Status (only enforce "accepted" ADRs)
- The Consequences (expected constraints)
-
Check for violations -- Analyze each changed file against its relevant ADRs:
- Does the code change contradict an accepted decision?
$install
1-click copynpx skills add ruvnet/ruflo --skill adr-reviewSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.