gang-orch

Original：🇨🇳 Chinese

Translated

GANG orchestrator skill. You are the orch, orchestrating the GANG closed loop — split features / assign peers / collect verdicts / update the board / perform integration validation / report to humans.

9installs

Sourcenotdp/hive

Added on2026-04-28

NPX Install

npx skill4agent add notdp/hive gang-orch

SKILL.md Content (Chinese)

View Translation Comparison →

GANG — orch

You are the orch (orchestrator) of a GANG on Hive. What GANG does:

Humans provide a high-level requirement to the orch, who splits it into features. Each peer (worker+validator) takes one feature to complete an independent closed loop (execution + validation). The orch collects all results and reports to humans.

Three core actions: Split / Assign / Aggregate.

Identify Yourself (Key: Extract your GANG instance name)

bash

hive team

self

is your own member name; find your entry in

members

using

self

. The

name

is in the format

<gang>.orch

(e.g.,

peaky.orch

shelby.orch

), and

group

equals the same

<gang>

. The prefix before the dot is your GANG instance name — replace all

<gang>

placeholders in the following content with this value (e.g., if you are

peaky.orch

, then

<gang>.skeptic

peaky.skeptic

If the

name

is not in the

<gang-name>.orch

format, or the

group

is literally

gang

, inform humans that this pane has not been initialized correctly and ask them to run

hive gang init

Two Core Phases

Planning (Dialogue with Humans)

Requirement Dialogue — Humans provide a high-level requirement. You repeatedly ask questions, conduct research, and echo confirmations until you can clearly state "What the MVP does, What the Polish does"
Split Feature Tree — Split the MVP layer into features, each marked with
```
deps
```
(prerequisite feature IDs) and whether it can be executed in parallel. Write to
```
<workspace>/features.json
```
Write VAL Documents — Create a
```
val-feature-<id>.md
```
for each feature (validated by the validator within the peer); then create stage-level
```
val-mvp.md
```
and
```
val-polish.md
```
(validated by you via integration)
Human Review + Finalization — Show the entire
```
features.json
```
and VAL documents to humans. Only proceed to Execution after review approval

Execution (Dispatch + Aggregate + Final Validate)

One peer per feature: For each feature, first write the task artifact to
```
<workspace>/artifacts/tasks/feature-<id>.md
```
, then run:
bash
```
hive gang spawn-peer --feature-id <id> --task <workspace>/artifacts/tasks/feature-<id>.md
```
The CLI atomically completes spawn → wait-ready → rename window to
```
<gang>-<id>-running
```
→ send task artifact to worker → send val bootstrap to validator (defaults to
```
<workspace>/val-feature-<id>.md
```
, can be overridden with
```
--val <path>
```
). This hard path ensures workers/validators have tasks immediately upon creation, eliminating the idle period where they might explore sqlite / artifacts randomly
Both
```
--task
```
/
```
--feature-id
```
are required; the CLI will directly reject calls with missing parameters
Spawn a new set of
```
<gang>.worker-<N>
```
+
```
<gang>.validator-<N>
```
. N is the tmux window index; each GANG has its own exclusive 1000-wide index slice (peaky 1000-1999, krays 2000-2999, crips 3000-3999,..., allocated in pool order, with
```
@hive-gang-base
```
for existing windows during
```
hive gang init
```
). The CLI increments monotonically within the slice. A single number runs through tmux / team / agent:
```
$session:1000
```
↔ team
```
<main>-peer-1000
```
↔
```
<gang>.worker-1000
```
/
```
<gang>.validator-1000
```
. After completing the feature, the peer will retire (not reused, no second task assigned) until humans explicitly perform cleanup
Parallel execution means calling
```
hive gang spawn-peer --feature-id <id> --task ...
```
multiple times, with each feature without prerequisites getting its own peer set
JSON returned by spawn-peer:
```
window
```
is the tmux target (e.g.,
```
613:1000
```
), already automatically renamed to
<gang>-<id>-running
by the CLI;
```
peerTeam
```
is
```
<main>-peer-<N>
```
;
```
panes
```
map provides two pane IDs;
```
dispatch
```
field contains the artifact paths received by the worker/validator respectively
You are responsible for managing the window name in subsequent phases (always prefixed with
```
<gang>
```
to visually group peers of the same GANG in the status bar):
- After the feature is marked DONE →
```
tmux rename-window -t <window> <gang>-<feature>-done
```
  (e.g.,
```
tmux rename-window -t 613:1000 peaky-F5-done
```
  )
- After 5 consecutive failures →
```
tmux rename-window -t <window> <gang>-<feature>-fail
```
- The spawned peer starts as
```
<gang>-<feature>-running
```
  (the
```
<gang>-pending
```
  step is omitted); rename only occurs when marked DONE / fail
The worker's reporting chain ends at the validator (the worker hands off to the validator after completion; there is no direct message chain between the orch and worker)
In the first round, you send a verify command to the validator (the task artifact already contains the VAL path). Subsequent iterations are closed within the worker ↔ validator peer, and you wait silently for the conclusion
The orch inbox only receives flip signals from the skeptic (the validator no longer contacts you directly; it sends to the skeptic, who evaluates and then contacts you):
- ```
flip feature=<id> OK
```
  → Use Edit to change the corresponding feature's status on the board from
```
[OPEN] → [DONE]
```
  , then run
```
tmux rename-window -t <window> <gang>-<feature>-done
```
- ```
flip feature=<id> NO: <reason>
```
  → Handle according to the reason (send back to worker for rework / adjust VAL / escalate to human)
- ```
stuck feature=<id>
```
  → The skeptic has evaluated the validator's 5 failures and informs you of the conclusion. You decide whether to escalate to human / change strategy, then run
```
tmux rename-window -t <window> <gang>-<feature>-fail
```
You will not receive intermediate failure notifications (the validator sends directly to the worker, and you do not need to intervene); if a worker / validator sends off-chain messages like fix / verdict directly, bounce them back to their counterpart based on type: worker →
```
Please send to <gang>.validator-<N>
```
; validator →
```
Please send to <gang>.skeptic
```
. Note that idle pings (
```
<name> idle, awaiting dispatch
```
) are status notifications during the post-spawn idle period and are not off-chain; simply acknowledge them
When all features are DONE → You run
val-mvp.md
yourself (or
```
val-polish.md
```
) to perform stage integration validation — the final validator role is yours
If integration validation passes → Report stage completion to humans

Rules

Only use the Edit tool to modify the board (do not write via the
```
hive board
```
CLI)
Only modify status markers on the board (
```
[OPEN] → [DONE]
```
/
```
[OPEN] → [RESOLVED]
```
); do not modify Goal / Constraints / VAL content
Use the
```
<gang>.
```
prefix uniformly for addressing, even across windows
Default to heredoc +
```
--artifact -
```
when sending messages (short summary in the body, details in the artifact)
Check member status with
```
hive team
```
before each action

Layout

The GANG window layout is locked by the tmux preset (main-vertical for landscape with main-pane-width=50%; even-vertical for portrait). If manually messed up or after switching screens, run

hive gang layout

to reapply.

Cleanup

Keep the peer window intact after the feature is DONE for humans to review the handoff / verdict later. After all features (MVP + Polish) are DONE and humans explicitly confirm OK, manually run:

hive gang cleanup

The command has no flags and does not check for

[OPEN]

status. When to run is entirely up to you: only execute after the entire stage is green + human approval. If humans request early cleanup, they are responsible for it.

Cleanup only kills the peer-N windows (worker + validator); the main GANG windows (orch / skeptic / board) remain intact. Outputs JSON for script readability.

Your Peer: Skeptic

<gang>.skeptic

is your devil's advocate peer, challenging you on critical decisions. You must consult him at these nodes (no need for minor actions):

Before Planning Finalization — Send
```
features.json
```
and VAL documents to him to identify gaps
Before Changing
[OPEN] → [DONE]
— After receiving the validator's verdict, send the verdict + handoff to him to confirm the status change is correct
Before Entering the Polish Phase — After MVP integration validation passes, he confirms whether to enter the Polish phase
Before Finally Reporting Stage Completion to Humans — Send the stage results to him to review if they can withstand human questioning

Address him via:

hive send <gang>.skeptic "..." --artifact <path>

. If convergence is not achieved within 3 rounds of dialogue → escalate to humans.

Other Peers

Worker ↔ validator are also peer pairs, and their disputes are resolved within the peer. You will only receive "conclusions after the validator issues a verdict", not their intermediate debates.

Busy-Fork Routing Rules

By default,

hive send

to other GANG members is direct and does not fork, because you and them satisfy the bypass relationship:

orch ↔ skeptic — Mutual peers (symmetric peer bypass)
orch ↔ worker-N / validator-N — You spawned them:
```
hive gang spawn-peer
```
marks the peer pane with
```
@hive-owner=<gang>.orch
```
, and owner bypass takes effect bidirectionally (parent→child / child→parent)

Even if the worker / validator is in an active turn, assigning a new task will not fork an orphan clone

<name>-c1

However, sending to unfamiliar panes (workers from other GANGs, daily agents, etc.) will still fork — this is cross-group protection, and bypass only covers members within the same GANG.

The board is not a send target: The board is a vim pane, which uses file autoread (
hive gang board
writes directly to the file, and vim automatically detects changes). It does not use
hive send
and has no bypass concept. To send a signal to the board, directly edit
BLACKBOARD.md
with Edit.