specweave 0.33.5 → 0.34.0

package/plugins/specweave/commands/{specweave-embed-acs.md → embed-acs.md}

@@ -1,5 +1,5 @@
 ---
-name: specweave:embed-acs
+name: sw:embed-acs
 description: Auto-embed Acceptance Criteria from living docs into increment spec.md for hook compatibility
 ---
 
@@ -18,7 +18,7 @@ You are helping the user embed Acceptance Criteria from living documentation int
 ## Usage
 
 ```bash
-/specweave:embed-acs <increment-id>
+/sw:embed-acs <increment-id>
 ```
 
 ## Arguments
@@ -30,7 +30,7 @@ You are helping the user embed Acceptance Criteria from living documentation int
 ### Step 1: Parse and Validate Arguments
 
 1. **Extract increment ID**:
-   - Parse from command: `/specweave:embed-acs 0050` → "0050"
+   - Parse from command: `/sw:embed-acs 0050` → "0050"
    - Normalize to 4-digit format: "0050"
    - Support formats: "50", "0050", "0050-feature-name"
 
@@ -47,7 +47,7 @@ Available increments:
   • 0048-external-tool-import-enhancement
   • 0049-cli-first-init-flow
 
-Usage: /specweave:embed-acs <increment-id>
+Usage: /sw:embed-acs <increment-id>
 ```
 
 ### Step 2: Validate Increment Structure
@@ -99,7 +99,7 @@ Usage: /specweave:embed-acs <increment-id>
    This increment may not have living docs, or they're in a different location.
 
    Please specify living docs path manually:
-     /specweave:embed-acs 0050 --living-docs-path <path>
+     /sw:embed-acs 0050 --living-docs-path <path>
    ```
 
 ### Step 4: Extract User Stories from spec.md
@@ -269,8 +269,8 @@ Usage: /specweave:embed-acs <increment-id>
 
    Next steps:
      1. Review embedded ACs in spec.md
-     2. Run: /specweave:validate 0050
-     3. Start work: /specweave:do
+     2. Run: /sw:validate 0050
+     3. Start work: /sw:do
    ```
 
 ## Flags (Optional)
@@ -280,7 +280,7 @@ Usage: /specweave:embed-acs <increment-id>
 Manually specify living docs path if auto-detection fails:
 
 ```bash
-/specweave:embed-acs 0050 --living-docs-path .specweave/docs/internal/specs/specweave/FS-048
+/sw:embed-acs 0050 --living-docs-path .specweave/docs/internal/specs/specweave/FS-048
 ```
 
 ### `--dry-run`
@@ -288,7 +288,7 @@ Manually specify living docs path if auto-detection fails:
 Preview what would be embedded without modifying files:
 
 ```bash
-/specweave:embed-acs 0050 --dry-run
+/sw:embed-acs 0050 --dry-run
 ```
 
 **Output**:
@@ -308,7 +308,7 @@ No files modified.
 Skip confirmation prompts:
 
 ```bash
-/specweave:embed-acs 0050 --force
+/sw:embed-acs 0050 --force
 ```
 
 ## Error Handling
@@ -323,7 +323,7 @@ Found: Directory does not exist
 Possible solutions:
   1. Check if feature_id in spec.md is correct
   2. Manually specify path: --living-docs-path <path>
-  3. Create living docs first: /specweave:sync-docs
+  3. Create living docs first: /sw:sync-docs
 ```
 
 ### No User Stories in spec.md
@@ -365,16 +365,16 @@ Skipping US-005 for now.
 
 This command is referenced by:
 
-1. **`/specweave:validate`**: Suggests running `/specweave:embed-acs` when ACs are missing
-2. **`/specweave:do`**: Pre-start hook suggests this command if validation fails
-3. **`/specweave:increment`**: Should auto-call this when creating `structure: user-stories` increments
+1. **`/sw:validate`**: Suggests running `/sw:embed-acs` when ACs are missing
+2. **`/sw:do`**: Pre-start hook suggests this command if validation fails
+3. **`/sw:increment`**: Should auto-call this when creating `structure: user-stories` increments
 
 ## Examples
 
 ### Example 1: Basic Usage
 
 ```bash
-/specweave:embed-acs 0050
+/sw:embed-acs 0050
 ```
 
 **Output**:
