Skip to content
Systematic

Resolve PR Parallel

View source

Resolve PR Comments in Parallel

Section titled “Resolve PR Comments in Parallel”

Resolve all unresolved PR review comments by spawning parallel agents for each thread.

Context Detection

Section titled “Context Detection”

Detect git context from the current working directory:

  • Current branch and associated PR
  • All PR comments and review threads
  • Works with any PR by specifying the number

Workflow

Section titled “Workflow”

1. Analyze

Section titled “1. Analyze”

Fetch unresolved review threads using the GraphQL script at scripts/get-pr-comments:

Terminal window
bash scripts/get-pr-comments PR_NUMBER

This returns only unresolved, non-outdated threads with file paths, line numbers, and comment bodies.

If the script fails, fall back to:

Terminal window
gh pr view PR_NUMBER --json reviews,comments
gh api repos/{owner}/{repo}/pulls/PR_NUMBER/comments

2. Plan

Section titled “2. Plan”

Create a task list of all unresolved items grouped by type (e.g., todowrite in OpenCode, update_plan in Codex):

  • Code changes requested
  • Questions to answer
  • Style/convention fixes
  • Test additions needed

3. Implement (PARALLEL)

Section titled “3. Implement (PARALLEL)”

Spawn a systematic:workflow:pr-comment-resolver agent for each unresolved item.

If there are 3 comments, spawn 3 agents — one per comment. Prefer running all agents in parallel; if the platform does not support parallel dispatch, run them sequentially.

Keep parent-context pressure bounded:

  • If there are 1-4 unresolved items, direct parallel returns are fine
  • If there are 5+ unresolved items, launch in batches of at most 4 agents at a time
  • Require each resolver agent to return a short status summary to the parent: comment/thread handled, files changed, tests run or skipped, any blocker that still needs human attention, and for question-only threads the substantive reply text so the parent can post or verify it

If the PR is large enough that even batched short returns are likely to get noisy, use a per-run scratch directory such as .context/systematic/resolve-pr-parallel/<run-id>/:

  • Have each resolver write a compact artifact for its thread there
  • Return only a completion summary to the parent
  • Re-read only the artifacts that are needed to resolve threads, answer reviewer questions, or summarize the batch

4. Commit & Resolve

Section titled “4. Commit & Resolve”
  • Commit changes with a clear message referencing the PR feedback
  • Resolve each thread programmatically using scripts/resolve-pr-thread:
Terminal window
bash scripts/resolve-pr-thread THREAD_ID
  • Push to remote

5. Verify

Section titled “5. Verify”

Re-fetch comments to confirm all threads are resolved:

Terminal window
bash scripts/get-pr-comments PR_NUMBER

Should return an empty array []. If threads remain, repeat from step 1.

If a scratch directory was used and the user did not ask to inspect it, clean it up after verification succeeds.

Scripts

Section titled “Scripts”

Success Criteria

Section titled “Success Criteria”
  • All unresolved review threads addressed
  • Changes committed and pushed
  • Threads resolved via GraphQL (marked as resolved on GitHub)
  • Empty result from get-pr-comments on verify