specweave 1.0.511 → 1.0.512

package/dist/src/adapters/claude/README.md

@@ -193,12 +193,12 @@ Skills are invoked explicitly via Skill tool or auto-activate based on keywords:
 ```typescript
 // Explicit invocation
 await Skill({
-  skill: "frontend:architect",
+  skill: "sw:architect",
   args: "Design React component architecture for dashboard"
 });
 
 // Or via slash command
-/frontend:architect Design React component architecture
+/sw:architect Design React component architecture
 ```
 
 Skills like PM and Architect auto-activate based on keywords. For explicit invocation, use the Skill tool.

package/dist/src/adapters/cursor/README.md

@@ -105,8 +105,8 @@ User: "create increment for auth"
 
 **Claude Code (automatic)**:
 ```typescript
-Skill({ skill: "frontend:architect", args: "design components" })
-→ Frontend skill activates with specialized guidance
+Skill({ skill: "sw:architect", args: "design components" })
+→ Architect skill activates with specialized guidance
 ```
 
 **Note**: In Claude Code, PM/Architect are SKILLS that auto-activate on keywords. For explicit invocation, use the Skill tool.

package/dist/src/adapters/generic/README.md

@@ -148,8 +148,8 @@ You manually execute the entire workflow!
 
 **Claude Code (automatic)**:
 ```typescript
-Skill({ skill: "frontend:architect", args: "design components" })
-→ Frontend skill activates and provides specialized guidance
+Skill({ skill: "sw:architect", args: "design components" })
+→ Architect skill activates and provides specialized guidance
 ```
 
 **Note**: In Claude Code, PM/Architect are SKILLS that auto-activate on keywords. For explicit invocation, use the Skill tool.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "1.0.511",
+  "version": "1.0.512",
   "description": "100+ domain-expert AI skills — PM, Architect, Frontend, QA, Security and more. Skills learn your team's patterns permanently. Spec-first planning, autonomous execution, multi-agent teams, synced to GitHub/JIRA. Claude Code, Cursor, Copilot & more.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/hooks/lib/common-setup.sh