@@ -399,7 +399,7 @@ Extracting ACs...
 ### Example 2: Dry Run
 
 ```bash
-/specweave:embed-acs 0050 --dry-run
+/sw:embed-acs 0050 --dry-run
 ```
 
 **Output**:
@@ -415,7 +415,7 @@ To apply changes, run without --dry-run flag.
 ### Example 3: Manual Path
 
 ```bash
-/specweave:embed-acs 0050 --living-docs-path .specweave/docs/internal/specs/custom/FS-048
+/sw:embed-acs 0050 --living-docs-path .specweave/docs/internal/specs/custom/FS-048
 ```
 
 **Output**:
@@ -429,10 +429,10 @@ Extracting ACs...
 
 ## Related Commands
 
-- `/specweave:increment`: Create new increment (should auto-embed ACs)
-- `/specweave:validate`: Validate increment (checks AC presence)
-- `/specweave:do`: Start increment (pre-start hook validates ACs)
-- `/specweave:sync-docs`: Sync living documentation
+- `/sw:increment`: Create new increment (should auto-embed ACs)
+- `/sw:validate`: Validate increment (checks AC presence)
+- `/sw:do`: Start increment (pre-start hook validates ACs)
+- `/sw:sync-docs`: Sync living documentation
 
 ## Related Documentation
 

package/plugins/specweave/commands/{specweave-external.md → external.md}

@@ -1,12 +1,12 @@
 ---
-name: specweave:external
+name: sw:external
 description: View external items dashboard - open issues from GitHub, JIRA, and Azure DevOps
-usage: /specweave:external [--refresh]
+usage: /sw:external [--refresh]
 ---
 
 # External Items Dashboard
 
-**Usage**: `/specweave:external [--refresh]`
+**Usage**: `/sw:external [--refresh]`
 
 ---
 
@@ -53,7 +53,7 @@ Last updated: 2 minutes ago (use --refresh to update)
 Force refresh the cache and fetch latest data from all providers.
 
 ```bash
-/specweave:external --refresh
+/sw:external --refresh
 ```
 
 ---
@@ -130,21 +130,21 @@ Set environment variables:
 ## Integration Points
 
 External items are also shown in:
-- `/specweave:status` - Summary section at bottom
-- `/specweave:increment` - Notification after planning
-- `/specweave:progress` - Footer line
+- `/sw:status` - Summary section at bottom
+- `/sw:increment` - Notification after planning
+- `/sw:progress` - Footer line
 
 ---
 
 ## Related Commands
 
-- `/specweave:status` - Show increment status with external items summary
-- `/specweave:progress` - Show detailed progress with external items footer
-- `/specweave:import-external` - Import external items as increments
+- `/sw:status` - Show increment status with external items summary
+- `/sw:progress` - Show detailed progress with external items footer
+- `/sw:import-external` - Import external items as increments
 
 ---
 
-**Command**: `/specweave:external`
+**Command**: `/sw:external`
 **Plugin**: specweave (core)
 **Version**: v0.31.0+
 **Part of**: Increment 0109 - External Items Dashboard

package/plugins/specweave/commands/{specweave-fix-duplicates.md → fix-duplicates.md}

@@ -1,5 +1,5 @@
 ---
-name: specweave:fix-duplicates
+name: sw:fix-duplicates
 description: Automatically detect and resolve duplicate increments with smart conflict resolution
 ---
 
@@ -20,19 +20,19 @@ description: Automatically detect and resolve duplicate increments with smart co
 
 ```bash
 # Detect and fix all duplicates interactively
-/specweave:fix-duplicates
+/sw:fix-duplicates
 
 # Preview what would be done (dry-run)
-/specweave:fix-duplicates --dry-run
+/sw:fix-duplicates --dry-run
 
 # Auto-fix with content merging
-/specweave:fix-duplicates --merge
+/sw:fix-duplicates --merge
 
 # Force fix without confirmation (use with caution!)
-/specweave:fix-duplicates --force --merge
+/sw:fix-duplicates --force --merge
 
 # Fix specific increment number
-/specweave:fix-duplicates 0031
+/sw:fix-duplicates 0031
 ```
 
 ## Options
@@ -135,7 +135,7 @@ Loser 2: .specweave/increments/_abandoned/0031-old-attempt/
 ### Example 1: Interactive Fix (Recommended)
 
 ```bash
-/specweave:fix-duplicates
+/sw:fix-duplicates
 ```
 
 **Output**:
