specweave 0.15.1 → 0.16.1

package/dist/utils/git-detector.js

@@ -0,0 +1,233 @@
+/**
+ * Git Remote Detection Utilities
+ *
+ * Detects and parses git remotes to auto-configure repository settings
+ *
+ * @module utils/git-detector
+ */
+import { execFileNoThrowSync } from './execFileNoThrow.js';
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Parse a git URL to extract provider, owner, and repo
+ *
+ * Supports:
+ * - HTTPS: https://github.com/owner/repo.git
+ * - SSH: git@github.com:owner/repo.git
+ * - SSH with protocol: ssh://git@github.com/owner/repo.git
+ * - GitHub Enterprise: https://github.company.com/owner/repo.git
+ *
+ * @param url - Git remote URL
+ * @returns Parsed remote information
+ */
+export function parseGitUrl(url) {
+    const result = {
+        url,
+        provider: 'unknown'
+    };
+    // Remove trailing .git if present
+    const cleanUrl = url.replace(/\.git$/, '');
+    // GitHub patterns
+    const githubPatterns = [
+        // HTTPS: https://github.com/owner/repo
+        /^https?:\/\/github\.com\/([^\/]+)\/([^\/]+)$/,
+        // SSH: git@github.com:owner/repo
+        /^git@github\.com:([^\/]+)\/([^\/]+)$/,
+        // SSH with protocol: ssh://git@github.com/owner/repo
+        /^ssh:\/\/git@github\.com\/([^\/]+)\/([^\/]+)$/,
+        // GitHub Enterprise: https://github.company.com/owner/repo
+        /^https?:\/\/github\.[^\/]+\/([^\/]+)\/([^\/]+)$/,
+        // GitHub Enterprise SSH: git@github.company.com:owner/repo
+        /^git@github\.[^:]+:([^\/]+)\/([^\/]+)$/
+    ];
+    for (const pattern of githubPatterns) {
+        const match = cleanUrl.match(pattern);
+        if (match) {
+            result.provider = 'github';
+            result.owner = match[1];
+            result.repo = match[2];
+            return result;
+        }
+    }
+    // GitLab patterns
+    const gitlabPatterns = [
+        // HTTPS: https://gitlab.com/owner/repo
+        /^https?:\/\/gitlab\.com\/([^\/]+)\/([^\/]+)$/,
+        // SSH: git@gitlab.com:owner/repo
+        /^git@gitlab\.com:([^\/]+)\/([^\/]+)$/,
+        // Self-hosted GitLab
+        /^https?:\/\/gitlab\.[^\/]+\/([^\/]+)\/([^\/]+)$/,
+        /^git@gitlab\.[^:]+:([^\/]+)\/([^\/]+)$/
+    ];
+    for (const pattern of gitlabPatterns) {
+        const match = cleanUrl.match(pattern);
+        if (match) {
+            result.provider = 'gitlab';
+            result.owner = match[1];
+            result.repo = match[2];
+            return result;
+        }
+    }
+    // Bitbucket patterns
+    const bitbucketPatterns = [
+        // HTTPS: https://bitbucket.org/owner/repo
+        /^https?:\/\/bitbucket\.org\/([^\/]+)\/([^\/]+)$/,
+        // SSH: git@bitbucket.org:owner/repo
+        /^git@bitbucket\.org:([^\/]+)\/([^\/]+)$/
+    ];
+    for (const pattern of bitbucketPatterns) {
+        const match = cleanUrl.match(pattern);
+        if (match) {
+            result.provider = 'bitbucket';
+            result.owner = match[1];
+            result.repo = match[2];
+            return result;
+        }
+    }
+    // Azure DevOps patterns
+    const azurePatterns = [
+        // HTTPS: https://dev.azure.com/org/project/_git/repo
+        /^https?:\/\/dev\.azure\.com\/([^\/]+)\/[^\/]+\/_git\/([^\/]+)$/,
+        // SSH: git@ssh.dev.azure.com:v3/org/project/repo
+        /^git@ssh\.dev\.azure\.com:v3\/([^\/]+)\/[^\/]+\/([^\/]+)$/,
+        // Old visualstudio.com format
+        /^https?:\/\/([^\.]+)\.visualstudio\.com\/[^\/]+\/_git\/([^\/]+)$/
+    ];
+    for (const pattern of azurePatterns) {
+        const match = cleanUrl.match(pattern);
+        if (match) {
+            result.provider = 'azure';
+            result.owner = match[1];
+            result.repo = match[2];
+            return result;
+        }
+    }
+    return result;
+}
+/**
+ * Detect git remotes in a project directory
+ *
+ * @param projectPath - Path to the project directory
+ * @returns Detection result with all remotes
+ */
+export async function detectGitRemotes(projectPath) {
+    // Check if .git directory exists
+    const gitDir = path.join(projectPath, '.git');
+    if (!fs.existsSync(gitDir)) {
+        return {
+            remotes: [],
+            hasGit: false,
+            error: 'Not a git repository'
+        };
+    }
+    // Run git remote -v to get all remotes
+    const result = execFileNoThrowSync('git', ['remote', '-v'], {
+        cwd: projectPath
+    });
+    if (!result.success) {
+        return {
+            remotes: [],
+            hasGit: true,
+            error: result.stderr || 'Failed to get git remotes'
+        };
+    }
+    // Parse the output
+    const lines = (result.stdout || '').split('\n').filter(line => line.trim());
+    const remotesMap = new Map();
+    for (const line of lines) {
+        // Format: origin  https://github.com/owner/repo.git (fetch)
+        // Format: origin  git@github.com:owner/repo.git (push)
+        const match = line.match(/^(\S+)\s+(\S+)\s+\((fetch|push)\)$/);
+        if (match) {
+            const [, name, url, type] = match;
+            // We only care about fetch URLs (avoid duplicates)
+            if (type === 'fetch') {
+                const parsedInfo = parseGitUrl(url);
+                const remote = {
+                    name,
+                    url,
+                    provider: parsedInfo.provider || 'unknown',
+                    owner: parsedInfo.owner,
+                    repo: parsedInfo.repo
+                };
+                remotesMap.set(name, remote);
+            }
+        }
+    }
+    return {
+        remotes: Array.from(remotesMap.values()),
+        hasGit: true
+    };
+}
+/**
+ * Get GitHub remotes only
+ *
+ * @param projectPath - Path to the project directory
+ * @returns Array of GitHub remotes
+ */
+export async function detectGitHubRemotes(projectPath) {
+    const result = await detectGitRemotes(projectPath);
+    return result.remotes.filter(r => r.provider === 'github');
+}
+/**
+ * Detect primary GitHub remote (prefer 'origin')
+ *
+ * @param projectPath - Path to the project directory
+ * @returns Primary GitHub remote or null
+ */
+export async function detectPrimaryGitHubRemote(projectPath) {
+    const githubRemotes = await detectGitHubRemotes(projectPath);
+    if (githubRemotes.length === 0) {
+        return null;
+    }
+    // Prefer 'origin' if it exists
+    const origin = githubRemotes.find(r => r.name === 'origin');
+    if (origin) {
+        return origin;
+    }
+    // Otherwise return the first GitHub remote
+    return githubRemotes[0];
+}
+/**
+ * Check if project has multiple GitHub remotes
+ *
+ * @param projectPath - Path to the project directory
+ * @returns True if multiple GitHub remotes exist
+ */
+export async function hasMultipleGitHubRemotes(projectPath) {
+    const githubRemotes = await detectGitHubRemotes(projectPath);
+    return githubRemotes.length > 1;
+}
+/**
+ * Format git remote for display
+ *
+ * @param remote - Git remote to format
+ * @returns Formatted string for display
+ */
+export function formatGitRemote(remote) {
+    if (remote.owner && remote.repo) {
+        return `${remote.name}: ${remote.owner}/${remote.repo} (${remote.provider})`;
+    }
+    return `${remote.name}: ${remote.url} (${remote.provider})`;
+}
+/**
+ * Get unique repository identifiers from remotes
+ *
+ * @param remotes - Array of git remotes
+ * @returns Array of unique owner/repo combinations
+ */
+export function getUniqueRepositories(remotes) {
+    const seen = new Set();
+    const unique = [];
+    for (const remote of remotes) {
+        if (remote.owner && remote.repo) {
+            const key = `${remote.owner}/${remote.repo}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                unique.push({ owner: remote.owner, repo: remote.repo });
+            }
+        }
+    }
+    return unique;
+}
+//# sourceMappingURL=git-detector.js.map

package/dist/utils/git-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-detector.js","sourceRoot":"","sources":["../../src/utils/git-detector.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.15.1",
+  "version": "0.16.1",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",
@@ -17,7 +17,7 @@
     "test:unit": "jest tests/unit --coverage",
     "test:integration": "jest tests/integration --coverage",
     "test:smoke": "bash tests/smoke/smoke-test.sh",
-    "test:e2e": "playwright test tests/e2e/ --grep-invert=\"(should default to claude adapter|should use claude adapter when explicitly requested|should use generic adapter|should create .claude|should initialize project with specweave init|should create correct directory structure|should handle non-interactive mode correctly|should validate config.json structure|should create .specweave directory structure|should create CLAUDE.md and AGENTS.md|should initialize git repository|should install SpecWeave|should scaffold SaaS|should create proper directory|should create required configuration|should install core skills|should install core agents|should have deployment|should have Stripe|ADO Sync|Increment Discipline Blocking|Self-Reflection)\"",
+    "test:e2e": "playwright test tests/e2e/ --grep-invert=\"(should default to claude adapter|should use claude adapter when explicitly requested|should use generic adapter|should create .claude|should initialize project with specweave init|should create correct directory structure|should handle non-interactive mode correctly|should validate config.json structure|should create .specweave directory structure|should create CLAUDE.md and AGENTS.md|should initialize git repository|should install SpecWeave|should scaffold SaaS|should create proper directory|should create required configuration|should install core skills|should install core agents|should have deployment|should have Stripe|ADO Sync|Increment Discipline Blocking|Self-Reflection|Increment Discipline Enforcement)\"",
     "test:all": "npm run test:unit && npm run test:integration && npm run test:e2e",
     "test:coverage": "jest --coverage --coverageReporters=text --coverageReporters=lcov",
     "test": "npm run test:smoke && npm run test:e2e",

package/plugins/specweave/commands/specweave-done.md

@@ -312,8 +312,116 @@ Closing increment 0001-user-authentication...
   ✓ Updated backlog (4 P3 tasks moved)
 
 🎉 Increment 0001 closed successfully!
+```
+
+### Step 4: Post-Closure Sync (AUTOMATIC)
+
+**CRITICAL**: After increment closes, automatically perform these syncs:
+
+#### A) Sync Living Docs to GitHub Project
+
+**Check configuration** (`.specweave/config.json`):
+```typescript
+// Check if GitHub sync is enabled
+const syncEnabled = config.hooks?.post_increment_done?.sync_to_github_project === true;
+```
+
+**If enabled**:
+1. **Find living docs spec**:
+   - Look for `.specweave/docs/internal/specs/spec-{id}*.md`
+   - Pattern 1: `spec-0001-user-authentication.md` (4-digit)
+   - Pattern 2: `spec-001-user-authentication.md` (3-digit)
+   - Check increment `spec.md` for reference
+
+2. **Sync to GitHub Project**:
+   ```bash
+   /specweave-github:sync-spec <spec-file>
+   ```
+
+3. **Report result**:
+   ```
+   🔗 Post-Closure Sync:
+      ✓ Found living docs: spec-0001-user-authentication.md
+      ✓ Syncing to GitHub Project...
+      ✓ GitHub Project updated successfully
+   ```
+
+**If spec not found**:
+```
+ℹ️ No living docs spec found (OK for bug/hotfix increments)
+```
+
+**If sync disabled**:
+```
+ℹ️ GitHub Project sync disabled in config
+```
+
+#### B) Close GitHub Issue (if exists)
+
+**Check metadata** (`.specweave/increments/0001/.metadata.json`):
+```json
+{
+  "github": {
+    "issue": 42,
+    "url": "https://github.com/org/repo/issues/42"
+  }
+}
+```
+
+**If issue exists AND config.hooks.post_increment_done.close_github_issue = true**:
+1. **Close issue via gh CLI**:
+   ```bash
+   gh issue close 42 --comment "✅ Increment 0001 completed and closed
+
+   All PM gates passed:
+   ✅ Gate 1: Tasks completed
+   ✅ Gate 2: Tests passing
+   ✅ Gate 3: Documentation updated
+
+   Duration: 14 days
+   Velocity: +50% faster than planned"
+   ```
+
+2. **Report result**:
+   ```
+   🐙 GitHub Issue:
+      ✓ Closed issue #42
+      ✓ Added completion summary
+   ```
+
+**If no issue**:
+```
+ℹ️ No GitHub issue linked to this increment
+```
+
+**Example Full Output**:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎉 INCREMENT CLOSED SUCCESSFULLY
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Increment: 0001-user-authentication
+Status: completed
+Duration: 14 days (vs 21 estimated)
+Velocity: +50% faster
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔗 POST-CLOSURE SYNC
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+GitHub Project:
+  ✓ Found living docs: spec-0001-user-authentication.md
+  ✓ Syncing to GitHub Project...
+  ✓ GitHub Project updated successfully
+
+GitHub Issue:
+  ✓ Closed issue #42
+  ✓ Added completion summary
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📋 NEXT STEPS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-Next steps:
   1. Create PR: git push && gh pr create
   2. Deploy to staging: npm run deploy:staging
   3. Create new increment: /specweave:increment "Next feature"

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

@@ -76,8 +76,23 @@ else
 fi
 
 # Parse tasks.md (THIS is the slow part: 10-50ms)
-TOTAL_TASKS=$(grep -c '^## T-' "$TASKS_FILE" 2>/dev/null || echo 0)
-COMPLETED_TASKS=$(grep -c '^\[x\]' "$TASKS_FILE" 2>/dev/null || echo 0)
+# Support both ## T- and ### T- formats (flexible task heading levels)
+TOTAL_TASKS=$(grep -cE '^##+ T-' "$TASKS_FILE" 2>/dev/null || echo 0)
+
+# Remove any whitespace/newlines and ensure integer
+TOTAL_TASKS=$(echo "$TOTAL_TASKS" | tr -d '\n\r ' | grep -E '^[0-9]+$' || echo 0)
+
+# Support both checkbox formats:
+# 1. Standard: [x] at line start
+# 2. Inline: **Status**: [x] (in task body)
+COMPLETED_TASKS_STANDARD=$(grep -c '^\[x\]' "$TASKS_FILE" 2>/dev/null || echo 0)
+COMPLETED_TASKS_INLINE=$(grep -c 'Status\*\*: \[x\]' "$TASKS_FILE" 2>/dev/null || echo 0)
+
+# Remove any whitespace/newlines and ensure integer
+COMPLETED_TASKS_STANDARD=$(echo "$COMPLETED_TASKS_STANDARD" | tr -d '\n\r ' | grep -E '^[0-9]+$' || echo 0)
+COMPLETED_TASKS_INLINE=$(echo "$COMPLETED_TASKS_INLINE" | tr -d '\n\r ' | grep -E '^[0-9]+$' || echo 0)
+
+COMPLETED_TASKS=$((COMPLETED_TASKS_STANDARD + COMPLETED_TASKS_INLINE))
 
 # Calculate percentage
 if [[ "$TOTAL_TASKS" -gt 0 ]]; then
@@ -87,8 +102,19 @@ else
 fi
 
 # Find current task (first incomplete task)
-# Strategy: Find first [ ] checkbox, then get the task heading above it
-CURRENT_TASK_LINE=$(grep -B1 '^\[ \]' "$TASKS_FILE" 2>/dev/null | grep '^## T-' | head -1 || echo "")
+# Strategy: Find first [ ] checkbox (either format), then get the task heading above it
+# Try standard format first (checkbox at line start)
+CURRENT_TASK_LINE=$(grep -B1 '^\[ \]' "$TASKS_FILE" 2>/dev/null | grep -E '^##+ T-' | head -1 || echo "")
+
+# If not found, try inline format (**Status**: [ ])
+if [[ -z "$CURRENT_TASK_LINE" ]]; then
+  # Find line with **Status**: [ ], then look backward for task heading
+  TASK_LINE_NUM=$(grep -n '\*\*Status\*\*: \[ \]' "$TASKS_FILE" 2>/dev/null | head -1 | cut -d: -f1 || echo "")
+  if [[ -n "$TASK_LINE_NUM" ]]; then
+    # Get lines before the status line and find the task heading
+    CURRENT_TASK_LINE=$(head -n "$TASK_LINE_NUM" "$TASKS_FILE" | grep -E '^##+ T-' | tail -1 || echo "")
+  fi
+fi
 CURRENT_TASK_ID=""
 CURRENT_TASK_TITLE=""
 

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

@@ -20,40 +20,96 @@ PROMPT=$(echo "$INPUT" | node -e "
 # ==============================================================================
 
 if echo "$PROMPT" | grep -q "/specweave:increment"; then
-  # Check for incomplete increments
+  # Check increment discipline using check-discipline CLI command
+  # This enforces WIP limits (max 1 active, hard cap 2)
   SPECWEAVE_DIR=".specweave"
 
   if [[ -d "$SPECWEAVE_DIR/increments" ]]; then
-    INCOMPLETE_INCREMENTS=$(find "$SPECWEAVE_DIR/increments" -mindepth 1 -maxdepth 1 -type d | while read increment_dir; do
-      metadata="$increment_dir/metadata.json"
-      if [[ -f "$metadata" ]]; then
-        status=$(node -e "
+    # Run discipline check (exit code: 0=pass, 1=violations, 2=error)
+    if command -v node >/dev/null 2>&1 && [[ -f "dist/cli/index.js" ]]; then
+      # Check active increments using MetadataManager
+      ACTIVE_COUNT=$(node -e "
+        try {
+          const { MetadataManager } = require('./dist/core/increment/metadata-manager.js');
+          const active = MetadataManager.getActive();
+          console.log(active.length);
+        } catch (e) {
+          console.error('Error checking active increments:', e.message);
+          process.exit(2);
+        }
+      " 2>/dev/null || echo "0")
+
+      # Hard cap: never >2 active
+      if [[ "$ACTIVE_COUNT" -ge 2 ]]; then
+        # Get list of active increments for error message
+        ACTIVE_LIST=$(node -e "
           try {
-            const data = JSON.parse(require('fs').readFileSync('$metadata', 'utf-8'));
-            console.log(data.status || 'unknown');
-          } catch (e) {
-            console.log('unknown');
-          }
-        ")
+            const { MetadataManager } = require('./dist/core/increment/metadata-manager.js');
+            const active = MetadataManager.getActive();
+            active.forEach(inc => console.log('  - ' + inc.id + ' [' + inc.type + ']'));
+          } catch (e) {}
+        " 2>/dev/null || echo "")
 
-        if [[ "$status" == "active" || "$status" == "planning" ]]; then
-          echo "$(basename "$increment_dir")"
-        fi
+        cat <<EOF
+{
+  "decision": "block",
+  "reason": "❌ HARD CAP REACHED\n\nYou have $ACTIVE_COUNT active increments (absolute maximum: 2)\n\nActive increments:\n$ACTIVE_LIST\n\n💡 You MUST complete or pause existing work first:\n\n1️⃣  Complete an increment:\n   /specweave:done <id>\n\n2️⃣  Pause an increment:\n   /specweave:pause <id> --reason=\"...\"\n\n3️⃣  Check status:\n   /specweave:status\n\n📝 Multiple hotfixes? Combine them into ONE increment!\n   Example: 0009-security-fixes (SQL + XSS + CSRF)\n\n⛔ This limit is enforced for your productivity.\nResearch: 3+ concurrent tasks = 40% slower + more bugs"
+}
+EOF
+        exit 0
       fi
-    done)
 
-    if [[ -n "$INCOMPLETE_INCREMENTS" ]]; then
-      # Count incomplete increments
-      COUNT=$(echo "$INCOMPLETE_INCREMENTS" | wc -l | xargs)
+      # Soft warning: 1 active (recommended limit)
+      if [[ "$ACTIVE_COUNT" -ge 1 ]]; then
+        # Get list of active increments for warning
+        ACTIVE_LIST=$(node -e "
+          try {
+            const { MetadataManager } = require('./dist/core/increment/metadata-manager.js');
+            const active = MetadataManager.getActive();
+            active.forEach(inc => console.log('  - ' + inc.id + ' [' + inc.type + ']'));
+          } catch (e) {}
+        " 2>/dev/null || echo "")
+
+        # Just warn, don't block (user can choose to continue)
+        cat <<EOF
+{
+  "decision": "approve",
+  "systemMessage": "⚠️  WIP LIMIT REACHED\n\nYou have $ACTIVE_COUNT active increment (recommended limit: 1)\n\nActive increments:\n$ACTIVE_LIST\n\n🧠 Focus Principle: ONE active increment = maximum productivity\nStarting a 2nd increment reduces focus and velocity.\n\n💡 Consider:\n  1️⃣  Complete current work (recommended)\n  2️⃣  Pause current work (/specweave:pause)\n  3️⃣  Continue anyway (accept 20% productivity cost)\n\n⚠️  Emergency hotfix/bug? Use --type=hotfix or --type=bug to bypass this warning."
+}
+EOF
+        exit 0
+      fi
+    else
+      # Fallback: check for active/planning status manually
+      INCOMPLETE_INCREMENTS=$(find "$SPECWEAVE_DIR/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'));
+              console.log(data.status || 'unknown');
+            } catch (e) {
+              console.log('unknown');
+            }
+          ")
+
+          if [[ "$status" == "active" || "$status" == "planning" ]]; then
+            echo "$(basename "$increment_dir")"
+          fi
+        fi
+      done)
 
-      # Block execution
-      cat <<EOF
+      if [[ -n "$INCOMPLETE_INCREMENTS" ]]; then
+        COUNT=$(echo "$INCOMPLETE_INCREMENTS" | wc -l | xargs)
+
+        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"
 }
 EOF
-      exit 0
+        exit 0
+      fi
     fi
   fi
 fi

package/plugins/specweave-ado/skills/ado-sync/SKILL.md

@@ -47,7 +47,7 @@ description: Bidirectional synchronization between SpecWeave increments and Azur
 /plugin list --installed | grep specweave-ado
 
 # Install if needed
-/plugin install specweave-ado@specweave
+/plugin install specweave-ado
 ```
 
 ### 2. Azure DevOps Personal Access Token (PAT)
@@ -403,4 +403,4 @@ Sync Enabled: ✅
 
 **Status**: Ready to use
 **Version**: 0.1.0
-**Plugin**: specweave-ado@specweave
+**Plugin**: specweave-ado

package/plugins/specweave-figma/ARCHITECTURE.md

@@ -287,7 +287,7 @@ specweave plugin install figma
 **Via Claude Code**:
 ```bash
 /plugin marketplace add specweave/marketplace
-/plugin install specweave-figma@specweave
+/plugin install specweave-figma
 ```
 
 ### Verify Installation

package/plugins/specweave-figma/README.md

@@ -102,7 +102,7 @@ specweave plugin list
 /plugin marketplace add https://raw.githubusercontent.com/anton-abyzov/specweave/main/marketplace/.claude-plugin/marketplace.json
 
 # Install figma plugin
-/plugin install specweave-figma@specweave
+/plugin install specweave-figma
 
 # Verify
 /plugin list

package/plugins/specweave-ml/README.md

@@ -28,7 +28,7 @@ Brings the same engineering discipline to ML that SpecWeave brings to software:
 
 ```bash
 # Install SpecWeave ML plugin
-/plugin install specweave-ml@specweave
+/plugin install specweave-ml
 
 # Verify installation
 /plugin list