pr-shepherd

pr-shepherd

Use when a PR has been created and needs to be monitored through to merge - handles CI failures, review comments, and thread resolution automatically until all checks pass and all threads are resolved.

IMPORTANT: This skill is designed for the agent working in a worktree, NOT the orchestrator. The agent handles its own PR monitoring so the orchestrator remains free for other work.

Coordination Mode Note

This skill supports both coordination modes:

• Task Mode (default): Runs as a single long-running Task() with run_in_background: true. Orchestrator checks via TaskOutput(block: false).
• Team Mode: Runs as a persistent shepherd teammate in the issue-{number} team. Sends async status updates via SendMessage (CI failure, review comments, all-green, PR merged). Orchestrator can respond with instructions (e.g., "defer that comment, create an issue instead"). Responds to shutdown_request for graceful exit.

All monitoring, fixing, and review handling logic is identical in both modes. See ./guides/agent-coordination.md for mode detection.

---

When to Activate

Activate this skill when ANY of these conditions are true:

• Agent just created a PR with gh pr create
• User asks to "shepherd", "monitor", or "see through" a PR
• User invokes /pr-shepherd <pr-number>
• User asks to "watch this PR" or "handle this PR until it's merged"
• Orchestrator spawned you with instructions to shepherd a PR
• Automatic: bin/create-pr-with-shepherd.sh was used (outputs shepherd instructions)

Automatic Activation via Wrapper Script

When bin/create-pr-with-shepherd.sh creates a PR, it outputs shepherd instructions:

==========================================
  PR Shepherd Active for PR #123
==========================================

The pr-shepherd skill will:
  - Monitor CI/CD status
  - Auto-fix lint, type, and test issues
  - Handle review comments
  - Resolve threads after addressing feedback
  - Report when PR is ready to merge

To manually invoke shepherd later:
  /pr-shepherd 123