@@ -182,7 +182,7 @@ Space freed: 2.3 MB
 ### Example 2: Dry-Run Preview
 
 ```bash
-/specweave:fix-duplicates --dry-run
+/sw:fix-duplicates --dry-run
 ```
 
 **Output**:
@@ -205,13 +205,13 @@ Summary:
   Would free: 2.5 MB
 
 Run without --dry-run to proceed:
-  /specweave:fix-duplicates --merge
+  /sw:fix-duplicates --merge
 ```
 
 ### Example 3: Auto-Fix with Merge
 
 ```bash
-/specweave:fix-duplicates --merge --force
+/sw:fix-duplicates --merge --force
 ```
 
 **Output**:
@@ -244,7 +244,7 @@ Summary:
 ### Example 4: Fix Specific Increment
 
 ```bash
-/specweave:fix-duplicates 0031
+/sw:fix-duplicates 0031
 ```
 
 **Output**:
@@ -314,7 +314,7 @@ Recommendation:
 
 **Increment**: 0031-external-tool-status-sync
 **Resolved**: 2025-11-15 07:00:00 UTC
-**Command**: /specweave:fix-duplicates --merge
+**Command**: /sw:fix-duplicates --merge
 
 ## Detected Duplicates
 
@@ -461,7 +461,7 @@ task.run(async () => {
       console.log(`Would merge: ${totalMerged} file${totalMerged > 1 ? 's' : ''}`);
     }
     console.log('\nRun without --dry-run to proceed:');
-    console.log('  /specweave:fix-duplicates --merge');
+    console.log('  /sw:fix-duplicates --merge');
   } else {
     console.log(`\nDuplicates resolved: ${results.length}`);
     console.log(`Paths deleted: ${totalDeleted}`);
@@ -484,9 +484,9 @@ No configuration needed - all options are provided via command-line flags.
 
 ## Related Commands
 
-- `/specweave:archive <id>` - Archive specific increment (prevents duplicates)
-- `/specweave:restore <id>` - Restore increment from archive
-- `/specweave:status` - View all increment statuses
+- `/sw:archive <id>` - Archive specific increment (prevents duplicates)
+- `/sw:restore <id>` - Restore increment from archive
+- `/sw:status` - View all increment statuses
 
 ## Safety Notes
 

package/plugins/specweave/commands/{specweave-import-docs.md → import-docs.md}

@@ -1,5 +1,5 @@
 ---
-name: specweave:import-docs
+name: sw:import-docs
 description: Import brownfield documentation from Notion exports, Confluence, GitHub Wiki, or any markdown folder. Automatically classifies files as specs, modules, team docs, or legacy.
 ---
 
@@ -22,7 +22,7 @@ Import existing documentation from Notion exports, Confluence, GitHub Wiki, or a
 ## Usage
 
 ```bash
-/specweave:import-docs <source-path> [options]
+/sw:import-docs <source-path> [options]
 ```
 
 ### Options
@@ -40,7 +40,7 @@ Import existing documentation from Notion exports, Confluence, GitHub Wiki, or a
 # Export Notion workspace to /tmp/notion-export/
 # Then import:
 
-/specweave:import-docs /tmp/notion-export/ --source=notion
+/sw:import-docs /tmp/notion-export/ --source=notion
 
 # Result:
 # 📊 Analysis Results:
@@ -55,7 +55,7 @@ Import existing documentation from Notion exports, Confluence, GitHub Wiki, or a
 ### Example 2: Confluence Export
 
 ```bash
-/specweave:import-docs /path/to/confluence/ --source=confluence --project=web-app
+/sw:import-docs /path/to/confluence/ --source=confluence --project=web-app
 
 # Imports to: projects/web-app/specs/, modules/, team/, legacy/confluence/
 ```
@@ -63,7 +63,7 @@ Import existing documentation from Notion exports, Confluence, GitHub Wiki, or a
 ### Example 3: Dry Run (Preview)
 
 ```bash
-/specweave:import-docs /tmp/docs/ --source=custom --dry-run
+/sw:import-docs /tmp/docs/ --source=custom --dry-run
 
 # Shows classification without importing files
 # Use this to preview results before actual import
