diff --git a/.claude/skills/whats-next/SKILL.md b/.claude/skills/whats-next/SKILL.md index 444fc224d..87c435a42 100644 --- a/.claude/skills/whats-next/SKILL.md +++ b/.claude/skills/whats-next/SKILL.md @@ -188,9 +188,14 @@ git checkout -b If the user wants to work in a separate worktree: +Worktrees live **inside the repo** under the gitignored `.worktrees/` directory +(see `.gitignore` — "created under the repo root"). Never place them in the repo's +parent directory: paths outside the repo are outside the permission sandbox and +break agent file access. + ```bash REPO_ROOT=$(git rev-parse --show-toplevel) -WORKTREE_DIR="$(dirname "$REPO_ROOT")/.worktrees/" +WORKTREE_DIR="$REPO_ROOT/.worktrees/" git worktree add "$WORKTREE_DIR" ```