Merge pull request #1123 from obra/feat-add-multi-repo-worktree

feat: add multi-repo worktree guidance (#710)
docs: drop brittle step-number chain from multi-repo row
2026-04-22 17:39:06 +08:00 · 2026-04-13 16:48:44 -07:00 · 2026-04-13 16:30:00 -07:00 · 2026-04-13 16:29:59 -07:00
4 changed files with 16 additions and 0 deletions
--- a/commands/brainstorm.md
+++ b/commands/brainstorm.md
@@ -0,0 +1,5 @@
+---
+description: "Deprecated - use the superpowers:brainstorming skill instead"
+---
+
+Tell your human partner that this command is deprecated and will be removed in the next major release. They should ask you to use the "superpowers brainstorming" skill instead.
--- a/commands/execute-plan.md
+++ b/commands/execute-plan.md
@@ -0,0 +1,5 @@
+---
+description: "Deprecated - use the superpowers:executing-plans skill instead"
+---
+
+Tell your human partner that this command is deprecated and will be removed in the next major release. They should ask you to use the "superpowers executing-plans" skill instead.
--- a/commands/write-plan.md
+++ b/commands/write-plan.md
@@ -0,0 +1,5 @@
+---
+description: "Deprecated - use the superpowers:writing-plans skill instead"
+---
+
+Tell your human partner that this command is deprecated and will be removed in the next major release. They should ask you to use the "superpowers writing-plans" skill instead.
--- a/skills/using-git-worktrees/SKILL.md
+++ b/skills/using-git-worktrees/SKILL.md
@@ -168,6 +168,7 @@ Ready to implement <feature-name>
 | Permission error on create | Sandbox fallback, work in place |
 | Tests fail during baseline | Report failures + ask |
 | No package.json/Cargo.toml | Skip dependency install |
+| Plan touches multiple repos | Create a matching worktree in each repo, same branch name |

 ## Common Mistakes
Author	SHA1	Message	Date
Jesse Vincent	1879a94ac7	Merge pull request #1123 from obra/feat-add-multi-repo-worktree feat: add multi-repo worktree guidance (#710)	2026-04-13 16:48:44 -07:00
Drew Ritter	ddbba8e469	docs: drop brittle step-number chain from multi-repo row Addresses review feedback on #1123. Replaces "(same Step 0→1a→1b flow, matching branch names)" with plain-language instruction that doesn't forward-reference section numbers that could rot under future edits. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-13 16:30:00 -07:00
Drew Ritter	f0728841d8	feat: add multi-repo worktree guidance (#710 )	2026-04-13 16:29:59 -07:00