diff --git a/AGENTS.md b/AGENTS.md index 4a8edcb0..9da78b50 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -107,6 +107,7 @@ src/ - Prefer short-lived task branches over a long-lived `develop` branch unless the user explicitly asks for a staging branch workflow. - Use worktrees only when parallel tasks need isolated checkouts. One active task branch per worktree. - If a new task is unrelated to the currently checked out branch, do not stack it on that branch. Create a new worktree from `master` and create a separate short-lived task branch there. +- Always give a new worktree a descriptive name that reflects the task (e.g. `fix-login-redirect`, not `wt1`, `tmp`, `feature`, or a numbered slug), so it can be identified at a glance in a long list of worktrees. When using `./scripts/create-task-worktree.sh`, the `` argument must be that descriptive name. - Prefer `./scripts/create-task-worktree.sh ` when you need a new task worktree and do not have a stronger repo-specific reason to create it manually. - Treat branch and worktree as different things: the branch is the change set; the worktree is the checkout where that branch is worked on. - For parallel unrelated tasks, give each task its own branch from `master`, its own worktree, and its own PR into `master`.