What problem does it solve?
Manually verifying that code changes (PRs, branches, or uncommitted working changes) do not break existing system rules, invariants, and documented behavior is time-consuming and error-prone, especially for codebases with extensive institutional knowledge encoded in substrate.
Core Features & Use Cases
- Scoped substrate discovery: Only scans files modified by the diff instead of the entire repository for fast, targeted reviews.
- Parallel reviewer dispatch: Runs two specialized agents in parallel to assess both substrate alignment (preservation of behavior and invariants) and code structure quality.
- Verdict-led output: Returns a ranked list of concrete findings with exact file references, required changes, and documentation to update, plus a clear Pass/Pass with notes/Needs substrate/Risky/Block verdict.
- Use cases: Review PRs before merge, validate branch changes against existing specs, check uncommitted changes for cohesion issues, or verify post-implementation changes against a locked Cohesive design.
Quick Start
Use the review-diff skill to review your open PR for alignment with the codebase's existing documented behavior and invariants.