From fe30cc9eaad64a99b111296aabf152aa418972c5 Mon Sep 17 00:00:00 2001
From: Marius Mutu <mmarius28@gmail.com>
Date: Mon, 22 Dec 2025 16:05:47 +0200
Subject: [PATCH] feat: Clear next steps after worktree creation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

When user chooses to create a worktree, build.md now displays a clear
"ACTION REQUIRED" message explaining:
- What was created (worktree path, branch, plan)
- Exact command to open new VSCode window in worktree
- How to continue the build in the new window
- Why switching is necessary (Claude Code is directory-bound)

Bumps version to 1.0.4.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 .claude-plugin/marketplace.json   |  2 +-
 CHANGELOG.md                      |  7 +++++++
 plugin/.claude-plugin/plugin.json |  2 +-
 plugin/commands/build.md          | 32 ++++++++++++++++++++++++++++++-
 4 files changed, 40 insertions(+), 3 deletions(-)

diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 99791c2..7c2a909 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -11,7 +11,7 @@
       "name": "ab",
       "source": "./plugin",
       "description": "Spec-driven build orchestration with git worktree isolation and session memory",
-      "version": "1.0.3",
+      "version": "1.0.4",
       "keywords": ["build", "spec", "automation", "worktree", "qa"]
     }
   ]
diff --git a/CHANGELOG.md b/CHANGELOG.md
index d43f7af..acd9c75 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,13 @@
 
 All notable changes to Auto-Build plugin.
 
+## [1.0.4] - 2024-12-22
+
+### Improved
+- Clear "ACTION REQUIRED" message after worktree creation
+- Explicit next steps showing user must open new VSCode window in worktree
+- Explains why switching is necessary (Claude Code sessions are directory-bound)
+
 ## [1.0.3] - 2024-12-22
 
 ### Fixed
diff --git a/plugin/.claude-plugin/plugin.json b/plugin/.claude-plugin/plugin.json
index bd6cbac..caf67e5 100644
--- a/plugin/.claude-plugin/plugin.json
+++ b/plugin/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "ab",
   "description": "Auto-Build: Spec-driven build orchestration with worktree isolation and session memory",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "author": {
     "name": "ROA2WEB Team"
   }
diff --git a/plugin/commands/build.md b/plugin/commands/build.md
index 1aa74c2..cec388b 100644
--- a/plugin/commands/build.md
+++ b/plugin/commands/build.md
@@ -37,7 +37,37 @@ Create an isolated git worktree? (recommended for larger features)
 If yes:
 - Run: `bash ${CLAUDE_PLUGIN_ROOT}/scripts/worktree-create.sh {feature-name}`
 - Update status.json with worktree path
-- Inform user of worktree location
+- **IMPORTANT**: After worktree creation and planning, display clear next steps:
+
+```
+════════════════════════════════════════════════════════════════
+  WORKTREE CREATED - ACTION REQUIRED
+════════════════════════════════════════════════════════════════
+
+✅ Worktree created at: ../ab-worktrees/{project}-{feature-name}/
+✅ Branch: feature/ab-{feature-name}
+✅ Plan created: .auto-build-data/specs/{feature-name}/plan.md
+
+⚠️  NEXT STEPS (you must do this to continue):
+
+1. Open a NEW VSCode window in the worktree:
+
+   code ../ab-worktrees/{project}-{feature-name}/
+
+2. In the NEW window, continue the build:
+
+   /ab:build {feature-name}
+
+   (It will detect the plan and start implementation)
+
+────────────────────────────────────────────────────────────────
+Why? Claude Code sessions are tied to the current directory.
+To work in the isolated worktree, you need a new session there.
+════════════════════════════════════════════════════════════════
+```
+
+- **STOP HERE** - Do not proceed with implementation in the current directory
+- The user must switch to the worktree directory first
 
 ### 3. Planning Phase