worktree-spawn - SKILL.md Agent Skill

name: worktree-spawn description: Spawn an independent Claude instance in a git worktree to work on a task in parallel. Use when the user wants to delegate a task to run independently while continuing the current conversation. argument-hint:

Worktree Spawn

Spawn an independent Claude instance in a separate git worktree to work on a task in parallel.

When to Use

User wants to delegate a task to run independently
Task can be completed without further interaction
User wants to continue working on something else in the current session

Workflow

Determine branch name using author initials (from git config user.initials or git config user.name) and task description
Choose a worktree directory name (typically ../aztec-<feature-name>)
Create the worktree with a new branch
Spawn Claude in the worktree with a detailed task prompt

Command Template

cd $(git rev-parse --show-toplevel) && \
git worktree add -b <author>/<branch-name> ../<worktree-dir-name> && \
cd ../<worktree-dir-name>/yarn-project && \
claude "$(cat <<'EOF'
Task: [Brief task description]

Steps:
1. [Step 1]
2. [Step 2]
...

IMPORTANT: Read CLAUDE.md first to understand the project structure and workflow.

[Any additional context or requirements]
- Working directory: yarn-project in the worktree
- Branch: <author>/<branch-name>
- PR target: next (unless specified otherwise)
EOF
)"

Example

For a task "Fix bug #123 in the sequencer":

cd $(git rev-parse --show-toplevel) && \
git worktree add -b jd/fix-bug-123 ../aztec-fix-bug && \
cd ../aztec-fix-bug/yarn-project && \
claude "$(cat <<'EOF'
Task: Fix bug #123 in the sequencer

Steps:
1. Investigate the issue in sequencer package
2. Implement fix
3. Add tests
4. Compile and run tests
5. Commit and create PR

IMPORTANT: Read CLAUDE.md first to understand the project structure and workflow.
EOF
)"

Key Points

Always go to git root first before creating worktree
Use -b flag to create a new branch
Navigate to yarn-project within the worktree
Always include "Read CLAUDE.md first" in the prompt
Worktree directories are typically named ../aztec-<feature-name>
The spawned Claude instance works independently from the current session
PR target is next unless specified otherwise