start-worktree

Creates an isolated git branch and worktree for ticketless development work.

1|Updated Aug 6, 2025
One-click install
npx skills add https://github.com/azaidrahman/zaid-sani-dotfiles --skill start-worktree-azaidrahman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: start-worktree
Source: https://github.com/azaidrahman/zaid-sani-dotfiles/tree/main/dot_claude/skills/start-worktree
Command: npx skills add https://github.com/azaidrahman/zaid-sani-dotfiles --skill start-worktree-azaidrahman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Non-trivial work without a Jira ticket still needs isolation from the main checkout. This Skill creates a properly named branch and git worktree before any writes happen, preventing uncommitted changes from mixing into the primary working tree. ## Core Features & Use Cases - Branch naming convention: Enforces a <type>/<slug> scheme using feat, fix, chore, or docs with a lowercase kebab-case slug of 30 characters or less. - Worktree creation via agent-worktree: Runs agent-worktree <type> <slug> to create the branch and worktree at .worktrees/<slug>, with optional --session claude or --session omp flags to launch a new session directly inside the worktree. - Session relocation: Uses the EnterWorktree tool to move an existing session into the worktree, since a plain cd does not persist between commands. - Use Case: You need to refactor tmux session cleanup scripts with no associated ticket. Run agent-worktree fix tmux-session-cleanup, move the session into the new worktree, make all edits there, and finish with finish-branch once the branch lands. ## Quick Start Ask the agent to start ticketless work by running agent-worktree with a type and slug, for example chore/my-config-update, before making any file changes.

Frequently Asked Questions about start-worktree

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a git worktree for work without a Jira ticket?

Run agent-worktree with a branch type and slug, such as agent-worktree chore my-config-update. It creates a branch named <type>/<slug> and a worktree at .worktrees/<slug>, then reports the absolute path for all subsequent writes.

What branch naming convention should I use for ticketless work?

Use one of four types: feat for new capabilities, fix for defect corrections, chore for configuration or maintenance, and docs for documentation. Append a lowercase kebab-case slug kept specific and 30 characters or less.

Why does my session still write to the original checkout after creating a worktree?

A cd command does not move the session because the shell directory resets after each command. Call the EnterWorktree tool with the worktree's absolute path, or start with agent-worktree --session claude or --session omp.

What does exit code 4 from agent-worktree mean?

Exit code 4 means the target path exists but is not the expected worktree. Stop immediately and do not overwrite or remove the existing path.

Can multiple agents write to the same worktree concurrently?

No. One primary writing session owns the worktree. If concurrent writes are required, use isolated task worktrees per agent and integrate their changes only after each agent finishes.