What problem does it solve? Coordinating multi-task software development with AI coding agents often leads to duplicated work, lost state, unreviewed merges, and untraceable changes. This Skill provides a deterministic controller that owns Git worktrees, commits, durable run state, provider retries, and GitHub traceability so approved development contracts execute safely and audibly from plan to merged PR. ## Core Features & Use Cases - Dual execution modes: Run a single detailed plan as one direct-plan unit, or execute an Analyst-produced DAG of atomic tasks serially in dependency order. - Immutable review lifecycle: Every task produces an additive candidate commit reviewed from a detached worktree at an exact SHA; fixes are additive and never amend reviewed commits. - Durable claims and recovery: Repository-wide Epic/task claims prevent duplicate execution across worktrees, survive process termination, and support resume, retry, cancel, and audited administrative release. - GitHub integration gates: Final integration requires exact-candidate CI gates, remote base validation, and an explicit integrate command with head-conditional squash merge. - Use Case: Point the controller at a GitHub Epic Issue; it materializes local contracts, claims the work, drives coding/review/fix agents through each task, opens one final PR, waits for green CI, and merges only after explicit approval. ## Quick Start Run the project-orchestrator CLI with run --spec plan.md --json to execute a detailed local plan through the full claim, coding, review, and integration lifecycle.
