ratchet:watch

What problem does it solve?

Ratchet:watch eliminates the need for manual PR triage by continuously checking active Ratchet PRs for merge conflicts, CI failures, and actionable review comments and surfacing them as structured discoveries in .ratchet/plan.yaml so work is prioritized and tracked.

Core Features & Use Cases

• Watches PRs referenced in .ratchet/plan.yaml and polls on a configurable interval.
• Detects merge conflicts and CI failures and creates deduplicated discovery entries tied to the originating issue and milestone.
• Fetches review comments and review verdicts, classifies them (actionable vs informational), records feedback as discoveries, and optionally spawns response agents unless --no-respond is set.
• Maintains a persistent .ratchet/watch-state.json to avoid reprocessing and handles authentication checks and malformed-state recovery.
• Use case: Run during ratchet:run to surface blocking CI failures and reviewer change requests automatically so response agents or teams can act immediately.

Quick Start

Run /ratchet:watch from your project workspace to start monitoring Ratchet PRs and automatically create discoveries for conflicts, CI failures, and actionable review comments.