gitnexus-pr-review

Usage

Loaded automatically when the description matches the active task. Specifics are documented in the body below.

PR Review with GitNexus

When to Use

• "Review this PR"
• "What does PR #42 change?"
• "Is this safe to merge?"
• "What's the blast radius of this PR?"
• "Are there missing tests for this PR?"
• Reviewing someone else's code changes before merge

Workflow

1. gh pr diff <number>                                    → Get the raw diff
2. gitnexus_detect_changes({scope: "compare", base_ref: "main"})  → Map diff to affected flows
3. For each changed symbol:
   gitnexus_impact({target: "<symbol>", direction: "upstream"})    → Blast radius per change
4. gitnexus_context({name: "<key symbol>"})               → Understand callers/callees
5. READ gitnexus://repo/{name}/processes                   → Check affected execution flows
6. Summarize findings with risk assessment

If "Index is stale" → run npx gitnexus analyze in terminal before reviewing.

Checklist

- [ ] Fetch PR diff (gh pr diff or git diff base...head)
- [ ] gitnexus_detect_changes to map changes to affected execution flows
- [ ] gitnexus_impact on each non-trivial changed symbol
- [ ] Review d=1 items (WILL BREAK) — are callers updated?
- [ ] gitnexus_context on key changed symbols to understand full picture
- [ ] Check if affected processes have test coverage
- [ ] Assess overall risk level
- [ ] Write review summary with findings

Review Dimensions

Dimension	How GitNexus Helps
Correctness	context shows callers — are they all compatible with the change?
Blast radius	impact shows d=1/d=2/d=3 dependents — anything missed?
Completeness	detect_changes shows all affected flows — are they all handled?
Test coverage	impact({includeTests: true}) shows which tests touch changed code
Breaking changes	d=1 upstream items that aren't updated in the PR = potential breakage

Risk Assessment