@@ -72,7 +72,7 @@ Import existing documentation from Notion exports, Confluence, GitHub Wiki, or a
 ### Example 4: Preserve Structure
 
 ```bash
-/specweave:import-docs /path/to/wiki/ --source=wiki --preserve-structure
+/sw:import-docs /path/to/wiki/ --source=wiki --preserve-structure
 
 # Preserves original folder structure:
 # legacy/wiki/engineering/backend/auth.md
@@ -203,7 +203,7 @@ Import history is tracked in `.specweave/config.json`:
 
 ## See Also
 
-- `/specweave:init-multiproject` - Set up multi-project mode first
+- `/sw:init-multiproject` - Set up multi-project mode first
 - [Brownfield Import Guide](https://docs.spec-weave.com/guides/brownfield-import)
 - [Migration Best Practices](https://docs.spec-weave.com/guides/migration-best-practices)
 

package/plugins/specweave/commands/{specweave-import-external.md → import-external.md}

@@ -1,5 +1,5 @@
 ---
-name: specweave:import-external
+name: sw:import-external
 description: AUTO-EXECUTE import of external work items (GitHub/JIRA/ADO) since last import. NO PROMPTS - immediately runs with defaults. Creates READ-ONLY references in living docs. Options available but NOT required.
 ---
 
@@ -11,7 +11,7 @@ Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azur
 
 ## CRITICAL: Default Behavior (NO PROMPTS!)
 
-**When user runs `/specweave:import-external` with NO arguments:**
+**When user runs `/sw:import-external` with NO arguments:**
 1. **IMMEDIATELY execute** with default settings - DO NOT show menus or ask questions
 2. **Default = "since last import"** - auto-detects from `.specweave/sync-metadata.json`
 3. **If first import ever** - defaults to last 1 month
@@ -45,7 +45,7 @@ Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azur
 ## Usage
 
 ```bash
-/specweave:import-external [options]
+/sw:import-external [options]
 ```
 
 ### Options (ALL OPTIONAL - defaults work without them)
@@ -65,7 +65,7 @@ Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azur
 ### Example 1: Import New Items (Default - NO PROMPTS!)
 
 ```bash
-/specweave:import-external
+/sw:import-external
 
 # IMMEDIATELY executes with defaults:
 # - Since last import (or 1 month if first import)
@@ -90,7 +90,7 @@ Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azur
 ### Example 2: GitHub Only (Last 3 Months)
 
 ```bash
-/specweave:import-external --github-only --since=3m
+/sw:import-external --github-only --since=3m
 
 # Imports only from GitHub
 # Items created in last 3 months
@@ -99,7 +99,7 @@ Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azur
 ### Example 3: Dry Run (Preview)
 
 ```bash
-/specweave:import-external --dry-run --since=1m
+/sw:import-external --dry-run --since=1m
 
 # Shows what would be imported without creating files
 # Useful for checking item counts before actual import
@@ -116,7 +116,7 @@ Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azur
 ### Example 4: JIRA Only (All Items)
 
 ```bash
-/specweave:import-external --jira-only --since=all
+/sw:import-external --jira-only --since=all
 
 # Imports all JIRA items (no time filter)
 # ⚠️  Warning shown if > 100 items detected
@@ -127,7 +127,7 @@ Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azur
 ### Since Last Import (Default)
 
 ```bash
-/specweave:import-external
+/sw:import-external
 
 # Reads last import timestamp from:
 # .specweave/sync-metadata.json
@@ -382,7 +382,7 @@ No tasks defined.
 
 ## Differences from `specweave init`
 
-| Feature | `specweave init` | `/specweave:import-external` |
+| Feature | `specweave init` | `/sw:import-external` |
 |---------|------------------|------------------------------|
 | When to use | First-time setup | Ongoing imports after init |
 | User prompts | Interactive setup | **NONE** (auto-execute with defaults) |

package/plugins/specweave/commands/{specweave-increment.md → increment.md}

@@ -1,5 +1,5 @@
 ---
-name: specweave:increment
+name: sw:increment
 description: Plan new Product Increment - PM-led process (market research, spec, plan, auto-generate tasks). Auto-closes previous increment if PM gates pass.
 ---
 
@@ -26,7 +26,7 @@ if ! specweave check-discipline; then
   echo "💡 What would you like to do?"
   echo ""
   echo "1️⃣  Close incomplete increments:"
-  echo "   /specweave:done <id>"
+  echo "   /sw:done <id>"
   echo ""
   echo "2️⃣  Check status:"
   echo "   specweave check-discipline --verbose"
