skills.rest
netbrain
netbrainCOMMUNITY
Explore all skills by this author →
Website𝕏@netweedGitHub

ratchet:run

Orchestrate debate-driven development pipelines across milestones and issues.

1|Updated Mar 12, 2026
Search Tags:#orchestration#worktree#guards#pr-automation#ratchet#debate-driven#issue-pipeline
One-click install
npx skills add https://github.com/netbrain/ratchet --skill ratchet-run
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ratchet:run
Source: https://github.com/netbrain/ratchet/tree/main/skills/run
Command: npx skills add https://github.com/netbrain/ratchet --skill ratchet-run

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about ratchet:run

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I orchestrate phase-gated development pipelines across multiple issues?▼

You can orchestrate phase-gated development pipelines by resolving workspace context, building milestone and issue dependency graphs, and managing parallel execution layers using a .ratchet configuration to ensure safe, gated progression.

What is debate-driven development and how does it manage issue pipelines?▼

Debate-driven development manages issue pipelines by spawning paired agent debate-runners or solo generative agents within isolated worktrees to execute guards, handle regressions, and produce structured completion summaries for safe progression.

How do I automate pull request packaging from isolated git worktrees?▼

Automate pull request packaging by running isolated worktrees, executing pre and post guards, then aggregating commits into branches and PRs while syncing a GitHub plan-tracking issue and cleaning up worktrees.

Can I run unsupervised development pipelines with automatic PR creation?▼

Yes, unsupervised runs support auto-continuation and automatic PR creation capabilities, alongside quick-fix, in-session, and dry-run cost estimate modes for flexible workflow automation.

Do I need a .ratchet configuration file to use phase-gated worktree isolation?▼

Yes, a .ratchet configuration file is required to build dependency graphs, run isolated worktrees, execute deterministic guards, and synchronize plan.yaml for phase-gated worktree isolation.

What is the best way to manage milestone dependencies and parallel execution layers?▼

The best way to manage milestone dependencies is by reading and updating plan.yaml to build dependency graphs and manage parallel execution layers, ensuring gated progression across the entire epic.

Related Skills

Explore More Software Engineering Skills→
netbrainnetbrain
1

ratchet:sidequest

Records ad-hoc discoveries into the Ratchet plan's .ratchet/plan.yaml.

Community
Intermediate
auerbachbauerbachb
3

wrap

Verify unresolved reviews, squash-merge pull requests, and clean up local worktrees.

Community
Advanced
emmepraemmepra
1

worktree-flow

Coordinates Docker-isolated per-branch worktrees and PRs into dev.

Community
Advanced
2lab-ai2lab-ai

setup-ai-workflow

Configure an AI work-execution system with gate checks, commit/PR conventions, worktree isolation, and deployment runbook.

Official
Advanced