specweave 0.16.11 → 0.16.12

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

@@ -102,10 +102,23 @@ EOF
       if [[ -n "$INCOMPLETE_INCREMENTS" ]]; then
         COUNT=$(echo "$INCOMPLETE_INCREMENTS" | wc -l | xargs)
 
+        # Get incomplete task count for migration guidance
+        MIGRATION_SCRIPT="$(dirname "${BASH_SOURCE[0]}")/lib/migrate-increment-work.sh"
+        INCOMPLETE_TASKS=""
+
+        for increment in $INCOMPLETE_INCREMENTS; do
+          if [[ -x "$MIGRATION_SCRIPT" ]]; then
+            TASK_COUNT=$("$MIGRATION_SCRIPT" count-incomplete "$increment" 2>/dev/null || echo "?")
+            INCOMPLETE_TASKS="${INCOMPLETE_TASKS}\n  - $increment ($TASK_COUNT incomplete tasks)"
+          else
+            INCOMPLETE_TASKS="${INCOMPLETE_TASKS}\n  - $increment"
+          fi
+        done
+
         cat <<EOF
 {
   "decision": "block",
-  "reason": "❌ Cannot create new increment! You have $COUNT incomplete increment(s):\n\n$(echo "$INCOMPLETE_INCREMENTS" | sed 's/^/  - /')\n\n💡 Complete or close them first:\n  - /specweave:done <id>     # Mark as complete\n  - /specweave:pause <id>    # Pause for later\n  - /specweave:abandon <id>  # Abandon if obsolete\n\nℹ️ The discipline exists for a reason:\n  ✓ Prevents scope creep\n  ✓ Ensures completions are tracked\n  ✓ Maintains living docs accuracy\n  ✓ Keeps work focused"
+  "reason": "❌ Cannot create new increment! You have $COUNT incomplete increment(s):$INCOMPLETE_TASKS\n\n💡 **SMART MIGRATION OPTIONS:**\n\n1️⃣  **Transfer Work** (Recommended)\n   Move incomplete tasks to new increment:\n   \`\`\`bash\n   # After creating new increment, run:\n   bash plugins/specweave/hooks/lib/migrate-increment-work.sh transfer <old-id> <new-id>\n   \`\`\`\n   ✅ Clean closure + work continues\n\n2️⃣  **Adjust WIP Limit** (Emergency Only)\n   Temporarily allow 3 active increments:\n   \`\`\`bash\n   bash plugins/specweave/hooks/lib/migrate-increment-work.sh adjust-wip 3\n   \`\`\`\n   ⚠️  20% productivity cost, revert ASAP\n\n3️⃣  **Force-Close** (Quick Fix)\n   Mark increment as complete (work lost):\n   \`\`\`bash\n   bash plugins/specweave/hooks/lib/migrate-increment-work.sh force-close <increment-id>\n   \`\`\`\n   ⚠️  Incomplete work NOT transferred!\n\n📝 **Traditional Options:**\n  - /specweave:done <id>     # Complete properly\n  - /specweave:pause <id>    # Pause for later\n  - /specweave:abandon <id>  # Abandon if obsolete\n\nℹ️ The discipline exists for a reason:\n  ✓ Prevents scope creep\n  ✓ Ensures completions are tracked\n  ✓ Maintains living docs accuracy\n  ✓ Keeps work focused"
 }
 EOF
         exit 0
@@ -114,6 +127,76 @@ EOF
   fi
 fi
 