@@ -52,7 +52,7 @@ echo "✅ Discipline check passed"
 - ❌ NO options to defer - close previous first
 - ❌ NO auto-closing gates - explicit closure required
 - ✅ HARD BLOCK - cannot proceed without closing previous
-- ✅ Clear next steps - use `/specweave:close`
+- ✅ Clear next steps - use `/sw:close`
 - ✅ Safety valve - `--force` flag for emergencies (logged)
 
 **Rationale**:
@@ -178,8 +178,8 @@ if (activeCount >= limits.hardCap) {
   });
 
   console.log(chalk.blue('\n💡 Options:\n'));
-  console.log(chalk.white('1️⃣  Complete an increment: /specweave:done <id>'));
-  console.log(chalk.white('2️⃣  Pause an increment: /specweave:pause <id>'));
+  console.log(chalk.white('1️⃣  Complete an increment: /sw:done <id>'));
+  console.log(chalk.white('2️⃣  Pause an increment: /sw:pause <id>'));
   console.log(chalk.white('3️⃣  Increase limit: Edit .specweave/config.json limits.hardCap'));
   console.log(chalk.white('4️⃣  Continue anyway (confirm below)\n'));
 
@@ -246,7 +246,7 @@ if (activeCount >= limits.maxActiveIncrements) {
 
     if (choice === 'complete') {
       console.log(chalk.green('\n✅ Smart choice! Finish current work first.\n'));
-      console.log(chalk.dim('Use /specweave:do to continue work\n'));
+      console.log(chalk.dim('Use /sw:do to continue work\n'));
       process.exit(0);
     } else if (choice === 'pause') {
       console.log(chalk.blue('\n⏸️  Pausing current increment...\n'));
@@ -290,13 +290,13 @@ Active increments:
 💡 You MUST complete or pause existing work first:
 
 1️⃣  Complete an increment:
-   /specweave:done <id>
+   /sw:done <id>
 
 2️⃣  Pause an increment:
-   /specweave:pause <id> --reason="..."
+   /sw:pause <id> --reason="..."
 
 3️⃣  Check status:
-   /specweave:status
+   /sw:status
 
 📝 Multiple hotfixes? Combine them into ONE increment!
    Example: 0009-security-fixes (SQL + XSS + CSRF)
@@ -332,7 +332,7 @@ Choose an option: 1
 
 ✅ Smart choice! Finish current work first.
 
-Use /specweave:do to continue work
+Use /sw:do to continue work
 ```
 
 **Example Output - Emergency Interrupt (hotfix)**:
@@ -899,10 +899,10 @@ After the increment-planner skill completes, verify:
 📝 Now syncing strategic documentation to living docs...
 ```
 
-**Run `/specweave:sync-docs update` to create initial documentation**:
+**Run `/sw:sync-docs update` to create initial documentation**:
 
 ```bash
-/specweave:sync-docs update
+/sw:sync-docs update
 ```
 
 This will:
@@ -913,7 +913,7 @@ This will:
 - Update security docs in `.specweave/docs/internal/security/`
 - May prompt for conflict resolution if needed
 
-**After `/specweave:sync-docs update` completes**:
+**After `/sw:sync-docs update` completes**:
 
 ```
 ✅ Strategic documentation synchronized!
@@ -933,7 +933,7 @@ This will:
 You MUST invoke the sync-specs command using the SlashCommand tool:
 
 ```
-SlashCommand(command: "/specweave:sync-specs {increment-id}")
+SlashCommand(command: "/sw:sync-specs {increment-id}")
 ```
 
 **DO NOT** just mention the command in output - you MUST actually execute it!
@@ -1004,7 +1004,7 @@ External tool sync failures are **NON-BLOCKING** (increment creation succeeds):
 
 ```
 ⚠️ External sync failed: Rate limit exceeded
-💡 Run /specweave:sync-specs {increment-id} to retry
+💡 Run /sw:sync-specs {increment-id} to retry
 ```
 
 **After Step 10 completes:**
@@ -1014,8 +1014,8 @@ External tool sync failures are **NON-BLOCKING** (increment creation succeeds):
 
 Next steps:
 1. Review the increment plan and strategic docs
-2. Start implementation: /specweave:do {increment-id}
-3. Monitor external tool status: /specweave:status {increment-id}
+2. Start implementation: /sw:do {increment-id}
+3. Monitor external tool status: /sw:status {increment-id}
 ```
 
 ## Frontmatter Format (spec.md):