rig-pr-buddy

A Claude Code rig that runs an AI code-review loop on any GitHub PR. Pick an open PR, analyze the diff, draft per-file review comments, produce a 5-line founder brief. Read-only via the gh CLI — drafts only, no auto-posting.

Built for solo founders, AI-native devs, and vibe coders shipping from Claude / Cursor / agentic tools who want a second pair of eyes on every PR before merge.

What it does

Four skills on top of a shared reviews/<repo>-<num>/ scratch directory:

Skill	Input	Output
/pick-pr <owner>/<repo> [pr-number]	a GitHub repo + optional PR number	reviews/<repo>-<num>/raw.md + diff.patch
/analyze <repo>-<num>	the scratch dir from /pick-pr	reviews/<repo>-<num>/analysis.md
/draft-comments <repo>-<num>	scratch dir + analysis	reviews/<repo>-<num>/comments.md
/founder-brief <repo>-<num>	scratch dir + analysis	reviews/<repo>-<num>/brief.md

Layout

rig-pr-buddy/
  CLAUDE.md           # rig orientation (read by claude on every session)
  README.md           # this file
  rig.toml            # rig manifest
  reviews/            # YOUR per-PR scratch dirs (gitignored)
    <repo>-<num>/
      raw.md          # PR metadata
      diff.patch      # raw unified diff
      analysis.md     # /analyze output
      comments.md     # /draft-comments output
      brief.md        # /founder-brief output
  .claude/skills/
    pick-pr/
    analyze/
    draft-comments/
    founder-brief/

Prerequisite: gh CLI

This rig requires the GitHub CLI to be installed and authenticated.

1. Install gh — brew install gh on macOS, or see https://cli.github.com for other platforms.
2. Authenticate — gh auth login and follow the browser flow.
3. Confirm — gh auth status must return Logged in to github.com. Without this, /pick-pr cannot run.

Read-only gh subcommands only (pr list, pr view, pr diff). No comments are posted by the rig.

First run

1. Install the rig

   rig use hub:hugo/rig-pr-buddy
   cd ~/rigs/hugo/rig-pr-buddy   # or wherever rig installed it
   

2. Confirm gh is authenticated

   gh auth status
   

3. Launch claude

   claude
   

4. Run the loop on a real PR

   /pick-pr anthropics/claude-code
   

   Pick a PR number from the listed open PRs (or pass one directly: /pick-pr anthropics/claude-code 62821). The skill writes reviews/claude-code-62821/raw.md and diff.patch.

   Then:

   /analyze claude-code-62821
   /draft-comments claude-code-62821
   /founder-brief claude-code-62821
   

   Final outputs land in reviews/claude-code-62821/. Open brief.md first for the 5-line verdict, then comments.md to copy specific line comments into the PR.

Tools required

• claude (Claude Code CLI)
• gh (GitHub CLI, authenticated)

Boundaries

• Drafts only. No comments, no approvals, no merges are posted by this rig.
• Read-only gh subcommands only.
• No invented code references — every comment cites a real line range from diff.patch.
• Append-only on reviews/<repo>-<num>/. Re-running a skill writes a -v2 variant rather than overwriting.