hierarchy

Run cli-hierarchy $ARGUMENTS (reference: docs/operations/cli-hierarchy.md) and surface its output unchanged. All logic lives in ai-sdlc-plugin/scripts/hierarchy-dispatch.mjs; this body only resolves the plugin scripts directory and forwards the arguments.

Usage

/ai-sdlc hierarchy
/ai-sdlc hierarchy status
/ai-sdlc hierarchy up --executors 1
/ai-sdlc hierarchy down

• up, status, terminals, brief, down run as given.
• attach <name> and up --attach cannot switch your terminal from inside Claude Code: the script prints the exact shell command to run instead.
• clear, tick, restart, register, route-decision, check-sender, check-repo, executor-start are refused with a one-line explanation: they belong to the dispatch and executor loop bodies.
• No arguments prints cli-hierarchy --help followed by a common-recipes block.
• If the pipeline-cli bin cannot be found, the same install hint as /ai-sdlc doctor is printed.

VS Code terminals

up keeps .vscode/tasks.json current (unless --no-vscode-tasks), as long as the file is absent or carries the ai-sdlc.generated marker. To get one terminal per agent:

1. /ai-sdlc hierarchy up --executors 5 (regenerates the tasks file).
2. In VS Code run Terminal > Run Task > hierarchy: open all agents.

A hand-written tasks.json is never overwritten; merge by hand from /ai-sdlc hierarchy terminals --vscode --print.

Implementation contract

Run from the repository root:

if [ -n "${CLAUDE_PLUGIN_DIR:-}" ]; then
  PLUGIN_SCRIPTS_DIR="$CLAUDE_PLUGIN_DIR/scripts"
elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ]; then
  PLUGIN_SCRIPTS_DIR="$CLAUDE_PLUGIN_ROOT/scripts"
else
  PLUGIN_SCRIPTS_DIR="$(pwd)/ai-sdlc-plugin/scripts"
fi
cd "$(git rev-parse --show-toplevel)"
node "$PLUGIN_SCRIPTS_DIR/hierarchy-dispatch.mjs" $ARGUMENTS

Confirming down

down with no --role stops every session and returns inflight manifests to the queue. The script exits 3 and prints a notice when it is run unconfirmed. When that happens, ask the operator once whether to stop every session; only on a yes, run the same command again with --confirmed appended: