# Orchestrate

> Use when bounded fan-out, multi-agent research, cross-family review, parallel audits, Herdr control, or autonomous ready-issue implementation helps. Not for tiny work, coupled debugging, or run-until-STOP jobs; use diagnose or autopilot.

- **Type:** Skill
- **Install:** `agentstack add skill-mblauberg-provenant-orchestrate`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [mblauberg](https://agentstack.voostack.com/s/mblauberg)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [mblauberg](https://github.com/mblauberg)
- **Source:** https://github.com/mblauberg/provenant/tree/main/skills/orchestrate

## Install

```sh
agentstack add skill-mblauberg-provenant-orchestrate
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Multi-agent orchestration

## Overview

Decompose -> waves -> reduce -> gate.

## Rules

- **Use parallel fan-out only after the decomposition/value gate passes.**
- Preflight dependencies/shared errors.
- **No concurrent shared-state writes.** Partition authorised writers into
  repository `.worktrees/`; otherwise use a serial applier.
- Parallel lanes stop ready-to-merge. The chair merges serially, refreshes the
  next branch from current main, then reruns checks and reviews after commit/tree
  changes.
- **Keep topology exact.** One chair; leaders settle recursive obligations.
  Handoff is a generation-bound operator action.
- **Answer-bearing external work uses Fabric request/reply; Herdr only wakes.**
  Pane injection is fire-and-forget steering. Without callback, record
  `FABRIC-ROUNDTRIP-UNAVAILABLE` and collect an artifact.
- Record worker cwd; never assume repository.
- **Workers write full output to files**; return a digest/path.
- **Cross-family follows the HARNESS risk ladder.** Targeted lenses plus other
  primary; distinct family when available; record terminal skips.
- **Objective checks outrank opinions. You own the final call.**
- Discover current model/tool options at runtime.

## When This Pays

Before parallel dispatch, require:

- independent information or artefacts;
- stable interfaces and dependencies;
- non-overlapping writes;
- independently checkable return contracts; and
- expected information gain greater than coordination, shared-state and
  tool-density cost.

If the gate fails, keep serial ownership with the chair or one specialist;
shared-error or tightly coupled work stays serial. Choose the smallest
passing topology.

## Adaptive Loop

1. Preflight authority/isolation/disclosure/receipts.
2. Use **native same-session subagents** first. **Use same-family CLI only for
   auth/preflight smoke tests**.
3. Dispatch parallel read/partitioned-write and serial shared-state waves;
   adapt leaders on evidence and keep one chair/stage owner.
4. Reduce to a claim/conflict map; verify the live tree before repair.
5. Add only informative waves: narrow, repair, verify, **cross-family broad
   review**, or **Document update wave**.
6. **Final gate:** no untriaged P0/P1, missing anchors, unresolved doc drift,
   unrecorded family status or user gate. Record `CROSS-FAMILY-NOT-RUN` when
   disclosure or availability prevents dispatch.

## Worker Contract

Every worker gets task class, route (`tier`, `model`, `effort`, route receipt),
identity, objective, authority, paths, output, checks, stop and budget;
validate payloads, never infer permission.
See [orchestration-contract.md](references/orchestration-contract.md) for the
full contract, gates and recovery transitions.

## Autonomous-implementation mode

Pulls **accepted/ready** issues through `implement` unattended. Merge stays
user-controlled by default, deferring to the nearest repository merge policy.
Lower authority than autopilot's run-until-STOP loop. See [autonomous-implementation.md](references/autonomous-implementation.md)
for the entry gate, loop, receipt contract and the autopilot distinction.

## References

Load relevant [references](references/) only:
`trigger-boundary.md`, `routing-and-tiers.md`, `codex-subagents.md`,
`orchestration-contract.md`, `dynamic-workflows.md`, `paired-primary.md`,
`herdr-panes.md`, `layering-and-context.md`, `retrieval-and-tool-routing.md`,
`verification.md`, `cli-headless.md`,
`memory-scratchpad.md`, `evaluation-and-observability.md`,
`domain-adaptation.md`, and `autonomous-implementation.md`. `scripts/` and
`evals/` hold helpers/guards;
`cf_dispatch.sh` is degraded fallback/preflight only.

## Adapter-absent path

Without Console, Herdr or GitHub, emit the skill-owned
[portable kind](portable-workflow.v1.json) from canonical project artifacts. It
grants no Fabric authority or second task owner.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [mblauberg](https://github.com/mblauberg)
- **Source:** [mblauberg/provenant](https://github.com/mblauberg/provenant)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-mblauberg-provenant-orchestrate
- Seller: https://agentstack.voostack.com/s/mblauberg
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.