PR Shepherd — Development agent for Claude Code
Takes an APPROVED loop PR from reviewer-approve to MERGED — pre-flight hygiene → push-delivery verification → runs the merge that fits MERGE_GATE → post-merge verification + stamp, all in one invoca.
How to install PR Shepherd
Installs to ~/.claude/agents/vaporphd-zprof-pr-shepherd.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/vaporphd/zprof/HEAD/.claude/agents/pr-shepherd.md -o ~/.claude/agents/vaporphd-zprof-pr-shepherd.md Restart Claude Code, or start a new session, for it to be picked up.
What PR Shepherd does
name: pr-shepherd description: Takes an APPROVED loop PR from reviewer-approve to MERGED — pre-flight hygiene → push-delivery verification → runs the merge that fits `MERGE_GATE` → post-merge verification + stamp, all in one invocation. Use proactively after [[reviewer]] returns `approve` on a loop-produced PR (or re-invoke on an already-merged PR for verification + stamp). Never reviews diffs, never writes code, never uses `--admin` / force / `--no-verify`; external PRs (dependabot / outsid
Alternatives in Development
- Gitnexus Branch Hygiene Reviewer — GitNexus branch hygiene and mergeability reviewer 45.8k ★
- Clawmem Curator — Maintains ClawMem memory health — lifecycle triage (pin/snooze/forget), retrieval health checks, dedup sweeps 201 ★
- Bibliography Auditor — Audits bibliography entries for completeness, consistency, and hygiene — checks .bib files, compiled PDF for u 169 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Branch Hygiene
MUST be used whenever the user asks to find stale, merged, or orphaned git branches, or asks to review/clean u
Branch Janitor
Post-merge cleanup agent — after the human confirms a PR/branch merge, removes stale agent worktrees, deletes
Ruver Fd Shipper
Ruver FD shipper. After thermo fix all — commit, push, draft PR. Does not claim delivery; CI gate follows.
Wiki Sync
Use this agent when syncing the vault git repository during automated maintenance cycles. Typical triggers inc
Gvr
Python's creator and Benevolent Dictator For Life (1991–2018), now BDFL emeritus and a member of the Steering
Shepherd
Persistent cross-swarm advisor. Walks the ticket alongside workers through Phases 1-6. Enforces PDS whitepaper
Related Skills
Arc Ready
One AI skill that takes a software project from idea to launch: what to build, how it fits together, in what o
Autonomy Off
End autonomy mode — finish the in-flight slice to merge, start nothing new, then post a closing summary (merge
Jared Groom
Routine board sweep — metadata, WIP, aging, pullable check, plan/spec drift, label hygiene. Advisory, proposes