review-branch

Thin wrapper. Runs atomic-reviewer once on <base>..HEAD, returns its standard ## Spec compliance + ## Code quality + signals block + VERDICT: output.

Pre-flight

git rev-parse --is-inside-work-tree

If not in a git repo, stop:

not a git repo. /review-branch needs a versioned project.

Determine base:

gh repo view --json defaultBranchRef -q .defaultBranchRef.name 2>/dev/null \
  || git config init.defaultBranch \
  || echo main

Verify current branch is not the base:

git branch --show-current

If on base: refused: already on <base>. /review-branch reviews a feature branch against its base.

Verify there are commits to review:

git rev-list --count <base>..HEAD

If 0: refused: no commits on this branch ahead of <base>. nothing to review.

Dispatch

Capture the SHAs:

BASE_SHA=$(git merge-base <base> HEAD)
HEAD_SHA=$(git rev-parse HEAD)
FEATURE=$(git branch --show-current)

Invoke the Agent tool with:

• subagent_type: "atomic-reviewer"

• description: "Review <feature> against <base>"

• prompt:

  Review the diff <base>..HEAD on the current branch. No spec is provided — this is
  a pre-PR / pre-merge branch review, not a spec-compliance check.
  
  Branch: <feature>
  Base: <base>
  Base SHA: <BASE_SHA>
  HEAD SHA: <HEAD_SHA>
  Repo: <pwd>
  
  Skip the spec-compliance pass — emit `## Spec compliance\n\n(no spec — branch review only)`.
  
  Run the code-quality pass thoroughly. Verify TDD signals as usual:
    - typecheck (project-detected command from docs/wiki/index.md if present)
    - tests
    - build
    - lint
  
  Emit the standard output format ending with VERDICT: PASS or VERDICT: CHANGES_REQUESTED.
  

Report

Pass the reviewer's output through to the user verbatim. Do not summarize, do not add commentary — the reviewer's findings are the deliverable.

Append one line at the end:

suggested next step (on PASS):
  /commit pr    → open PR for review
  /commit merge → merge into <base>