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

1. Get diff -- Run git diff main...HEAD --name-only (or the specified branch) to list changed files. Then run git diff main...HEAD to get the full diff content.

1. Find relevant ADRs -- For each changed file:

• Grep the file for ADR references (ADR-\d+)
• Grep docs/adr/ for ADRs that mention the changed file paths or modules
• Call mcp__plugin_ruflo-core_ruflo__memory_search with the file path and change summary to find semantically related ADRs

1. Load ADR content -- Read each relevant ADR file. Focus on:

• The Decision section (what was decided)
• The Status (only enforce "accepted" ADRs)
• The Consequences (expected constraints)

1. 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?

1. Query relationship graph -- Call mcp__plugin_ruflo-core_ruflo__memory_list with namespace adr-edges (rows are keyed <relation>:<from>__<to> with relation supersedes, amends or depends-on) to check if any referenced ADR has been superseded. If the namespace is empty, run adr-index first. If a referenced ADR is superseded, flag that the code references an outdated decision.

1. Report -- Present findings as a compliance report:

```

ADR Compliance Report

Violations

• [ ] : — violates ADR-NNN:

Warnings

• [!] references superseded ADR-NNN (replaced by ADR-MMM)

Compliant

• [x] — consistent with ADR-NNN

Unlinked Changes

• [?] — no ADR coverage (consider creating one)

```

1. Suggest actions -- For each violation, suggest whether to update the code or propose a new ADR to supersede the violated one.