void-autopilot

Orchestrates parallel ticket implementation in isolated git worktrees into one integration pull request.

Updated May 29, 2026
One-click install
npx skills add https://github.com/voidcorp-core/void-harness --skill void-autopilot-voidcorp-core
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: void-autopilot
Source: https://github.com/voidcorp-core/void-harness/tree/main/packages/core/skills/void-autopilot
Command: npx skills add https://github.com/voidcorp-core/void-harness --skill void-autopilot-voidcorp-core

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Draining a backlog of ready tickets by hand means serial work, drifting standards, and manual reconciliation of parallel changes. This Skill runs a bounded cluster of independent tickets end-to-end, each in its own git worktree, and reconciles them into a single integration pull request with a declared merge gate. ## Core Features & Use Cases - Worktree-isolated parallel workers: Each ticket runs the full implementation skill once in its own worktree and branch, with disjoint footprints parallelized and colliding or migration tickets sequenced. - Deterministic CLI-driven cycle: Every decision (base, reserve, orchestrate, reconcile, verify, gate, publish, grant) goes through a pure void-harness autopilot <step> command that observes nothing and returns plans or named refusals. - Footprint audit and merge gate: Reconciliation refuses ranges touching files another ticket declared, and the grant refuses merges on production branches, sensitive paths, unprotected bases, or contradicted union reviews. - Use Case: Before leaving for the day, run mode autopilot 6h to drain ready tickets from the programme's tracker pool; each finished unit lands on a draft integration PR whose body reports ALIVE, STALLED, or ENDED status. ## Quick Start Ask the agent to drain the ready tickets from the current programme into one integration pull request using the autopilot skill.

Frequently Asked Questions about void-autopilot

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

FAQPage Schema
How do I run multiple tickets in parallel with git worktrees?

The autopilot orchestrate step creates one worktree and branch per ticket before any worker starts, then runs disjoint-footprint tickets in parallel lanes up to the plan's concurrency limit. Tickets that collide on files, lockfiles, or migrations are sequenced one at a time.

How do I drain a backlog of tickets unattended?

Use `mode autopilot 6h` with a duration, not a ticket count. The budget comes from the programme's autopilot.chainBudget declaration as a ceiling, or a two-hour fallback when absent, and the chain step decides between units whether to continue or stop.

Can autopilot merge pull requests automatically?

Only when the programme declares mergeGate: union-reviewed with a non-deploying target branch. The grant refuses on production downstreams, human-gated tickets, unprotected bases, sensitive paths like migrations and lockfiles, unread or contradicted union reviews, and stale readings.

Does this work with Codex subagents as well as Claude Code?

Yes. Both runtimes read the same OrchestrationPlan and return the same WorkerResult schema. Claude executes via its Workflow primitive while Codex uses native subagents with pre-created worktrees, since subagents share filesystem access.

Why can't workers use git stash inside a worktree?

A worktree isolates the working tree, index, and HEAD, but refs like refs/stash, tags, notes, and remotes are one shared namespace across all worktrees. Two workers stashing concurrently can take each other's entries, so the plan denies the whole class of shared git state writes.

What happens when a ticket fails during an autopilot run?

The failed unit is journaled as unit-blocked with its cause, its branch and worktree are preserved, and the remaining tickets continue through reconciliation and verification. A unit is taken exactly once and never reproposed onto its own pull request.