suijin-orchestrationlisted
Install: claude install-skill Suijin-App/Suijin
# Suijin orchestration
`suijin` is on PATH in every terminal Suijin opened (if not, use `"$SUIJIN_CLI"`). Every command takes `--json`
for a stable machine-readable answer. `suijin help` lists the commands.
## You are a worker
Your prompt starts with a preamble that names your Task ID and Dispatch ID. Follow it:
- Ask your coordinator, then **end your turn**; Suijin types the answer into your terminal:
`suijin ask --body "<question>"`
- Never ask in your own terminal (no AskUserQuestion or other local prompts): nobody watches it.
- When the task is finished or cannot be finished, report exactly once, then end your turn:
`suijin done --status success --summary "<what you did, what you found, what is left>"`
(`--status failed` when the work is not done; never hide a failure in the summary).
- A later message from your coordinator may be a follow-up Task with new IDs; finish it with `suijin done` again.
## You coordinate workers
```sh
suijin worker start --agent codex --spec "<self-contained task>" # in your folder or worktree
suijin worker start --agent claude --worktree new --name fix-login --spec "<task>" # in a new git worktree
suijin worker stop --to <dispatch-id|worker-name> # ends it and closes its tab
```
- Start every independent worker, then **end your turn**. "Report back" and "tell me when it's done" also mean end
your turn: Suijin wakes you by typing each question, result or problem into your terminal