| { |
| "name": "PR babysitter", |
| "objective": "Keep one pull request moving toward merge readiness without repeatedly requiring a human to poll comments, CI, conflicts, and stale review threads.", |
| "trigger": { |
| "type": "scheduled", |
| "cadence_or_event": "Every 2 hours during working hours, and after requested changes or failed required checks." |
| }, |
| "intake": { |
| "sources": ["GitHub pull request", "review comments", "required checks", "mergeability state"], |
| "selection_rule": "Act only on explicit blockers: unresolved review comments, failed checks, merge conflicts, or stale reviewer state." |
| }, |
| "workspace": { |
| "isolation": "Dedicated branch or worktree based on the PR branch.", |
| "allowed_actions": ["Read PR metadata", "apply narrow fixes", "run relevant checks", "write a progress comment"], |
| "disallowed_actions": ["force push", "large refactor", "dependency upgrade", "secrets access", "production change"] |
| }, |
| "context": { |
| "required_files": ["AGENTS.md", "CONTRIBUTING.md"], |
| "runtime_sources": ["latest PR head SHA", "review threads", "CI logs"] |
| }, |
| "agents": [ |
| { |
| "role": "Explorer", |
| "responsibility": "Summarize blockers and identify the smallest actionable work item." |
| }, |
| { |
| "role": "Implementer", |
| "responsibility": "Patch only the explicit blocker in the isolated workspace." |
| }, |
| { |
| "role": "Reviewer", |
| "responsibility": "Check that the diff is narrow and review comments were addressed." |
| } |
| ], |
| "verification": { |
| "gates": ["required GitHub checks pass", "unresolved comments are answered or resolved", "diff is scoped to the blocker"], |
| "receipts": ["commands run", "check URLs", "changed files", "remaining blockers"] |
| }, |
| "state": { |
| "artifacts": ["PR progress comment", "local PROGRESS.md"], |
| "update_rule": "Record last checked SHA, blockers, attempted fixes, verification evidence, and next action after every run." |
| }, |
| "budget": { |
| "max_retries": 3, |
| "max_runtime_minutes": 60 |
| }, |
| "escalation": { |
| "conditions": ["architectural decision needed", "same failure repeats twice", "reviewer disagreement", "force push required"], |
| "destination": "PR comment tagging the human owner" |
| }, |
| "exit": { |
| "success": "PR is merge-ready or waiting only on human review.", |
| "stop_without_success": "Loop is blocked, budget is exhausted, or the next action requires human judgment." |
| } |
| } |
|
|
