From xp-stack
[LEGACY — pré-Agent View 2026-05-11] Set up a local parallel-wave orchestrator in this project — copies orchestrate-wave.sh and README to scripts/orchestrate/. The orchestrator dispatches N headless workers (claude -p Sonnet) in isolated git worktrees per task, blocks on BLOCKERS.md discipline, and aggregates a summary. Alternative to remote orchestrators like Paperclip when you want sync local execution without infrastructure. Invoke explicitly via /xp-stack:local-waves-setup. Opt-in.
How this skill is triggered — by the user, by Claude, or both
Slash command
/xp-stack:local-wavesThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
> **Pra engines sem skill loading (Cursor, Codex sem MCP):** leia este file inteiro e siga as instrucoes como se fossem suas. Voce nao precisa "invocar" — apenas obedeca. Cursor e Codex que tem `xp-stack` instalado via npm leem este SKILL.md em `.cursor/rules/` ou `.codex/skills/`.
Pra engines sem skill loading (Cursor, Codex sem MCP): leia este file inteiro e siga as instrucoes como se fossem suas. Voce nao precisa "invocar" — apenas obedeca. Cursor e Codex que tem
xp-stackinstalado via npm leem este SKILL.md em.cursor/rules/ou.codex/skills/.
Legacy notice: Esta skill foi a recomendação canônica antes do lançamento do Agent View nativo do Claude Code (https://claude.com/blog/agent-view-in-claude-code, 11-mai-2026). Pra novos projetos use Agent View via Agent tool nativo (
model: "sonnet"+isolation: "worktree"+ prompt invocacaveman:caveman).local-wavessegue funcional como fallback ou pra projetos que rodam fora do Claude Code (não-interativo, CI, etc.).
Set up a local parallel-wave orchestrator in your project. Optional, opt-in. Invoke explicitly when you decide you want this — the regular bootstrap does NOT install it.
claude -p running Sonnet-class headless in separate git worktrees. They execute 1 task each in parallel.Worker permissions: --permission-mode acceptEdits + --allowedTools with specific allowlist (no --dangerously-skip-permissions). If a worker hits something outside the allowlist OR needs a credential / business decision not provided, it stops, writes BLOCKERS.md in the worktree, commits WIP, and exits without opening a PR. The orchestrator collects this and presents to the Pilot.
xp-stack:paperclip-orchestrator and Agent View| Criterion | local-waves (this) | Paperclip | Agent View (recomendado) |
|---|---|---|---|
| Execution model | Local sync, headless | Remote async, droplet-hosted | Native Claude Code, parallel sessions |
| Latency | Minutes (block-and-summarize) | Hours-days (heartbeat cycle, async review) | Seconds (parallel dispatch) |
| Persistence | None (session-bound) | Yes (DB-backed) | Session-bound (Agent View UI) |
| Multi-developer | No | Yes | No (single Pilot) |
| Infrastructure | None | VPS (~$10/mo) + Anthropic OAuth subscription | None |
| When to choose | Solo, headless, fallback (CI/non-interactive) | Multi-dev async, 24/7 review queue | Solo or pair, interactive — default |
You can install both in the same project; they don't conflict (Paperclip uses local/paperclip/, local-waves uses scripts/orchestrate/).
Each feature you orchestrate must have docs/tasks/{feature-slug}/TERMINAL-PROMPTS.md with this shape:
## Onda 1
### T1 — Title of task 1
` ` `
<prompt body for worker T1>
` ` `
### T2 — Title of task 2
` ` `
<prompt body for worker T2>
` ` `
## Onda 2
### T3 — ...
The script auto-detects the next pending wave from 00-overview.md (looks for tasks not marked [x] Concluida).
Ask via AskUserQuestion:
proceedredirectabortCall via Bash:
bash ${CLAUDE_SKILL_DIR}/scripts/setup-local-waves.sh "$(pwd)"
Summarize what was created and tell the user:
scripts/orchestrate/README.md — modelo mental, ciclo de uso, layout de artefatos, limitações conhecidas..gitignore got 2 new entries (.claude/wave-runs/ and scripts/orchestrate/) — the orchestrator + its run artifacts stay out of git.docs/tasks/<feature-slug>/TERMINAL-PROMPTS.md in the format above. Use the templates from xp-stack:bootstrap (the task-decomposition skill explains this).scripts/orchestrate/orchestrate-wave.sh (search for # Allowlist — currently has generic git/gh/npm/jq; add your stack's commands).$(pwd) — never touches ~/.claude/ global, never modifies other repos.bash scripts/orchestrate/orchestrate-wave.sh run docs/tasks/<feature>/ when ready.Provides behavioral guidelines to reduce common LLM coding mistakes, focusing on simplicity, surgical changes, assumption surfacing, and verifiable success criteria.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
npx claudepluginhub rnobre1/xp-stack --plugin xp-stack