adr-review
Review code changes against accepted ADRs for compliance violations
How do I install this agent skill?
npx skills add https://github.com/ruvnet/ruflo --skill adr-reviewIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill reviews code changes for compliance with Architecture Decision Records (ADRs). It performs local repository analysis using git and grep to identify potential architectural deviations without accessing sensitive credentials or performing any network-bound exfiltration operations.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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__plugin_ruflo-core_ruflo__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?
- Does it use a technology/pattern that an ADR explicitly rejected?
- Does it modify a module in a way the ADR's consequences warned against?
- Is the code referencing a deprecated or superseded ADR?
-
Query relationship graph -- Call
mcp__plugin_ruflo-core_ruflo__memory_listwith namespaceadr-edges(rows are keyed<relation>:<from>__<to>with relationsupersedes,amendsordepends-on) to check if any referenced ADR has been superseded. If the namespace is empty, runadr-indexfirst. If a referenced ADR is superseded, flag that the code references an outdated decision. -
Report -- Present findings as a compliance report:
## ADR Compliance Report ### Violations - [ ] <file>:<line> — violates ADR-NNN: <reason> ### Warnings - [!] <file> references superseded ADR-NNN (replaced by ADR-MMM) ### Compliant - [x] <file> — consistent with ADR-NNN ### Unlinked Changes - [?] <file> — no ADR coverage (consider creating one) -
Suggest actions -- For each violation, suggest whether to update the code or propose a new ADR to supersede the violated one.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/ruvnet/ruflo/adr-review">View adr-review on skillZs</a>