Summary
When agents start working on a GitHub issue (e.g. via the tackle-issue flow), they branch out from the current branch directly instead of creating a dedicated git worktree. This blocks multi-agent parallelism because two agents editing the same working tree will collide.
Current behaviour
Agent picks up an issue → creates a branch from the current branch in the main working tree → works there until PR is merged.
Expected behaviour
- On issue start — agent creates a dedicated worktree under
.worktrees/<issue-slug>/ (or equivalent), checks out a fresh branch there, and performs all work in that worktree.
- PRs are opened from the worktree branch — the worktree branch is pushed and the PR is linked to it.
- On PR merge — the worktree is automatically cleaned up (branch deleted,
.worktrees/<slug>/ removed).
Why it matters
- Multiple agents can't safely work on the same codebase simultaneously from the same working tree.
- The worktrees convention already exists (
docs/worktrees.md, feedback_worktrees_required.md, superpowers:using-git-worktrees skill) but is not wired into the issue-tackling entry point.
Acceptance criteria
References
Summary
When agents start working on a GitHub issue (e.g. via the tackle-issue flow), they branch out from the current branch directly instead of creating a dedicated git worktree. This blocks multi-agent parallelism because two agents editing the same working tree will collide.
Current behaviour
Agent picks up an issue → creates a branch from the current branch in the main working tree → works there until PR is merged.
Expected behaviour
.worktrees/<issue-slug>/(or equivalent), checks out a fresh branch there, and performs all work in that worktree..worktrees/<slug>/removed).Why it matters
docs/worktrees.md,feedback_worktrees_required.md,superpowers:using-git-worktreesskill) but is not wired into the issue-tackling entry point.Acceptance criteria
superpowers:using-git-worktrees(or equivalent) before any file edits..worktrees/<issue-slug>/is created for every issue session.docs/worktrees.mdguidance is referenced or updated to cover the issue-tackling entry point.References
docs/worktrees.md— worktree convention.claude/memory/feedback_worktrees_required.md— feedback rulesuperpowers:using-git-worktreesskill