ratchet:run

What problem does it solve?

Ratchet:run automates and governs multi-issue, phase-gated development workflows by orchestrating paired agent debates, deterministic guards, and PR packaging so teams can progress features safely and consistently without manual pipeline choreography.

Core Features & Use Cases

• Epic and milestone orchestration: Resolve workspace context, read and update .ratchet/plan.yaml, build milestone and issue dependency graphs, and manage parallel execution layers.
• Issue-level, phase-gated pipelines: Launch isolated worktrees, run pre/post guards, spawn debate-runners or solo generative agents, handle regressions and escalations, and produce structured completion summaries.
• Safe packaging and tracking: Aggregate results, create branches and PRs, sync a GitHub plan-tracking issue, and clean up worktrees while preserving audit artifacts for recovery and review.
• Modes and automation: Supports quick-fix, here (in-session), dry-run cost estimates, and unsupervised runs with auto-continuation and auto-PR capabilities.

Quick Start

Run /ratchet:run at the repository root to resume the epic, evaluate ready milestones, and launch issue pipelines according to your workflow configuration.