git:20260630.a387a0a to git:20260713.91029df

1 added, 1 removed. Audit A to A.

---

name: fastapi-new-worktree

description: Use when the user wants a new git worktree created for a task. Picks a kebab-case branch name with a fix/feat/chore/docs/refactor prefix, runs `git worktree add` from the configured base branch, and reports the new path.

---

Create a new git worktree for the task the user described.

1. Read CLAUDE.md to understand the project structure and branching conventions.

2. Create a short, descriptive branch name based on the task (e.g. `fix/login-redirect`, `feat/add-search`).

- 3. Run `git worktree add ../$(basename $PWD)-<branch-name> -b <branch-name> master` to create the worktree from the configured base branch (the trailing start-point keeps the new branch from inheriting whatever branch the user is currently checked out on).

+ 3. Take the current repository's folder name (you already know the working directory — don't compute it with a shell substitution like `$(basename $PWD)`, which isn't portable to Windows shells), then run `git worktree add ../<repo-folder>-<branch-name> -b <branch-name> master` to create the worktree from the configured base branch (the trailing start-point keeps the new branch from inheriting whatever branch the user is currently checked out on).

4. Confirm the worktree was created successfully with `git worktree list`.

5. Tell the user the full path to the new worktree so they can open it.

Rules:

- Always branch from master unless told otherwise.

- Use lowercase kebab-case for branch names.

- Prefix with `fix/`, `feat/`, `chore/`, `docs/`, or `refactor/` as appropriate.

- Do not start work in the worktree — just create it and report the path.

## When NOT to use

- The user just wants a new branch in the current working tree (`git checkout -b`) — worktrees are for parallel checkouts, not branch creation alone.

- A worktree for the same branch already exists — surface the existing path; don't create a duplicate.

- The user is on a non-worktree-friendly hosting setup (some submodule-heavy repos break with worktrees) — flag the risk before creating.