+# ==============================================================================
+# PRE-FLIGHT SYNC CHECK: Ensure living docs are fresh before operations
+# ==============================================================================
+
+# Detect increment operations that need fresh data
+if echo "$PROMPT" | grep -qE "/(specweave:)?(done|validate|progress|do)"; then
+  # Extract increment ID from prompt (if provided)
+  INCREMENT_ID=$(echo "$PROMPT" | grep -oE "[0-9]{4}[a-z0-9-]*" | head -1)
+
+  # If no ID in prompt, try to find active increment
+  if [[ -z "$INCREMENT_ID" ]] && [[ -d ".specweave/increments" ]]; then
+    INCREMENT_ID=$(find .specweave/increments -mindepth 1 -maxdepth 1 -type d | while read increment_dir; do
+      metadata="$increment_dir/metadata.json"
+      if [[ -f "$metadata" ]]; then
+        status=$(node -e "
+          try {
+            const data = JSON.parse(require('fs').readFileSync('$metadata', 'utf-8'));
+            if (data.status === 'active') {
+              console.log('$(basename "$increment_dir")');
+            }
+          } catch (e) {}
+        " 2>/dev/null)
+
+        if [[ -n "$status" ]]; then
+          echo "$status"
+          break
+        fi
+      fi
+    done)
+  fi
+
+  # If we have an increment ID, check freshness
+  if [[ -n "$INCREMENT_ID" ]]; then
+    INCREMENT_SPEC=".specweave/increments/$INCREMENT_ID/spec.md"
+    LIVING_DOCS_SPEC=".specweave/docs/internal/specs/spec-$INCREMENT_ID.md"
+
+    # Check if increment spec exists
+    if [[ -f "$INCREMENT_SPEC" ]]; then
+      # Get modification times
+      if [[ "$(uname)" == "Darwin" ]]; then
+        # macOS
+        INCREMENT_MTIME=$(stat -f %m "$INCREMENT_SPEC" 2>/dev/null || echo 0)
+        LIVING_DOCS_MTIME=$(stat -f %m "$LIVING_DOCS_SPEC" 2>/dev/null || echo 0)
+      else
+        # Linux
+        INCREMENT_MTIME=$(stat -c %Y "$INCREMENT_SPEC" 2>/dev/null || echo 0)
+        LIVING_DOCS_MTIME=$(stat -c %Y "$LIVING_DOCS_SPEC" 2>/dev/null || echo 0)
+      fi
+
+      # Check if increment is newer than living docs (or living docs doesn't exist)
+      if [[ "$INCREMENT_MTIME" -gt "$LIVING_DOCS_MTIME" ]]; then
+        # Sync needed - run sync-living-docs
+        PLUGIN_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+        SYNC_SCRIPT="$PLUGIN_ROOT/lib/hooks/sync-living-docs.js"
+
+        if [[ -f "$SYNC_SCRIPT" ]]; then
+          # Run sync (capture output but don't block on errors)
+          if node "$SYNC_SCRIPT" "$INCREMENT_ID" >/dev/null 2>&1; then
+            # Success - sync completed
+            :
+          else
+            # Sync failed - log but continue
+            echo "[WARNING] Pre-flight sync failed for $INCREMENT_ID" >&2
+          fi
+        fi
+      fi
+    fi
+  fi
+fi
+
 # ==============================================================================
 # CONTEXT INJECTION: Add current increment status
 # ==============================================================================
@@ -142,20 +225,44 @@ if [[ -d ".specweave/increments" ]]; then
   done)
 
   if [[ -n "$ACTIVE_INCREMENT" ]]; then
