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.

2. 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__claude-flow__memory_search with the file path and change summary to find semantically related ADRs