skills.rest
Wirasm
WirasmCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

prp-orchestrate

Coordinates parallel PRP workstreams across isolated git worktrees with gated merges.

2.2k|608|Updated Jun 21, 2025
Search Tags:#parallel agents#gitHub# orchestration#merge queue#Git worktree#Workflow Automation#Pull request
One-click install
npx skills add https://github.com/Wirasm/PRPs-agentic-eng --skill prp-orchestrate
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prp-orchestrate
Source: https://github.com/Wirasm/PRPs-agentic-eng/tree/main/plugins/prp-core/skills/prp-orchestrate
Command: npx skills add https://github.com/Wirasm/PRPs-agentic-eng --skill prp-orchestrate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Running multiple AI coding agents on separate features at once creates chaos: overlapping branches, unverified pull requests, lost context, and no single owner accountable for the combined outcome. This Skill turns one session into an orchestrator that launches, monitors, verifies, and merges parallel PRP workstreams while keeping a durable run record.

Core Features & Use Cases

  • Parallel workstream management: Resolves a concern into workstreams, assigns each to the right PRP skill (prp-issue, prp-plan, prp-implement, prp-review, prp-spike, and others), and launches them as background agents in isolated git worktrees.
  • Verification and merge gating: Requires a live PR, a published READY TO MERGE review of the current head, and green required CI before sequencing merges by dependency and file-overlap risk.
  • Durable run record: Maintains a run file with workstream status, standing decisions, merge queue, event log, and a final handoff, resumable with --resume.
  • Use Case: You have five GitHub issues to ship. Invoke the orchestrator, approve the proposed base branch and workstream table at the first gate, and it delivers merged PRs with verified reviews and CI proof.

Quick Start

Ask the assistant to orchestrate these issues in parallel using /prp-orchestrate followed by your list of issues or features.

Frequently Asked Questions about prp-orchestrate

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

FAQPage Schema
How do I run multiple AI coding agents in parallel on GitHub issues?▼

Invoke /prp-orchestrate with your list of issues or features. It resolves each into a workstream, assigns the appropriate PRP skill, launches background agents in isolated git worktrees, and sequences verified merges against a confirmed base branch.

How does the orchestrator verify a pull request before merging?▼

It requires an open non-draft PR targeting the confirmed base, a published READY TO MERGE review whose reviewed head matches the current headRefOid, and green required CI checks. Without required CI, it runs the repository's authoritative local gate.

Can I resume an interrupted orchestration run?▼

Yes. Run /prp-orchestrate --resume to reload the newest run file from the shared PRP store. The orchestrator reconciles it against the live agent list, gh pr list, and git worktree list before acting.

How are merge conflicts between parallel workstreams handled?▼

The merge queue is built from dependencies and pairwise file overlap of PR diffs, merging the lowest-risk PR first. After each merge, affected owners rebase onto the base, resolve conflicts, revalidate, and recheck CI before the next merge.

What is the maximum number of parallel workstreams?▼

The configured max-parallel defaults to 10 or a user-supplied value via --max-parallel N. Effective concurrency is further limited by harness capacity, calculated as floor((capacity - 1) / 3) delivery owners, with a minimum capacity of four for one delivery.

When should I use prp-orchestrate instead of running prp-issue directly?▼

Use prp-issue directly for a single issue delivery. Use the orchestrator when shipping multiple issues or features in parallel, since it owns cross-workstream coherence, human gates, merge ordering, and the final combined handoff.

Related Skills

Explore More Software Engineering Skills→
kagentikagenti

ralph-it

Analyze GitHub PRDs to recommend the next user story with a concrete plan.

Official
Advanced
product-on-purposeproduct-on-purpose
527

discover-stakeholder-summary

Identify stakeholders and map influence, needs, and relationships into a structured template.

Official
Basic
samzzisamzzi

review-pr

Automate GitHub pull request review and squashed merging with release tagging via gh CLI.

Community
Advanced
moogahmoogah

tasks-orchestrator

Orchestrate parallel OpenSpec task execution with isolated worktrees and agents.

Community
Advanced