From 16e3275240bf95812b1c02a8e5463a45d2d45104 Mon Sep 17 00:00:00 2001 From: Florian BRUNIAUX Date: Mon, 2 Mar 2026 17:41:36 +0100 Subject: [PATCH] docs: fix /batch description - parallel worktree agents, not just batch processing /batch orchestrates 5-30 parallel worktree agents for large-scale codebase changes (migrations, refactors, bulk annotations), each opening its own PR. Source: Volvox/Discord official. Co-Authored-By: Claude Sonnet 4.6 --- guide/ultimate-guide.md | 20 +++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) diff --git a/guide/ultimate-guide.md b/guide/ultimate-guide.md index 61fb6e1..4700673 100644 --- a/guide/ultimate-guide.md +++ b/guide/ultimate-guide.md @@ -7483,7 +7483,7 @@ Slash commands are shortcuts for common workflows. | `/plan` | Enter Plan Mode | | `/rewind` | Undo changes | | `/simplify` | Review changed code and fix over-engineering | -| `/batch` | Process multiple items efficiently | +| `/batch` | Large-scale changes via parallel worktree agents | | `/insights` | Generate usage analytics report | | `/exit` | Exit Claude Code | @@ -7774,12 +7774,26 @@ It operates at the architecture and structure level, not at the formatter or lin ### The /batch Command -Also added in v2.1.63, `/batch` is a bundled slash command for processing multiple items efficiently in a single invocation. +Added in v2.1.63, `/batch` orchestrates large-scale codebase changes by distributing work across 5–30 parallel agents in isolated git worktrees, each opening its own pull request. + +#### How It Works + +1. **Research & plan** — analyzes the codebase and breaks the change into independent units +2. **Parallel execution** — spawns 5–30 isolated git worktree agents simultaneously +3. **PR per agent** — each agent completes its portion and opens a pull request + +#### Usage ```bash -/batch +/batch migrate from react to vue +/batch replace all uses of lodash with native equivalents +/batch add type annotations to all JavaScript files ``` +#### When to Use It + +`/batch` is the native equivalent of the parallel worktrees multi-agent pattern (see §15). Use it for large, repetitive, file-level changes that can be split into independent units: migrations, refactors, bulk type annotations, dependency replacements. + > **Note**: Both `/simplify` and `/batch` are bundled slash commands that ship with Claude Code v2.1.63+. No configuration required. ### Custom Commands