| name | watch-pr |
| description | Watch an Elixir/Phoenix PR with an Amp Orb keep-alive lease until required non-deployment CI is green and review threads are resolved. Use after opening or updating a PR. |
| effort | medium |
| argument-hint | <PR number or URL> [--checks-only] [--fix] [--max-hours N] [--quiet-minutes N] |
Watch PR — Amp-Native Lifecycle
Use the elixir_phoenix_watch_pr plugin tool. Do not launch gh pr checks --watch, gh run watch, a foreground sleep loop, or the copied Claude watcher
script: none of those owns an Amp Orb keep-alive lease.
Iron Laws
- Acquire one bounded keep-alive lease — start the plugin lifecycle once,
then let its durable state and dedupe handle polling and plugin reloads.
- Deployment is never readiness — deployment, release, preview,
production, and prod checks are reported under
excludedChecks; they are
never counted as passing or failing required CI.
- Never merge or deploy — watching and
--fix authorize neither action.
--fix uses the same worker thread — the plugin serializes one concise
event turn at a time and directs that turn to the installed phx-pr-review
workflow for actionable review feedback or failed required CI. Validate the
cause before editing.- Every watch is bounded — timeout and every other terminal path release
the lease. A timeout is incomplete, never success.