-    # Get task completion percentage
-    TASKS_FILE=".specweave/increments/$ACTIVE_INCREMENT/tasks.md"
-    if [[ -f "$TASKS_FILE" ]]; then
-      TASK_STATS=$(grep -E "^\s*-\s*\[[ x]\]" "$TASKS_FILE" 2>/dev/null | wc -l | xargs || echo "0")
-      COMPLETED_TASKS=$(grep -E "^\s*-\s*\[x\]" "$TASKS_FILE" 2>/dev/null | wc -l | xargs || echo "0")
-
-      if [[ "$TASK_STATS" -gt 0 ]]; then
-        PERCENTAGE=$(( COMPLETED_TASKS * 100 / TASK_STATS ))
-        CONTEXT="📍 Active Increment: $ACTIVE_INCREMENT ($PERCENTAGE% complete, $COMPLETED_TASKS/$TASK_STATS tasks)"
+    # Use status line cache for consistent display
+    STATUS_LINE_CACHE=".specweave/state/status-line.json"
+    if [[ -f "$STATUS_LINE_CACHE" ]]; then
+      # Get status line from cache (ultra-fast)
+      STATUS_LINE=$(node -e "
+        try {
+          const { StatusLineManager } = require('./dist/core/status-line/status-line-manager.js');
+          const manager = new StatusLineManager(process.cwd());
+          const result = manager.render();
+          console.log(result || '');
+        } catch (e) {
+          // Fallback: show increment name only
+          console.log('');
+        }
+      " 2>/dev/null || echo "")
+
+      if [[ -n "$STATUS_LINE" ]]; then
+        CONTEXT="✓ $STATUS_LINE"
       else
-        CONTEXT="📍 Active Increment: $ACTIVE_INCREMENT"
+        # Fallback: parse tasks.md manually
+        TASKS_FILE=".specweave/increments/$ACTIVE_INCREMENT/tasks.md"
+        if [[ -f "$TASKS_FILE" ]]; then
+          TASK_STATS=$(grep -E "^\s*-\s*\[[ x]\]" "$TASKS_FILE" 2>/dev/null | wc -l | xargs || echo "0")
+          COMPLETED_TASKS=$(grep -E "^\s*-\s*\[x\]" "$TASKS_FILE" 2>/dev/null | wc -l | xargs || echo "0")
+
+          if [[ "$TASK_STATS" -gt 0 ]]; then
+            PERCENTAGE=$(( COMPLETED_TASKS * 100 / TASK_STATS ))
+            CONTEXT="✓ Active Increment: $ACTIVE_INCREMENT ($PERCENTAGE% complete, $COMPLETED_TASKS/$TASK_STATS tasks)"
+          else
+            CONTEXT="✓ Active Increment: $ACTIVE_INCREMENT"
+          fi
+        else
+          CONTEXT="✓ Active Increment: $ACTIVE_INCREMENT"
+        fi
       fi
     else
-      CONTEXT="📍 Active Increment: $ACTIVE_INCREMENT"
+      # No cache, fall back to increment name only
+      CONTEXT="✓ Active Increment: $ACTIVE_INCREMENT"
     fi
   fi
 fi

package/plugins/specweave/lib/hooks/sync-living-docs.js

@@ -1,144 +1,128 @@
 #!/usr/bin/env node
-/**
- * SpecWeave Living Docs Auto-Sync
- *
- * Automatically syncs living documentation after task completion.
- *
- * Usage:
- *   node dist/hooks/lib/sync-living-docs.js <incrementId>
- *
- * Example:
- *   node dist/hooks/lib/sync-living-docs.js 0006-llm-native-i18n
- *
- * What it does:
- * 1. Checks if sync_living_docs enabled in config
- * 2. Detects changed docs via git diff
- * 3. Invokes /sync-docs update command (future implementation)
- * 4. Logs sync actions
- *
- * @author SpecWeave Team
- * @version 1.0.0
- */
-import fs from 'fs-extra';
-import path from 'path';
-import { execSync } from 'child_process';
-/**
- * Main function - sync living docs for given increment
- */
+import fs from "fs-extra";
+import path from "path";
+import { execSync } from "child_process";
 async function syncLivingDocs(incrementId) {
-    try {
-        console.log(`\n📚 Checking living docs sync for increment: ${incrementId}`);
-        // 1. Load config
-        const configPath = path.join(process.cwd(), '.specweave', 'config.json');
-        let config = {};
-        if (fs.existsSync(configPath)) {
-            config = JSON.parse(await fs.readFile(configPath, 'utf-8'));
-        }
-        // 2. Check if sync enabled
-        const syncEnabled = config.hooks?.post_task_completion?.sync_living_docs ?? false;
-        if (!syncEnabled) {
-            console.log('ℹ️  Living docs sync disabled in config');
-            console.log('   To enable: Set hooks.post_task_completion.sync_living_docs = true');
-            return;
-        }
-        console.log('✅ Living docs sync enabled');
-        // 3. Detect changed docs via git diff
-        const changedDocs = detectChangedDocs();
-        if (changedDocs.length === 0) {
-            console.log('ℹ️  No living docs changed (no git diff in .specweave/docs/)');
-            return;
-        }
-        console.log(`📄 Detected ${changedDocs.length} changed doc(s):`);
-        changedDocs.forEach((doc) => console.log(`   - ${doc}`));
-        // 4. Sync to GitHub if configured
-        await syncToGitHub(incrementId, changedDocs);
-        console.log('✅ Living docs sync complete\n');
+  try {
+    console.log(`
+\u{1F4DA} Checking living docs sync for increment: ${incrementId}`);
+    const configPath = path.join(process.cwd(), ".specweave", "config.json");
+    let config = {};
+    if (fs.existsSync(configPath)) {
+      config = JSON.parse(await fs.readFile(configPath, "utf-8"));
     }
-    catch (error) {
-        console.error('❌ Error syncing living docs:', error);
-        // Don't exit with error - this is best-effort
+    const syncEnabled = config.hooks?.post_task_completion?.sync_living_docs ?? false;
+    if (!syncEnabled) {
+      console.log("\u2139\uFE0F  Living docs sync disabled in config");
+      console.log("   To enable: Set hooks.post_task_completion.sync_living_docs = true");
+      return;
     }
+    console.log("\u2705 Living docs sync enabled");
+    const specCopied = await copyIncrementSpecToLivingDocs(incrementId);
+    const changedDocs = detectChangedDocs();
+    if (changedDocs.length === 0 && !specCopied) {
+      console.log("\u2139\uFE0F  No living docs changed (no git diff in .specweave/docs/)");
+      return;
+    }
+    console.log(`\u{1F4C4} Detected ${changedDocs.length} changed doc(s):`);
+    changedDocs.forEach((doc) => console.log(`   - ${doc}`));
+    await syncToGitHub(incrementId, changedDocs);
+    console.log("\u2705 Living docs sync complete\n");
+  } catch (error) {
+    console.error("\u274C Error syncing living docs:", error);
+  }
 }
-/**
- * Detect changed documentation files via git diff
- */
-function detectChangedDocs() {
-    try {
-        // Get changed files in .specweave/docs/
-        const output = execSync('git diff --name-only .specweave/docs/ 2>/dev/null || true', {
-            encoding: 'utf-8',
-            cwd: process.cwd(),
-        }).trim();
-        if (!output) {
-            return [];
-        }
-        // Filter to only .md files
-        const files = output
-            .split('\n')
-            .filter((f) => f.endsWith('.md'))
-            .filter((f) => f.length > 0);
-        return files;
+async function copyIncrementSpecToLivingDocs(incrementId) {
+  try {
+    const incrementSpecPath = path.join(process.cwd(), ".specweave", "increments", incrementId, "spec.md");
+    const livingDocsPath = path.join(process.cwd(), ".specweave", "docs", "internal", "specs", `spec-${incrementId}.md`);
+    if (!fs.existsSync(incrementSpecPath)) {
+      console.log(`\u26A0\uFE0F  Increment spec not found: ${incrementSpecPath}`);
+      return false;
     }
-    catch (error) {
-        console.warn('⚠️  Could not detect git changes:', error);
-        return [];
+    if (fs.existsSync(livingDocsPath)) {
+      const incrementContent = await fs.readFile(incrementSpecPath, "utf-8");
+      const livingDocsContent = await fs.readFile(livingDocsPath, "utf-8");
+      if (incrementContent === livingDocsContent) {
+        console.log(`\u2139\uFE0F  Living docs spec already up-to-date: spec-${incrementId}.md`);
+        return false;
+      }
+    }
+    await fs.ensureDir(path.dirname(livingDocsPath));
+    await fs.copy(incrementSpecPath, livingDocsPath);
+    console.log(`\u2705 Copied increment spec to living docs: spec-${incrementId}.md`);
+    return true;
+  } catch (error) {
+    console.error(`\u274C Error copying increment spec: ${error}`);
+    return false;
+  }
+}
+function detectChangedDocs() {
+  try {
+    const output = execSync("git diff --name-only .specweave/docs/ 2>/dev/null || true", {
+      encoding: "utf-8",
+      cwd: process.cwd()
+    }).trim();
+    if (!output) {
+      return [];
     }
+    const files = output.split("\n").filter((f) => f.endsWith(".md")).filter((f) => f.length > 0);
+    return files;
+  } catch (error) {
+    console.warn("\u26A0\uFE0F  Could not detect git changes:", error);
+    return [];
+  }
 }
-/**
- * Sync changed docs to GitHub
- */
 async function syncToGitHub(incrementId, changedDocs) {
-    try {
-        console.log('\n🔄 Syncing to GitHub...');
-        // Dynamic import to avoid circular dependencies
-        const { loadIncrementMetadata, detectRepo, collectLivingDocs, updateIssueLivingDocs, postArchitectureComment } = await import('../../../specweave-github/lib/github-issue-updater.js');
-        // 1. Load metadata
-        const metadata = await loadIncrementMetadata(incrementId);
-        if (!metadata?.github?.issue) {
-            console.log('ℹ️  No GitHub issue linked, skipping GitHub sync');
-            return;
-        }
-        // 2. Detect repository
-        const repoInfo = await detectRepo();
-        if (!repoInfo) {
-            console.log('⚠️  Could not detect GitHub repository, skipping GitHub sync');
-            return;
-        }
-        const { owner, repo } = repoInfo;
-        const issueNumber = metadata.github.issue;
-        console.log(`   Syncing to ${owner}/${repo}#${issueNumber}`);
-        // 3. Collect all living docs
-        const livingDocs = await collectLivingDocs(incrementId);
-        // 4. Update issue with living docs section
-        if (livingDocs.specs.length > 0 || livingDocs.architecture.length > 0 || livingDocs.diagrams.length > 0) {
-            await updateIssueLivingDocs(issueNumber, livingDocs, owner, repo);
-        }
-        // 5. Post comments for newly created architecture docs
-        for (const docPath of changedDocs) {
-            if (docPath.includes('/architecture/')) {
-                await postArchitectureComment(issueNumber, docPath, owner, repo);
-            }
-        }
-        console.log('✅ GitHub sync complete');
+  try {
+    console.log("\n\u{1F504} Syncing to GitHub...");
+    const {
+      loadIncrementMetadata,
+      detectRepo,
+      collectLivingDocs,
+      updateIssueLivingDocs,
+      postArchitectureComment
+    } = await import("../../../specweave-github/lib/github-issue-updater.js");
+    const metadata = await loadIncrementMetadata(incrementId);
+    if (!metadata?.github?.issue) {
+      console.log("\u2139\uFE0F  No GitHub issue linked, skipping GitHub sync");
+      return;
+    }
+    const repoInfo = await detectRepo();
+    if (!repoInfo) {
+      console.log("\u26A0\uFE0F  Could not detect GitHub repository, skipping GitHub sync");
+      return;
     }
-    catch (error) {
-        console.error('❌ Error syncing to GitHub:', error);
-        console.error('   (Non-blocking - continuing...)');
+    const { owner, repo } = repoInfo;
+    const issueNumber = metadata.github.issue;
+    console.log(`   Syncing to ${owner}/${repo}#${issueNumber}`);
+    const livingDocs = await collectLivingDocs(incrementId);
+    if (livingDocs.specs.length > 0 || livingDocs.architecture.length > 0 || livingDocs.diagrams.length > 0) {
+      await updateIssueLivingDocs(issueNumber, livingDocs, owner, repo);
     }
+    for (const docPath of changedDocs) {
+      if (docPath.includes("/architecture/")) {
+        await postArchitectureComment(issueNumber, docPath, owner, repo);
+      }
+    }
+    console.log("\u2705 GitHub sync complete");
+  } catch (error) {
+    console.error("\u274C Error syncing to GitHub:", error);
+    console.error("   (Non-blocking - continuing...)");
+  }
 }
-// CLI entry point
 const isMainModule = import.meta.url === `file://${process.argv[1]}`;
 if (isMainModule) {
-    const incrementId = process.argv[2];
-    if (!incrementId) {
-        console.error('❌ Usage: sync-living-docs <incrementId>');
-        console.error('   Example: sync-living-docs 0006-llm-native-i18n');
-        process.exit(1);
-    }
-    syncLivingDocs(incrementId).catch((error) => {
-        console.error('❌ Fatal error:', error);
-        // Don't exit with error code - best-effort sync
-    });
+  const incrementId = process.argv[2];
+  if (!incrementId) {
+    console.error("\u274C Usage: sync-living-docs <incrementId>");
+    console.error("   Example: sync-living-docs 0006-llm-native-i18n");
+    process.exit(1);
+  }
+  syncLivingDocs(incrementId).catch((error) => {
+    console.error("\u274C Fatal error:", error);
+  });
 }
-export { syncLivingDocs };
-//# sourceMappingURL=sync-living-docs.js.map
+export {
+  syncLivingDocs
+};

package/plugins/specweave/lib/hooks/sync-living-docs.ts

@@ -59,10 +59,13 @@ async function syncLivingDocs(incrementId: string): Promise<void> {
 
     console.log('✅ Living docs sync enabled');
 
-    // 3. Detect changed docs via git diff
+    // 3. Copy increment spec to living docs
+    const specCopied = await copyIncrementSpecToLivingDocs(incrementId);
+
+    // 4. Detect changed docs via git diff
     const changedDocs = detectChangedDocs();
 
-    if (changedDocs.length === 0) {
+    if (changedDocs.length === 0 && !specCopied) {
       console.log('ℹ️  No living docs changed (no git diff in .specweave/docs/)');
       return;
     }
@@ -81,6 +84,47 @@ async function syncLivingDocs(incrementId: string): Promise<void> {
   }
 }
 
+/**
+ * Copy increment spec to living docs
+ * Returns true if spec was copied, false if skipped
+ */
+async function copyIncrementSpecToLivingDocs(incrementId: string): Promise<boolean> {
+  try {
+    const incrementSpecPath = path.join(process.cwd(), '.specweave', 'increments', incrementId, 'spec.md');
+    const livingDocsPath = path.join(process.cwd(), '.specweave', 'docs', 'internal', 'specs', `spec-${incrementId}.md`);
+
+    // Check if increment spec exists
+    if (!fs.existsSync(incrementSpecPath)) {
+      console.log(`⚠️  Increment spec not found: ${incrementSpecPath}`);
+      return false;
+    }
+
+    // Check if living docs spec already exists and is identical
+    if (fs.existsSync(livingDocsPath)) {
+      const incrementContent = await fs.readFile(incrementSpecPath, 'utf-8');
+      const livingDocsContent = await fs.readFile(livingDocsPath, 'utf-8');
+
+      if (incrementContent === livingDocsContent) {
+        console.log(`ℹ️  Living docs spec already up-to-date: spec-${incrementId}.md`);
+        return false;
+      }
+    }
+
+    // Ensure target directory exists
+    await fs.ensureDir(path.dirname(livingDocsPath));
+
+    // Copy spec to living docs
+    await fs.copy(incrementSpecPath, livingDocsPath);
+
+    console.log(`✅ Copied increment spec to living docs: spec-${incrementId}.md`);
+    return true;
+
+  } catch (error) {
+    console.error(`❌ Error copying increment spec: ${error}`);
+    return false;
+  }
+}
+
 /**
  * Detect changed documentation files via git diff
  */

package/plugins/specweave-ado/.claude-plugin/plugin.json

@@ -16,5 +16,6 @@
     "sync",
     "integration"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "hooks": "hooks/hooks.json"
 }

package/plugins/specweave-ado/skills/ado-resource-validator/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ado-resource-validator
-description: Validates Azure DevOps projects and resources exist, creates missing resources automatically. Smart enough to prompt user to select existing or create new projects. Supports multiple projects for project-per-team strategy, area paths for area-path-based strategy, and teams for team-based strategy. Activates for ado setup, ado validation, ado configuration, missing ado project, azure devops .env setup.
+description: Validates Azure DevOps projects and resources exist, creates missing resources automatically. Smart enough to prompt user to select existing or create new projects. Supports multiple projects for project-per-team strategy, area paths for area-path-based strategy, and teams for team-based strategy. NEW - Per-project configuration support - AZURE_DEVOPS_AREA_PATHS_{ProjectName} and AZURE_DEVOPS_TEAMS_{ProjectName} for hierarchical organization. Activates for ado setup, ado validation, ado configuration, missing ado project, azure devops .env setup, per-project area paths, per-project teams.
 allowed-tools: Read, Bash, Write, Edit
 ---
 
@@ -66,6 +66,32 @@ AZURE_DEVOPS_TEAMS=Alpha Team,Beta Team,Gamma Team
 → Validates MainProduct project exists
 → Creates teams if missing: Alpha Team, Beta Team, Gamma Team
 
+**NEW: Per-Project Configuration** (Advanced - Multiple Projects × Resources)
+```bash
+# Multiple projects with their own area paths and teams
+AZURE_DEVOPS_STRATEGY=project-per-team
+AZURE_DEVOPS_PROJECTS=Backend,Frontend,Mobile
+
+# Per-project area paths (hierarchical naming)
+AZURE_DEVOPS_AREA_PATHS_Backend=API,Database,Cache
+AZURE_DEVOPS_AREA_PATHS_Frontend=Web,Admin,Public
+AZURE_DEVOPS_AREA_PATHS_Mobile=iOS,Android,Shared
+
+# Per-project teams (optional)
+AZURE_DEVOPS_TEAMS_Backend=Alpha,Beta
+AZURE_DEVOPS_TEAMS_Frontend=Gamma
+```
+→ Validates 3 projects exist: Backend, Frontend, Mobile
+→ Creates area paths per project:
+  - Backend\API, Backend\Database, Backend\Cache
+  - Frontend\Web, Frontend\Admin, Frontend\Public
+  - Mobile\iOS, Mobile\Android, Mobile\Shared
+→ Creates teams per project:
+  - Backend: Alpha, Beta
+  - Frontend: Gamma
+
+**Naming Convention**: `{PROVIDER}_{RESOURCE_TYPE}_{PROJECT_NAME}`
+
 ## Validation Flow
 
 ### Step 1: Strategy Detection

package/plugins/specweave-github/.claude-plugin/plugin.json

@@ -15,5 +15,6 @@
     "integration",
     "sync",
     "specweave"
-  ]
+  ],
+  "hooks": "hooks/hooks.json"
 }

package/plugins/specweave-jira/.claude-plugin/plugin.json

@@ -16,5 +16,6 @@
     "sync",
     "specweave",
     "project-management"
-  ]
+  ],
+  "hooks": "hooks/hooks.json"
 }

package/plugins/specweave-jira/skills/jira-resource-validator/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jira-resource-validator
-description: Validates Jira projects and boards exist, creates missing resources automatically. Smart enough to prompt user to select existing or create new projects. For boards, accepts either IDs (validates existence) or names (creates boards and updates .env with IDs). Activates for jira setup, jira validation, jira configuration, missing jira project, missing jira boards, jira .env setup.
+description: Validates Jira projects and boards exist, creates missing resources automatically. Smart enough to prompt user to select existing or create new projects. For boards, accepts either IDs (validates existence) or names (creates boards and updates .env with IDs). NEW - Per-project configuration support - JIRA_BOARDS_{ProjectKey} for hierarchical board organization across multiple projects. Activates for jira setup, jira validation, jira configuration, missing jira project, missing jira boards, jira .env setup, per-project boards.
 allowed-tools: Read, Bash, Write, Edit
 ---
 
@@ -70,6 +70,36 @@ JIRA_BOARDS=101,102,QA,Dashboard
 - Non-numeric (e.g., "QA") → Create board with that name
 - After creation, .env is updated with ALL board IDs
 
+### NEW: Per-Project Configuration (Advanced - Multiple Projects × Boards)
+
+**Multiple JIRA projects with their own boards:**
+
+```bash
+# Multiple projects with their own boards
+JIRA_STRATEGY=project-per-team
+JIRA_PROJECTS=BACKEND,FRONTEND,MOBILE
+
+# Per-project boards (hierarchical naming)
+JIRA_BOARDS_BACKEND=123,456         # Sprint + Kanban (IDs)
+JIRA_BOARDS_FRONTEND=Sprint,Bug     # Create these boards
+JIRA_BOARDS_MOBILE=789,012,345      # iOS + Android + Release (IDs)
+```
+→ Validates 3 projects exist: BACKEND, FRONTEND, MOBILE
+→ Validates/creates boards per project:
+  - BACKEND: Validates boards 123, 456 exist
+  - FRONTEND: Creates "Sprint" and "Bug" boards, updates .env with IDs
+  - MOBILE: Validates boards 789, 012, 345 exist
+
+**Naming Convention**: `{PROVIDER}_{RESOURCE_TYPE}_{PROJECT_KEY}`
+
+**Mixed IDs and Names Per Project**:
+```bash
+JIRA_BOARDS_BACKEND=123,NewBoard,456
+```
+→ Validates 123, 456 exist
+→ Creates "NewBoard"
+→ Updates .env: `JIRA_BOARDS_BACKEND=123,789,456` (all IDs!)
+
 ## Validation Flow
 
 ### Step 1: Project Validation

package/plugins/specweave-release/.claude-plugin/plugin.json

@@ -37,5 +37,6 @@
   },
   "skills": "skills",
   "agents": "agents",
-  "commands": "commands"
+  "commands": "commands",
+  "hooks": "hooks/hooks.json"
 }