orchestrate

Manage git worktrees and coordinate subagents for multi-workstream projects.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/mattphanm/Codex-Agentic --skill orchestrate-mattphanm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orchestrate
Source: https://github.com/mattphanm/Codex-Agentic/tree/main/.codex/skills/orchestrate
Command: npx skills add https://github.com/mattphanm/Codex-Agentic --skill orchestrate-mattphanm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Orchestrate large multi-workstream projects by managing git worktrees to unlock true parallel development, load MasterSpec, allocate worktrees, dispatch implementers, monitor convergence, and drive automated merges.

Core Features & Use Cases

  • MasterSpec loading and validation
  • Per-workstream worktree allocation and tracking
  • Atomic spec discipline from spec groups
  • Parallel dispatch of independent workstreams
  • Convergence validation and security review gates
  • Merge queue management and post-merge recovery

Quick Start

Initialize an orchestrated workflow by loading MasterSpec, allocating worktrees for each workstream, and dispatching the first implementers.

Frequently Asked Questions about orchestrate

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

FAQPage Schema
How do I manage multiple git worktrees for parallel development?

You manage multiple git worktrees by allocating a dedicated worktree per workstream and tracking each in a distinct manifest. This enables parallel development by isolating concurrent implementers until convergence validation.

What is workstream convergence validation in a multi-workstream project?

Workstream convergence validation is the process of verifying that independently developed worktrees align before merging. It acts as a security review gate and checkpoint to ensure atomic spec discipline across all parallel branches.

How do I orchestrate subagents to work on separate git worktrees?

Orchestrate subagents by loading the MasterSpec, allocating worktrees for each independent workstream, and dispatching the first implementers into their respective isolated environments. The pipeline tracks progress from atomization to automated merge.

Do I need a MasterSpec to use automated worktree allocation for concurrent workstreams?

A MasterSpec is required for automated worktree allocation in this context. The orchestration pipeline relies on MasterSpec loading and validation to generate atomic specs and coordinate three or more concurrent workstreams effectively.

What is the best way to merge parallel git worktrees after concurrent development?

The best way to merge parallel git worktrees is through a managed merge queue. After passing convergence validation and security gates, the pipeline drives automated merges with built-in checkpoints and rollback safeguards for post-merge recovery.

Can I roll back changes if a multi-workstream merge fails during convergence?

You can roll back failed multi-workstream merges using the pipeline's built-in rollback safeguards. The staged workflow includes checkpoints at each phase, from atomization to merge, ensuring controlled recovery if convergence validation fails.