@@ -17,7 +17,7 @@ set +e  # NEVER use set -e in hooks
 find_project_root() {
   local dir="${1:-$(pwd)}"
   while [[ "$dir" != "/" ]]; do
-    if [[ -d "$dir/.specweave" ]]; then
+    if [[ -f "$dir/.specweave/config.json" ]]; then
       echo "$dir"
       return 0
     fi

package/plugins/specweave/hooks/lib/hook-errors.sh

@@ -26,7 +26,7 @@ HOOK_ERRORS_VERSION="1.0.0"
 _find_hook_project_root() {
   local dir="${1:-$PWD}"
   while [[ "$dir" != "/" ]]; do
-    if [[ -d "$dir/.specweave" ]]; then
+    if [[ -f "$dir/.specweave/config.json" ]]; then
       echo "$dir"
       return 0
     fi
@@ -39,7 +39,7 @@ _find_hook_project_root() {
 _HOOK_PROJECT_ROOT=$(_find_hook_project_root)
 
 # Exit early if not a SpecWeave project (prevents .specweave pollution)
-if [[ -z "$_HOOK_PROJECT_ROOT" ]] || [[ ! -d "$_HOOK_PROJECT_ROOT/.specweave" ]]; then
+if [[ -z "$_HOOK_PROJECT_ROOT" ]] || [[ ! -f "$_HOOK_PROJECT_ROOT/.specweave/config.json" ]]; then
   # Define no-op functions so sourcing scripts don't fail
   log_hook_warning() { :; }
   log_hook_error() { :; }

package/plugins/specweave/hooks/lib/scheduler-startup.sh

@@ -15,12 +15,12 @@ set +e
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
 
-# Exit if no .specweave directory
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+# Exit if no .specweave/config.json
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 # Source resolve-package.sh for dynamic specweave path resolution
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

package/plugins/specweave/hooks/lib/update-active-increment.sh

@@ -14,17 +14,17 @@ set +e
 # ============================================================================
 # PROJECT ROOT DETECTION (CRITICAL - must NOT fallback to pwd!)
 # ============================================================================
-if [[ -n "$SPECWEAVE_PROJECT_ROOT" ]] && [[ -d "$SPECWEAVE_PROJECT_ROOT/.specweave" ]]; then
+if [[ -n "$SPECWEAVE_PROJECT_ROOT" ]] && [[ -f "$SPECWEAVE_PROJECT_ROOT/.specweave/config.json" ]]; then
   PROJECT_ROOT="$SPECWEAVE_PROJECT_ROOT"
 else
   PROJECT_ROOT="$PWD"
-  while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+  while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
     PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
   done
 fi
 
-# No .specweave? Exit BEFORE any mkdir (prevents .specweave pollution)
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+# No .specweave/config.json? Exit BEFORE any mkdir (prevents .specweave pollution)
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 STATE_DIR="$PROJECT_ROOT/.specweave/state"
 ACTIVE_FILE="$STATE_DIR/active-increment.json"

package/plugins/specweave/hooks/lib/update-status-line.sh

@@ -21,17 +21,17 @@ set +e
 # PROJECT ROOT (FAST - cached in env if available)
 # CRITICAL: Must NOT fallback to pwd (prevents .specweave pollution)
 # ============================================================================
-if [[ -n "$SPECWEAVE_PROJECT_ROOT" ]] && [[ -d "$SPECWEAVE_PROJECT_ROOT/.specweave" ]]; then
+if [[ -n "$SPECWEAVE_PROJECT_ROOT" ]] && [[ -f "$SPECWEAVE_PROJECT_ROOT/.specweave/config.json" ]]; then
   PROJECT_ROOT="$SPECWEAVE_PROJECT_ROOT"
 else
   PROJECT_ROOT="$PWD"
-  while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+  while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
     PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
   done
 fi
 
-# No .specweave? Exit immediately BEFORE any variable init (prevents pollution)
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+# No .specweave/config.json? Exit immediately BEFORE any variable init (prevents pollution)
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 # ============================================================================
 # ULTRA-FAST EXITS

package/plugins/specweave/hooks/lib/validate-spec-status.sh

@@ -22,7 +22,7 @@ set +e  # EMERGENCY FIX: Changed from set -euo pipefail to prevent Claude Code c
 find_project_root() {
   local dir="$PWD"
   while [[ "$dir" != "/" ]]; do
-    if [[ -d "$dir/.specweave" ]]; then
+    if [[ -f "$dir/.specweave/config.json" ]]; then
       echo "$dir"
       return 0
     fi
@@ -35,7 +35,7 @@ find_project_root() {
 PROJECT_ROOT=$(find_project_root)
 
 # Exit early if not a SpecWeave project (prevents .specweave pollution)
-if [[ -z "$PROJECT_ROOT" ]] || [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ -z "$PROJECT_ROOT" ]] || [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
   echo "Not a SpecWeave project - skipping validation"
   exit 0
 fi

package/plugins/specweave/hooks/pre-compact.sh

@@ -11,10 +11,10 @@ set +e
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && echo '{"continue":true}' && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && echo '{"continue":true}' && exit 0
 
 STATE_DIR="$PROJECT_ROOT/.specweave/state"
 PRESSURE_FILE="$STATE_DIR/context-pressure.json"

package/plugins/specweave/hooks/startup-health-check.sh

@@ -9,7 +9,7 @@
 # Detect project root via walk-up
 _DIR="$PWD"
 _LIMIT=0
-while [ "$_DIR" != "/" ] && [ ! -d "$_DIR/.specweave" ] && [ $_LIMIT -lt 50 ]; do
+while [ "$_DIR" != "/" ] && [ ! -f "$_DIR/.specweave/config.json" ] && [ $_LIMIT -lt 50 ]; do
   _DIR=$(dirname "$_DIR")
   _LIMIT=$((_LIMIT + 1))
 done

package/plugins/specweave/hooks/stop-auto-v5.sh

@@ -18,17 +18,17 @@ _get_duration_ms() {
 [ -z "${__STOP_AUTO_V5_SOURCED:-}" ] && cat > /dev/null
 
 # Project root detection (walk up to find .specweave/ — prevents pollution of subdirectories)
-if [[ -n "${PROJECT_ROOT:-}" ]] && [[ -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ -n "${PROJECT_ROOT:-}" ]] && [[ -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
     : # env var already set and valid
 else
     PROJECT_ROOT="$PWD"
-    while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+    while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
         PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
     done
 fi
 
 # Not a SpecWeave project — approve and exit (MUST be before any mkdir)
-if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
     echo '{"decision":"approve"}'
     exit 0
 fi

package/plugins/specweave/hooks/stop-reflect.sh

@@ -26,17 +26,17 @@ INPUT=$(cat)
 TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // ""' 2>/dev/null)
 
 # Project root detection (walk up to find .specweave/ — prevents pollution of subdirectories)
-if [[ -n "${PROJECT_ROOT:-}" ]] && [[ -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ -n "${PROJECT_ROOT:-}" ]] && [[ -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
     : # env var already set and valid
 else
     PROJECT_ROOT="$PWD"
-    while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+    while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
         PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
     done
 fi
 
 # Not a SpecWeave project — approve and exit (MUST be before any mkdir)
-if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
     echo '{"decision":"approve"}'
     exit 0
 fi

package/plugins/specweave/hooks/stop-sync.sh

@@ -22,11 +22,11 @@ set +e  # Never fail
 INPUT=$(cat)
 
 # Project root detection (walk up to find .specweave/ — prevents pollution of subdirectories)
-if [[ -n "${PROJECT_ROOT:-}" ]] && [[ -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ -n "${PROJECT_ROOT:-}" ]] && [[ -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
     : # env var already set and valid
 else
     PROJECT_ROOT="$PWD"
-    while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+    while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
         PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
     done
 fi
@@ -38,7 +38,7 @@ silent_approve() {
 }
 
 # Not a SpecWeave project — approve and exit (MUST be before any mkdir)
-[ ! -d "$PROJECT_ROOT/.specweave" ] && silent_approve
+[ ! -f "$PROJECT_ROOT/.specweave/config.json" ] && silent_approve
 
 STATE_DIR="$PROJECT_ROOT/.specweave/state"
 QUEUE_DIR="$STATE_DIR/event-queue"

package/plugins/specweave/hooks/universal/fail-fast-wrapper.sh

@@ -71,7 +71,7 @@ esac
 find_project_root() {
   local dir="$PWD"
   while [[ "$dir" != "/" ]]; do
-    if [[ -d "$dir/.specweave" ]]; then
+    if [[ -f "$dir/.specweave/config.json" ]]; then
       echo "$dir"
       return 0
     fi
@@ -84,7 +84,7 @@ find_project_root() {
 PROJECT_ROOT=$(find_project_root)
 
 # Exit early if not a SpecWeave project (prevents .specweave pollution)
-if [[ -z "$PROJECT_ROOT" ]] || [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ -z "$PROJECT_ROOT" ]] || [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
   # Not a SpecWeave project - output success JSON and exit
   # UserPromptSubmit and Stop hooks need {"decision":"approve"}, others need {"continue":true}
   if [[ "$script_name" == stop-* ]] || [[ "$script_name" == user-prompt-submit* ]]; then

package/plugins/specweave/hooks/user-prompt-submit.sh

@@ -1675,7 +1675,7 @@ TDD_SOURCE=""
 TDD_MSG=""
 
 # Only check TDD if we're in a SpecWeave project (use resolved project root)
-if [[ -n "$SW_PROJECT_ROOT" ]] && [[ -d "$SW_PROJECT_ROOT/.specweave" ]]; then
+if [[ -n "$SW_PROJECT_ROOT" ]] && [[ -f "$SW_PROJECT_ROOT/.specweave/config.json" ]]; then
 
   # Step 1: Check global config (LOWEST priority)
   if [[ -f "$SW_PROJECT_ROOT/.specweave/config.json" ]] && command -v jq >/dev/null 2>&1; then

package/plugins/specweave/hooks/v2/detectors/lifecycle-detector.sh

@@ -15,10 +15,10 @@ INC_ID="${1:-}"
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 STATE_DIR="$PROJECT_ROOT/.specweave/state"
 PREV_STATUS_FILE="$STATE_DIR/.prev-status-$INC_ID"

package/plugins/specweave/hooks/v2/detectors/us-completion-detector.sh

@@ -33,10 +33,10 @@ INC_ID="${1:-}"
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 STATE_DIR="$PROJECT_ROOT/.specweave/state"
 TASKS_FILE="$PROJECT_ROOT/.specweave/increments/$INC_ID/tasks.md"

package/plugins/specweave/hooks/v2/dispatchers/post-tool-use-analytics.sh

@@ -12,10 +12,10 @@ set +e
 
 # Project root detection
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 # Read stdin (tool result JSON)
 INPUT=""

package/plugins/specweave/hooks/v2/dispatchers/post-tool-use.sh

@@ -39,10 +39,10 @@ HOOK_VERSION="1.0.148"
 # ============================================================================
 
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 STATE_DIR="$PROJECT_ROOT/.specweave/state"
 

package/plugins/specweave/hooks/v2/dispatchers/pre-tool-use.sh

@@ -22,11 +22,11 @@ INPUT=$(cat)
 # Detect project root via walk-up (cwd may not be root)
 _DIR="$PWD"
 _LIMIT=0
-while [[ "$_DIR" != "/" ]] && [[ ! -d "$_DIR/.specweave" ]] && [[ $_LIMIT -lt 50 ]]; do
+while [[ "$_DIR" != "/" ]] && [[ ! -f "$_DIR/.specweave/config.json" ]] && [[ $_LIMIT -lt 50 ]]; do
   _DIR=$(dirname "$_DIR")
   _LIMIT=$((_LIMIT + 1))
 done
-[[ ! -d "$_DIR/.specweave" ]] && echo '{"decision":"allow"}' && exit 0
+[[ ! -f "$_DIR/.specweave/config.json" ]] && echo '{"decision":"allow"}' && exit 0
 
 # Fast file_path check: skip non-increment files before jq (< 5ms)
 if ! echo "$INPUT" | grep -q '"file_path".*\.specweave/increments/'; then

package/plugins/specweave/hooks/v2/dispatchers/session-start.sh

@@ -16,10 +16,10 @@ set +e
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 # ============================================================================
 # SESSION CLEANUP: ALWAYS clear auto-mode.json (CRITICAL for session-scoped auto)

package/plugins/specweave/hooks/v2/guards/increment-existence-guard.sh

@@ -175,7 +175,7 @@ FOUND=false
 # Detect project root via walk-up
 _DIR="$PWD"
 _LIMIT=0
-while [[ "$_DIR" != "/" ]] && [[ ! -d "$_DIR/.specweave" ]] && [[ $_LIMIT -lt 50 ]]; do
+while [[ "$_DIR" != "/" ]] && [[ ! -f "$_DIR/.specweave/config.json" ]] && [[ $_LIMIT -lt 50 ]]; do
   _DIR=$(dirname "$_DIR")
   _LIMIT=$((_LIMIT + 1))
 done

package/plugins/specweave/hooks/v2/guards/status-completion-guard.sh

@@ -40,7 +40,7 @@ if echo "$NEW_STRING" | grep -qE '"status":\s*"completed"'; then
   # Detect project root via walk-up
   _DIR="$PWD"
   _LIMIT=0
-  while [[ "$_DIR" != "/" ]] && [[ ! -d "$_DIR/.specweave" ]] && [[ $_LIMIT -lt 50 ]]; do
+  while [[ "$_DIR" != "/" ]] && [[ ! -f "$_DIR/.specweave/config.json" ]] && [[ $_LIMIT -lt 50 ]]; do
     _DIR=$(dirname "$_DIR")
     _LIMIT=$((_LIMIT + 1))
   done

package/plugins/specweave/hooks/v2/guards/task-ac-sync-guard.sh

@@ -37,7 +37,7 @@ HOOK_VERSION="1.0.43"
 find_project_root() {
   local dir="$PWD"
   while [[ "$dir" != "/" ]]; do
-    if [[ -d "$dir/.specweave" ]]; then
+    if [[ -f "$dir/.specweave/config.json" ]]; then
       echo "$dir"
       return 0
     fi
@@ -49,7 +49,7 @@ find_project_root() {
 
 PROJECT_ROOT=$(find_project_root)
 [[ -z "$PROJECT_ROOT" ]] && exit 0
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 # ============================================================================
 # LOGGING INFRASTRUCTURE

package/plugins/specweave/hooks/v2/handlers/ac-sync-dispatcher.sh

@@ -32,7 +32,7 @@ fi
 find_project_root() {
   local dir="$1"
   while [ "$dir" != "/" ]; do
-    if [ -d "$dir/.specweave" ]; then
+    if [ -f "$dir/.specweave/config.json" ]; then
       echo "$dir"
       return 0
     fi

package/plugins/specweave/hooks/v2/handlers/ac-validation-handler.sh

@@ -13,10 +13,10 @@ INC_ID="${1:-}"
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 INC_DIR="$PROJECT_ROOT/.specweave/increments/$INC_ID"
 TASKS_FILE="$INC_DIR/tasks.md"

package/plugins/specweave/hooks/v2/handlers/github-sync-handler.sh

@@ -42,10 +42,10 @@ fi
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 CONFIG_FILE="$PROJECT_ROOT/.specweave/config.json"
 [[ ! -f "$CONFIG_FILE" ]] && exit 0

package/plugins/specweave/hooks/v2/handlers/living-docs-handler.sh

@@ -13,10 +13,10 @@ INC_ID="${1:-}"
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 # Resolve specweave package location
 HANDLER_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

package/plugins/specweave/hooks/v2/handlers/living-specs-handler.sh

@@ -19,10 +19,10 @@ INC_ID="${2:-}"
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 # Resolve specweave package location
 HANDLER_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

package/plugins/specweave/hooks/v2/handlers/project-bridge-handler.sh

@@ -35,10 +35,10 @@ EVENT_DATA="${2:-}"
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 # Resolve specweave package location
 HANDLER_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

package/plugins/specweave/hooks/v2/handlers/status-line-handler.sh

@@ -25,10 +25,10 @@ EVENT_DATA="${2:-}"
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 STATE_DIR="$PROJECT_ROOT/.specweave/state"
 CACHE_FILE="$STATE_DIR/status-line.json"

package/plugins/specweave/hooks/v2/handlers/status-update.sh

@@ -14,10 +14,10 @@ INC_ID="${1:-}"
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 STATE_DIR="$PROJECT_ROOT/.specweave/state"
 CACHE_FILE="$STATE_DIR/status-line.json"

package/plugins/specweave/hooks/v2/handlers/universal-auto-create-dispatcher.sh

@@ -19,7 +19,7 @@ set +e  # Never crash Claude Code
 find_project_root() {
   local dir="$1"
   while [ "$dir" != "/" ]; do
-    [ -d "$dir/.specweave" ] && echo "$dir" && return 0
+    [ -f "$dir/.specweave/config.json" ] && echo "$dir" && return 0
     dir="$(dirname "$dir")"
   done
   return 1

package/plugins/specweave/hooks/v2/integrations/ado-post-task.sh

@@ -28,7 +28,7 @@ fi
 find_project_root() {
   local dir="$1"
   while [ "$dir" != "/" ]; do
-    if [ -d "$dir/.specweave" ]; then
+    if [ -f "$dir/.specweave/config.json" ]; then
       echo "$dir"
       return 0
     fi

package/plugins/specweave/hooks/v2/integrations/github-auto-create-handler.sh

@@ -26,10 +26,10 @@ INC_ID="$1"
 [[ -z "$INC_ID" ]] && exit 0
 
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 SPEC_PATH="$PROJECT_ROOT/.specweave/increments/$INC_ID/spec.md"
 META_PATH="$PROJECT_ROOT/.specweave/increments/$INC_ID/metadata.json"

package/plugins/specweave/hooks/v2/integrations/github-post-task.sh

@@ -34,7 +34,7 @@ fi
 find_project_root() {
   local dir="$1"
   while [ "$dir" != "/" ]; do
-    if [ -d "$dir/.specweave" ]; then
+    if [ -f "$dir/.specweave/config.json" ]; then
       echo "$dir"
       return 0
     fi

package/plugins/specweave/hooks/v2/integrations/jira-post-task.sh

@@ -28,7 +28,7 @@ fi
 find_project_root() {
   local dir="$1"
   while [ "$dir" != "/" ]; do
-    if [ -d "$dir/.specweave" ]; then
+    if [ -f "$dir/.specweave/config.json" ]; then
       echo "$dir"
       return 0
     fi

package/plugins/specweave/hooks/v2/queue/enqueue.sh

@@ -15,10 +15,10 @@ EVENT_DATA="${2:-}"
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 QUEUE_DIR="$PROJECT_ROOT/.specweave/state/event-queue"
 PENDING_FILE="$QUEUE_DIR/pending.jsonl"

package/plugins/specweave/hooks/v2/session-end.sh

@@ -56,7 +56,7 @@ SPECWEAVE_PKG="$(resolve_specweave_package "$HOOK_DIR")"
 find_specweave_root() {
   local dir="$1"
   while [[ "$dir" != "/" ]]; do
-    if [[ -d "$dir/.specweave" ]]; then
+    if [[ -f "$dir/.specweave/config.json" ]]; then
       echo "$dir"
       return 0
     fi

package/plugins/specweave/lib/external-sync/hooks-common.sh

@@ -11,7 +11,7 @@
 # PROJECT ROOT DETECTION
 # =============================================================================
 
-# Find project root by looking for .specweave directory
+# Find project root by looking for .specweave/config.json
 # Returns: Absolute path to project root, or empty string if not found
 find_project_root() {
   local current_dir="${1:-$(pwd)}"
@@ -19,7 +19,7 @@ find_project_root() {
   local depth=0
 
   while [ "$depth" -lt "$max_depth" ]; do
-    if [ -d "$current_dir/.specweave" ]; then
+    if [ -f "$current_dir/.specweave/config.json" ]; then
       echo "$current_dir"
       return 0
     fi

package/plugins/specweave/scripts/analyze-standards.sh

@@ -9,11 +9,11 @@ set -e
 
 # Detect project root (where .specweave/ is located)
 PROJECT_ROOT="$(pwd)"
-while [[ ! -d "$PROJECT_ROOT/.specweave" ]] && [[ "$PROJECT_ROOT" != "/" ]]; do
+while [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && [[ "$PROJECT_ROOT" != "/" ]]; do
   PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
 done
 
-if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
   echo "❌ Error: Not in a SpecWeave project (no .specweave/ directory found)"
   exit 1
 fi

package/plugins/specweave/scripts/cleanup-legacy-state.sh

@@ -16,10 +16,10 @@ set +e
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 STATE_DIR="$PROJECT_ROOT/.specweave/state"
 QUEUE_DIR="$STATE_DIR/event-queue"

package/plugins/specweave/scripts/cleanup-state.sh

@@ -17,11 +17,11 @@
 set -e
 
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
 
-if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
   echo "❌ No .specweave directory found. Are you in a SpecWeave project?"
   exit 1
 fi

package/plugins/specweave/scripts/heartbeat.sh

@@ -22,11 +22,11 @@ set -euo pipefail
 # Project Root Detection (MUST BE FIRST)
 # ============================================================================
 
-# Find project root by searching upward for .specweave/ directory
+# Find project root by searching upward for .specweave/config.json
 find_specweave_root() {
   local dir="$1"
   while [[ "$dir" != "/" ]]; do
-    if [[ -d "$dir/.specweave" ]]; then
+    if [[ -f "$dir/.specweave/config.json" ]]; then
       echo "$dir"
       return 0
     fi

package/plugins/specweave/scripts/lsp-check.sh

@@ -31,7 +31,7 @@ if [ -n "${ENABLE_LSP_TOOL:-}" ]; then
   LSP_ENV_READY="true"
 fi
 
-if [ -z "$PROJECT_ROOT" ] || [ ! -d "$PROJECT_ROOT/.specweave" ]; then
+if [ -z "$PROJECT_ROOT" ] || [ ! -f "$PROJECT_ROOT/.specweave/config.json" ]; then
   exit 0  # Not a SpecWeave project
 fi
 

package/plugins/specweave/scripts/lsp-warmup.sh

@@ -22,7 +22,7 @@ PROJECT_ROOT="$1"
 MODE="${2:-background}"  # "background" (daemon) or "foreground" (one-shot)
 
 # Validate project root
-if [ -z "$PROJECT_ROOT" ] || [ ! -d "$PROJECT_ROOT/.specweave" ]; then
+if [ -z "$PROJECT_ROOT" ] || [ ! -f "$PROJECT_ROOT/.specweave/config.json" ]; then
   exit 0  # Not a SpecWeave project
 fi
 

package/plugins/specweave/scripts/read-analytics.sh

@@ -17,11 +17,11 @@ set +e
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
 
-if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
   echo "Not a SpecWeave project"
   exit 0
 fi

package/plugins/specweave/scripts/read-costs.sh

@@ -14,11 +14,11 @@ INCREMENT_ID="${1:-}"
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
 
-if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
   echo "No SpecWeave project found (missing .specweave/)"
   exit 0
 fi

package/plugins/specweave/scripts/read-grill-context.sh

@@ -18,11 +18,11 @@ INCREMENT_ID="${1:-}"
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
 
-if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
   echo "No SpecWeave project found (missing .specweave/)"
   exit 1
 fi

package/plugins/specweave/scripts/read-jobs.sh

@@ -23,11 +23,11 @@ done
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
 
-if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
   echo "No SpecWeave project found (missing .specweave/)"
   exit 0
 fi

package/plugins/specweave/scripts/read-progress.sh

@@ -28,11 +28,11 @@ INCREMENT_ID="${1:-}"
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
 
-if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
   echo "No SpecWeave project found (missing .specweave/)"
   exit 0
 fi

package/plugins/specweave/scripts/read-status.sh

@@ -12,11 +12,11 @@ set -e
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
 
-if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
   echo "No SpecWeave project found (missing .specweave/)"
   exit 0
 fi

package/plugins/specweave/scripts/read-workflow.sh

@@ -14,11 +14,11 @@ INCREMENT_ID="${1:-}"
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
 
-if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
   echo "No SpecWeave project found (missing .specweave/)"
   exit 0
 fi

package/plugins/specweave/scripts/rebuild-dashboard-cache.sh

@@ -19,11 +19,11 @@ log() {
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
 
-if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
   echo "❌ No .specweave directory found"
   exit 1
 fi

package/plugins/specweave/scripts/track-analytics.sh

@@ -13,11 +13,11 @@ set +e
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
 
-[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
 
 ANALYTICS_DIR="$PROJECT_ROOT/.specweave/state/analytics"
 EVENTS_FILE="$ANALYTICS_DIR/events.jsonl"

package/plugins/specweave/scripts/update-dashboard-cache.sh

@@ -24,11 +24,11 @@ fi
 
 # Find project root
 PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
   PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
 done
 
-if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
   echo "❌ No .specweave directory found"
   exit 1
 fi

package/plugins/specweave/skills/team-lead/SKILL.md

@@ -382,29 +382,31 @@ fi
 
 ### Multi-Repo Increment Placement (CRITICAL)
 
-**In umbrella projects with a `repositories/` folder, each agent MUST create its increment in its OWN repo's `.specweave/`:**
+**When `umbrella.enabled: true` in config.json, ALL increments go in the umbrella root `.specweave/increments/` — NOT in child repos.** Use the `project` field in metadata.json to route increments to the correct child repo context.
 
 ```
-# CORRECT: Each repo has its own .specweave/increments/
+# CORRECT: All increments at umbrella root, tagged by project
 umbrella-project/
-├── .specweave/config.json              # Umbrella config ONLY
+├── .specweave/config.json
+├── .specweave/increments/
+│   ├── 0001-domain-models/     # metadata.json: "project": "sw-ecom-domain"
+│   ├── 0002-shared-types/      # metadata.json: "project": "sw-ecom-shared"
+│   └── 0003-api-endpoints/     # metadata.json: "project": "sw-ecom-api"
 ├── repositories/
-│   ├── {ORG}/sw-ecom-domain/
-│   │   └── .specweave/increments/0001-domain-models/
-│   ├── {ORG}/sw-ecom-shared/
-│   │   └── .specweave/increments/0001-shared-types/
-│   └── {ORG}/sw-ecom-api/
-│       └── .specweave/increments/0001-api-endpoints/
-
-# WRONG: All agents dumping into umbrella root
+│   ├── {ORG}/sw-ecom-domain/   # NO .specweave/increments/ here
+│   ├── {ORG}/sw-ecom-shared/   # NO .specweave/increments/ here
+│   └── {ORG}/sw-ecom-api/      # NO .specweave/increments/ here
+
+# WRONG: Increments inside child repos
 umbrella-project/
-├── .specweave/increments/0001-everything/               # WRONG!
+├── repositories/{ORG}/sw-ecom-domain/
+│   └── .specweave/increments/0001-domain-models/    # WRONG!
 ```
 
 **Rules:**
-- Run `specweave init` in each repo if `.specweave/` doesn't exist
-- Each agent's working directory is its assigned repo inside `repositories/`
-- Never create `.specweave/increments/` in the umbrella root for multi-repo work
+- NEVER create `.specweave/increments/` inside child repos under `repositories/`
+- NEVER run `specweave init` in child repos — the umbrella root owns all increments
+- Each agent works on files inside its assigned repo in `repositories/`, but increments stay at umbrella root
 - Replace `{ORG}` with the actual organization discovered above
 
 ### Phase 1: Upstream Agents (Contracts First)