worktree-init

Create a git worktree for a bd issue. Use when spawning a worker agent for an issue. Keywords: worktree, worker, spawn, parallel, issue.

📖 中文导读:Create a git worktree for a bd issue. Use when spawning a worker agent for an issue. Keywords: worktree, worker, spawn, parallel, issue. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: worktree-init description: "Create a git worktree for a bd issue. Use when spawning a worker agent for an issue. Keywords: worktree, worker, spawn, parallel, issue."

worktree-init

Creates a git worktree configured for Claude Code agents to work on a bd issue.

Workflow

When asked to spawn a worker or create a worktree for an issue:

  1. Get issue details: bd show <issue-id>

  2. Create branch name from issue type + title slug:

    • bug → fix/short-description
    • feature → feat/short-description
    • task, chore, epic → chore/short-description

    Example: Issue "Add dark mode toggle" (feature) → feat/dark-mode-toggle

  3. Create worktree:

    worktree-init feat/dark-mode-toggle
    
  4. Output for user - provide the command to start the worker:

    cd ../mentorfy-feat/dark-mode-toggle && claude "bd show mt-xyz && work on this issue"
    

What worktree-init creates

../<project>-<branch> with:

  • Beads redirect (shared issue database)
  • Symlinked .mcp.json (MCP servers)
  • Symlinked .claude/ (settings & skills)
  • Copied .env* files

Cleanup

bd worktree remove ../<worktree-path> --force