claude-sdk-rs: Command for Claude Code

Init Worktree — Create an isolated git worktree for an SDLC spec or task.

Variables

$ARGUMENTS — spec slug with optional task number.

Examples:

• <spec-slug> → worktree name: <spec-slug> at trees/<spec-slug>/
• <spec-slug> 3 → worktree name: <spec-slug>-task3 at trees/<spec-slug>-task3/

The spec slug is the directory name under planning/ (e.g. <spec-slug>, 2.2-learn-paths-accuracy-refresh). This matches the worktree naming /sdlc-task uses, so /clean-worktree can find and merge whatever this command (or /sdlc-task) created.

Instructions

1. If $ARGUMENTS is not provided, stop and print usage:

   Usage: /init-worktree <spec-slug> [task-N]
   Examples:
     /init-worktree <spec-slug>
     /init-worktree <spec-slug> 3
   

2. Parse arguments: split $ARGUMENTS on whitespace. First token is specSlug. If a second token exists and is a number, it is taskNum; otherwise no task number.

3. Derive worktree name: lowercase specSlug, append -task<taskNum> if taskNum is set.

   • <spec-slug> → <spec-slug>
   • <spec-slug> 3 → <spec-slug>-task3

4. Verify CWD is repo root:

   git rev-parse --show-toplevel
   

   If the output does not match the current directory, stop with: "Run this command from the repo root, not from inside a subdirectory."

5. Check for name collision:

   git worktree list
   git branch --list <worktreeName>
   

   • If trees/<worktreeName> appears in worktree list → stop: "Worktree '' already exists. Run /clean-worktree <args> first."
   • If branch <worktreeName> exists but worktree directory does not → stop: "Branch '' exists as an orphan. Delete it first with: git branch -D <worktreeName>"

6. Create the trees directory:

   mkdir -p trees
   

7. Create the worktree without checkout:

   git worktree add --no-checkout trees/<worktreeName> -b <worktreeName>
   

8. Configure sparse checkout (cone mode):

   git -C trees/<worktreeName> sparse-checkout init --cone
   # Cone ALL tracked top-level directories — stack-agnostic, no project layout assumptions.
   git -C trees/<worktreeName> sparse-checkout set $(git ls-tree HEAD --name-only -d | tr '\n' ' ')
   git -C trees/<worktreeName> checkout
   

   git ls-tree HEAD --name-only -d lists every tracked top-level directory, so the cone set adapts to whatever trees the project has (source, tests, docs/, planning/, .claude/, …) without naming any one stack's layout. Root-level files (CLAUDE.md, manifests/lockfiles, build/config files, etc.) are included automatically by cone mode.