DOCS · REFERENCE · COMMANDS · BUILD

stop-review-team/synthex:stop-review-team

Build

Drain in-flight reviews and shut down one or all standing review pools.

Invocation

Run from inside Claude Code in any project where Synthex is installed:

/synthex:stop-review-team

Some commands accept parameters; see the source-of-truth file linked below for the full parameter list and workflow.

Lifecycle phase

Build. Parallel-executed, peer-reviewed task delivery.

Source

The command's parameters, workflow, and sub-agent invocations are defined in markdown at bluminal/lumenai/blob/main/plugins/synthex/commands/stop-review-team.md.

Last modified:

What it does, end-to-end

stop-review-team/synthex:stop-review-team shuts down one standing review pool, or all of them. It asks the Pool Lead to stop, gives in-flight reviews a chance to finish, then removes the pool from the shared index at ~/.claude/teams/standing/index.json.

  1. Picks the target. --name stops one pool, --all stops every pool in the index. With neither, it shows a table of pools (name, roster, multi-model, tasks, idle time, TTL remaining, state) and asks which one to stop.
  2. Checks for in-progress reviews. If a pool has any, it asks before stopping, since those callers won't get their results. Answering no skips that pool. --force skips the question.
  3. Sends the shutdown signal to the Pool Lead.
  4. Waits up to 30 seconds for the Pool Lead to confirm.
  5. Removes the index entry under the same cross-session lock start-review-team/synthex:start-review-team uses.
  6. Prints a per-pool summary.

Like the other pool commands, it needs the Agent Teams tools (SendMessage and ListAgents) and stops with a notice on hosts without them.

Parameters

ParameterDescriptionDefaultRequired
namePool to stopAsks you, after listing poolsNo
allStop every standing poolfalseNo
forceSkip the in-progress review warningfalseNo

Examples

# Stop one pool
/synthex:stop-review-team --name review-pool

# Stop everything, without the in-progress prompt
/synthex:stop-review-team --all --force

# Pick from a list
/synthex:stop-review-team

Outcomes

Standing pool shutdown complete.

| Pool        | Status                                         |
|-------------|------------------------------------------------|
| review-pool | Stopped cleanly                                |
| mm-pool     | Force-stopped (in-flight tasks abandoned)      |
| full-pool   | Cleanup needed — see manual instructions above |
  • Stopped cleanly — the Pool Lead confirmed within 30 seconds and nothing was abandoned.
  • Force-stopped — you used --force or confirmed stopping with reviews in progress.
  • Cleanup needed — the 30 seconds ran out while reviews were still running. Wait for them, or re-run with --force.

If the pool is still up after 30 seconds with no reviews in flight, the Pool Lead has most likely crashed. The command removes the index entry anyway and tells you which paths to check for leftover files.

With --all, one pool failing doesn't stop the others; each gets its own row.

What it does not do

  • Change config. standing_pools.enabled stays as it is. To stop routing altogether, run configure-teams/synthex:configure-teams and choose Reset to disabled.
  • Wait forever. After 30 seconds it reports and moves on.

See also

  • Standing review pools
  • list-teams/synthex:list-teams — see what's running before you stop it
  • start-review-team/synthex:start-review-team — start a fresh pool