specweave 0.33.4 → 0.33.6

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

@@ -1,5 +1,5 @@
 ---
-name: specweave:archive
+name: sw:archive
 description: Manually archive completed increments and sync living docs - NEVER auto-archives, explicit user action only
 ---
 
@@ -32,22 +32,22 @@ This command automatically synchronizes living docs by archiving features in:
 
 ```bash
 # Archive specific increment
-/specweave:archive 0031
+/sw:archive 0031
 
 # Archive multiple increments
-/specweave:archive 0001 0002 0003
+/sw:archive 0001 0002 0003
 
 # Archive all completed increments older than N days
-/specweave:archive --older-than 90
+/sw:archive --older-than 90
 
 # Keep last N increments, archive the rest
-/specweave:archive --keep-last 10
+/sw:archive --keep-last 10
 
 # Archive by pattern
-/specweave:archive --pattern "auth-*"
+/sw:archive --pattern "auth-*"
 
 # Dry run (preview without archiving)
-/specweave:archive --dry-run --older-than 90
+/sw:archive --dry-run --older-than 90
 ```
 
 ## Options
@@ -71,16 +71,16 @@ External features are identified by the `E` suffix (e.g., `FS-001E`, `FS-042E`).
 
 ```bash
 # Archive specific external features
-/specweave:archive --external FS-001E FS-002E
+/sw:archive --external FS-001E FS-002E
 
 # Archive external features older than 90 days
-/specweave:archive --external --older-than 90
+/sw:archive --external --older-than 90
 
 # Keep last 10 external features, archive the rest
-/specweave:archive --external --keep-last 10
+/sw:archive --external --keep-last 10
 
 # Preview external archive (dry run)
-/specweave:archive --external --dry-run --keep-last 5
+/sw:archive --external --dry-run --keep-last 5
 ```
 
 ### Why Separate External Archiving?
@@ -95,14 +95,14 @@ External features are identified by the `E` suffix (e.g., `FS-001E`, `FS-042E`).
 **Default `--keep-last 5`**: When called without any filtering options (no increment IDs, no pattern, no `--older-than`, no `--archive-completed`), the archiver **automatically defaults to `--keep-last 5`** to prevent accidentally archiving ALL increments.
 
 This safety feature ensures:
-- ✅ Running `/specweave:archive` without options won't archive everything
+- ✅ Running `/sw:archive` without options won't archive everything
 - ✅ Last 5 increments always remain visible for easy reference
 - ✅ Explicit criteria required to archive recent work
 
 ## Archive Rules
 
 ### Increments are archived when:
-1. Explicitly specified by ID (e.g., `/specweave:archive 0031`)
+1. Explicitly specified by ID (e.g., `/sw:archive 0031`)
 2. Match age criteria (e.g., `--older-than 90`)
 3. Match pattern criteria (e.g., `--pattern "old-*"`)
 4. Not in last N increments (e.g., `--keep-last 10`)
@@ -135,7 +135,7 @@ This safety feature ensures:
 ### Example 1: Archive Specific Increment
 
 ```bash
-/specweave:archive 0031
+/sw:archive 0031
 ```
 
 **Output**:
@@ -161,13 +161,13 @@ Checking increment 0031-external-tool-status-sync...
    Auto-archived features: 1
    Auto-archived epics: 0
 
-Next: /specweave:restore 0031 (if you need to unarchive)
+Next: /sw:restore 0031 (if you need to unarchive)
 ```
 
 ### Example 2: Archive Old Increments (Keep Last 10)
 
 ```bash
-/specweave:archive --keep-last 10
+/sw:archive --keep-last 10
 ```
 
 **Output**:
@@ -198,7 +198,7 @@ Filtering by status and safety checks...
 ### Example 3: Dry Run (Preview)
 
 ```bash
-/specweave:archive --older-than 90 --dry-run
+/sw:archive --older-than 90 --dry-run
 ```
 
 **Output**:
@@ -217,13 +217,13 @@ Summary:
   Total size: 180 MB
 
 Run without --dry-run to proceed:
-  /specweave:archive --older-than 90
+  /sw:archive --older-than 90
 ```
 
 ### Example 4: Archive by Pattern
 
 ```bash
-/specweave:archive --pattern "auth-|payment-|legacy-"
+/sw:archive --pattern "auth-|payment-|legacy-"
 ```
 
 **Output**:
@@ -255,8 +255,8 @@ Location: .specweave/increments/_archive/0031-external-tool-status-sync/
 
 Options:
   1. Delete from archive first, then retry
-  2. Restore from archive: /specweave:restore 0031
-  3. Resolve duplicates: /specweave:fix-duplicates
+  2. Restore from archive: /sw:restore 0031
+  3. Resolve duplicates: /sw:fix-duplicates
 ```
 
 ### Active Increment Protection
@@ -269,8 +269,8 @@ Skipped:
   • 0033-current-work (status: in-progress)
 
 Recommendation:
-  1. Close increments first: /specweave:done 0032
-  2. Then archive: /specweave:archive 0032
+  1. Close increments first: /sw:done 0032
+  2. Then archive: /sw:archive 0032
 ```
 
 ### External Sync Active
@@ -284,25 +284,25 @@ Skipped:
 
 Recommendation:
   1. Close external issues first
-  2. Then retry: /specweave:archive 0031 0030
+  2. Then retry: /sw:archive 0031 0030
 
 Or force archive (not recommended):
-  /specweave:archive 0031 --force
+  /sw:archive 0031 --force
 ```
 
 ## Related Commands
 
-- `/specweave:restore <increment-id>` - Restore increment from archive
-- `/specweave:done <increment-id>` - Close increment (does NOT archive!)
-- `/specweave:archive-features` - **DEPRECATED**: Now automatic, no longer needed!
-- `/specweave:status` - View archive statistics
+- `/sw:restore <increment-id>` - Restore increment from archive
+- `/sw:done <increment-id>` - Close increment (does NOT archive!)
+- `/sw:archive-features` - **DEPRECATED**: Now automatic, no longer needed!
+- `/sw:status` - View archive statistics
 
 ## Important Notes
 
 ### ⚠️ Manual Only Policy
 
 **Increments are NEVER auto-archived!** This is a deliberate design decision:
-- ✅ `/specweave:done` closes increments but leaves them visible
+- ✅ `/sw:done` closes increments but leaves them visible
 - ✅ You control when increments are archived
 - ✅ Keep ~10-20 recent increments visible for reference
 - ✅ Archive older work when you're ready
@@ -310,12 +310,12 @@ Or force archive (not recommended):
 ### 🔗 Feature Archiving (FULLY AUTOMATIC!)
 
 **Features/epics ARE automatically archived** when all their increments are archived:
-- ✅ `/specweave:archive 0031` → **AUTOMATICALLY** archives FS-031 if all increments archived
+- ✅ `/sw:archive 0031` → **AUTOMATICALLY** archives FS-031 if all increments archived
 - ✅ **AUTOMATICALLY** updates living docs and archives orphaned features
-- ✅ **ONE COMMAND** does everything - no manual `/specweave:archive-features` needed!
+- ✅ **ONE COMMAND** does everything - no manual `/sw:archive-features` needed!
 - ✅ Keeps feature docs in sync with increment archives
 
-**You never need to run `/specweave:archive-features` manually anymore!**
+**You never need to run `/sw:archive-features` manually anymore!**
 
 ### 📦 Archive is Local Only
 
@@ -476,13 +476,13 @@ Default behavior:
 **Recommended Workflow**:
 ```bash
 # 1. Check what would be archived (dry run)
-/specweave:archive --keep-last 10 --dry-run
+/sw:archive --keep-last 10 --dry-run
 
 # 2. Archive old increments (features auto-archived!)
-/specweave:archive --keep-last 10
+/sw:archive --keep-last 10
 
 # 3. Check results
-/specweave:status
+/sw:status
 ```
 
 **That's it!** Features are automatically archived in step 2 - no manual intervention needed!

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

@@ -1,12 +1,12 @@
 ---
-name: specweave:backlog
+name: sw:backlog
 description: Move an increment to backlog (planned but not ready to start)
-usage: /specweave:backlog <increment-id> --reason="<reason>"
+usage: /sw:backlog <increment-id> --reason="<reason>"
 ---
 
 # Backlog Increment Command
 
-**Usage**: `/specweave:backlog <increment-id> --reason="<reason>"`
+**Usage**: `/sw:backlog <increment-id> --reason="<reason>"`
 
 ---
 
@@ -33,7 +33,7 @@ Move an increment to backlog when:
    - `backlogReason`: User-provided reason
    - `backlogAt`: Current timestamp
 4. **Displays** confirmation message
-5. **Suggests** next actions (`/specweave:resume` to start work)
+5. **Suggests** next actions (`/sw:resume` to start work)
 
 ---
 
@@ -41,17 +41,17 @@ Move an increment to backlog when:
 
 ### Move to backlog with reason
 ```bash
-/specweave:backlog 0032 --reason="Low priority, focus on 0031 first"
+/sw:backlog 0032 --reason="Low priority, focus on 0031 first"
 
 ✅ Increment 0032 moved to backlog
 📝 Reason: Low priority, focus on 0031 first
 🗂️  No longer counts toward WIP limits
-💡 Start work with: /specweave:resume 0032
+💡 Start work with: /sw:resume 0032
 ```
 
 ### Move to backlog without reason (prompts)
 ```bash
-/specweave:backlog 0032
+/sw:backlog 0032
 
 ❓ Why are you moving this to backlog?
    1. Low priority
@@ -63,7 +63,7 @@ Move an increment to backlog when:
 
 ✅ Increment 0032 moved to backlog
 📝 Reason: Low priority
-💡 Start work with: /specweave:resume 0032
+💡 Start work with: /sw:resume 0032
 ```
 
 ---
@@ -72,7 +72,7 @@ Move an increment to backlog when:
 
 ### Already in Backlog
 ```bash
-/specweave:backlog 0032 --reason="Different reason"
+/sw:backlog 0032 --reason="Different reason"
 
 ⚠️  Increment 0032 is already in backlog
    Previous reason: Low priority
@@ -86,7 +86,7 @@ Update reason? [Y/n]: y
 
 ### Cannot Backlog Completed
 ```bash
-/specweave:backlog 0005
+/sw:backlog 0005
 
 ❌ Cannot move increment 0005 to backlog
    Status: completed
@@ -95,20 +95,20 @@ Update reason? [Y/n]: y
 
 ### Cannot Backlog Paused
 ```bash
-/specweave:backlog 0008
+/sw:backlog 0008
 
 ❌ Cannot move increment 0008 to backlog
    Status: paused
    Paused work should be resumed or abandoned, not moved to backlog
-   Resume it: /specweave:resume 0008
+   Resume it: /sw:resume 0008
 ```
 
 ### Increment Not Found
 ```bash
-/specweave:backlog 9999
+/sw:backlog 9999
 
 ❌ Increment not found: 9999
-💡 Check available increments: /specweave:status
+💡 Check available increments: /sw:status
 ```
 
 ---
@@ -146,10 +146,10 @@ active ──backlog──> backlog
 
 ## Related Commands
 
-- `/specweave:resume <id>` - Move from backlog to active (start work)
-- `/specweave:pause <id>` - Pause active work (different from backlog)
-- `/specweave:status` - Show all increment statuses including backlog
-- `/specweave:abandon <id>` - Abandon increment (permanent)
+- `/sw:resume <id>` - Move from backlog to active (start work)
+- `/sw:pause <id>` - Pause active work (different from backlog)
+- `/sw:status` - Show all increment statuses including backlog
+- `/sw:abandon <id>` - Abandon increment (permanent)
 
 ---
 
@@ -161,7 +161,7 @@ active ──backlog──> backlog
 
 ✅ **Clear reasons** - Helps with prioritization decisions
 
-✅ **Start when ready** - Use `/specweave:resume` to move from backlog to active
+✅ **Start when ready** - Use `/sw:resume` to move from backlog to active
 
 ❌ **Don't confuse with paused** - Backlog = never started, Paused = started but blocked
 
@@ -182,10 +182,10 @@ active ──backlog──> backlog
 
 ## Warning: Large Backlog
 
-If your backlog grows too large (10+ increments), `/specweave:status` will warn:
+If your backlog grows too large (10+ increments), `/sw:status` will warn:
 
 ```bash
-/specweave:status
+/sw:status
 
 🗂️  Backlog (12):
   📦 0032-feature-a [feature] - Low priority
@@ -199,13 +199,13 @@ If your backlog grows too large (10+ increments), `/specweave:status` will warn:
    - Reviewing priorities
 
 💡 Actions:
-   /specweave:resume <id>  # Start work on highest priority
-   /specweave:abandon <id> # Remove obsolete items
+   /sw:resume <id>  # Start work on highest priority
+   /sw:abandon <id> # Remove obsolete items
 ```
 
 ---
 
-**Command**: `/specweave:backlog`
+**Command**: `/sw:backlog`
 **Plugin**: specweave (core)
 **Version**: v0.19.0+
 **Part of**: Backlog Support Feature

package/plugins/specweave/commands/{specweave-check-hooks.md → check-hooks.md}

@@ -1,11 +1,11 @@
 ---
-name: specweave:check-hooks
+name: sw:check-hooks
 description: Comprehensive health check for hooks - detects import errors, runtime failures, performance issues, and provides auto-fix suggestions
 ---
 
 # Check Hook Health
 
-**Command**: `/specweave:check-hooks`
+**Command**: `/sw:check-hooks`
 
 Runs comprehensive health check on all hooks in the project.
 Detects import errors, runtime failures, performance issues, and provides auto-fix suggestions.
@@ -14,22 +14,22 @@ Detects import errors, runtime failures, performance issues, and provides auto-f
 
 ```bash
 # Check all hooks
-/specweave:check-hooks
+/sw:check-hooks
 
 # Check and auto-fix issues
-/specweave:check-hooks --fix
+/sw:check-hooks --fix
 
 # Check only critical hooks
-/specweave:check-hooks --critical
+/sw:check-hooks --critical
 
 # Verbose output with details
-/specweave:check-hooks --verbose
+/sw:check-hooks --verbose
 
 # Check specific hook
-/specweave:check-hooks update-ac-status
+/sw:check-hooks update-ac-status
 
 # Generate markdown report
-/specweave:check-hooks --format markdown --output report.md
+/sw:check-hooks --format markdown --output report.md
 ```
 
 ## Options
@@ -177,10 +177,10 @@ fi
 ## Troubleshooting
 
 ### "Hook execution timeout"
-Increase timeout: `/specweave:check-hooks --timeout 10000`
+Increase timeout: `/sw:check-hooks --timeout 10000`
 
 ### "Cannot find module"
-Run with auto-fix: `/specweave:check-hooks --fix`
+Run with auto-fix: `/sw:check-hooks --fix`
 
 ### "Permission denied"
 Check hook file permissions: `chmod +x plugins/*/hooks/*.sh`

package/plugins/specweave/commands/{specweave-check-tests.md → check-tests.md}

@@ -1,5 +1,5 @@
 ---
-name: specweave:check-tests
+name: sw:check-tests
 description: Validate test coverage for increment tasks, check AC-ID coverage, report test status, and verify coverage targets (NEW format with embedded tests in tasks.md)
 ---
 
@@ -22,16 +22,16 @@ Shows:
 
 ```bash
 # Check tests for current increment
-/specweave:check-tests
+/sw:check-tests
 
 # Check tests for specific increment
-/specweave:check-tests 0007
+/sw:check-tests 0007
 
 # Detailed report with test case breakdown
-/specweave:check-tests 0007 --detailed
+/sw:check-tests 0007 --detailed
 
 # AC-ID coverage report only
-/specweave:check-tests 0007 --ac-coverage
+/sw:check-tests 0007 --ac-coverage
 ```
 
 ---
@@ -58,7 +58,7 @@ Shows:
 ## Output Example (NEW Format)
 
 ```bash
-/specweave:check-tests 0007
+/sw:check-tests 0007
 
 📊 Test Status Report: 0007-smart-increment-discipline
 
@@ -138,7 +138,7 @@ Summary:
 ## Detailed Report (--detailed flag)
 
 ```bash
-/specweave:check-tests 0007 --detailed
+/sw:check-tests 0007 --detailed
 
 [Shows expanded report with:]
 - Full test case breakdown per task
@@ -153,7 +153,7 @@ Summary:
 ## AC Coverage Report (--ac-coverage flag)
 
 ```bash
-/specweave:check-tests 0007 --ac-coverage
+/sw:check-tests 0007 --ac-coverage
 
 ═══════════════════════════════════════════════════════════════
 
@@ -325,7 +325,7 @@ AC-US1-01 → Covered by T-001 ✅
 **If increment has tests.md** (pre-v0.7.0):
 
 ```bash
-/specweave:check-tests 0003  # Old format increment
+/sw:check-tests 0003  # Old format increment
 
 ⚠️  OLD FORMAT DETECTED: tests.md exists
 
@@ -365,12 +365,12 @@ if (hasTestsMd) {
    ```bash
    # Implement T-001
    # Write tests
-   /specweave:check-tests  # Verify tests pass
+   /sw:check-tests  # Verify tests pass
    ```
 
 2. **Before PR**: Ensure coverage meets targets
    ```bash
-   /specweave:check-tests 0007
+   /sw:check-tests 0007
    # Fix any failing tests
    # Commit and push
    ```
@@ -384,8 +384,8 @@ if (hasTestsMd) {
 
 4. **PM Gate 2**: Part of increment closure
    ```bash
-   /specweave:done 0007
-   # PM Agent runs /specweave:check-tests automatically
+   /sw:done 0007
+   # PM Agent runs /sw:check-tests automatically
    # Verifies >80% coverage before closure
    ```
 
@@ -396,7 +396,7 @@ if (hasTestsMd) {
 For CI/CD integration:
 
 ```bash
-/specweave:check-tests 0007
+/sw:check-tests 0007
 echo $?  # Exit code
 
 # Exit codes:

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

@@ -1,11 +1,11 @@
 ---
-name: specweave:costs
+name: sw:costs
 description: Display AI cost dashboard for current or specified increment with real-time savings tracking
 ---
 
 # Cost Dashboard Command
 
-You are being invoked via the `/specweave:costs [incrementId]` command.
+You are being invoked via the `/sw:costs [incrementId]` command.
 
 ## Your Task
 
@@ -206,7 +206,7 @@ COST BY INCREMENT
 
 ═══════════════════════════════════════════════════════════════
 
-💡 Tip: Use "/specweave:costs 0003" to see detailed report for increment 0003
+💡 Tip: Use "/sw:costs 0003" to see detailed report for increment 0003
 ```
 
 ## Error Handling
@@ -221,7 +221,7 @@ This could mean:
 - Cost tracking is not enabled
 - The cost log file is missing
 
-Run /specweave:do to start executing tasks with cost tracking enabled.
+Run /sw:do to start executing tasks with cost tracking enabled.
 ```
 
 ### Invalid Increment ID
@@ -234,7 +234,7 @@ Available increments:
 - 0002-core-enhancements
 - 0003-intelligent-model-selection
 
-Use /specweave:costs without arguments to see all increments.
+Use /sw:costs without arguments to see all increments.
 ```
 
 ## Important Notes
@@ -247,9 +247,9 @@ Use /specweave:costs without arguments to see all increments.
 
 ## Related Commands
 
-- `/specweave:do` - Execute tasks with cost tracking
-- `/specweave:progress` - View progress with cost summary
-- `/specweave:validate` - Validate increment (includes cost checks)
+- `/sw:do` - Execute tasks with cost tracking
+- `/sw:progress` - View progress with cost summary
+- `/sw:validate` - Validate increment (includes cost checks)
 
 ## Success Criteria
 

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

@@ -8,16 +8,16 @@ View and manage documentation discrepancies. Supports two modes:
 
 ```bash
 # Brownfield discrepancies (documentation gaps)
-/specweave:discrepancies                  # List pending brownfield discrepancies
-/specweave:discrepancies --module payment # Filter by module name
-/specweave:discrepancies --type missing-docs    # Filter by type
-/specweave:discrepancies --priority critical    # Filter by priority
-/specweave:discrepancies show DISC-0001   # View details
-/specweave:discrepancies ignore DISC-0001 "False positive"  # Ignore with reason
+/sw:discrepancies                  # List pending brownfield discrepancies
+/sw:discrepancies --module payment # Filter by module name
+/sw:discrepancies --type missing-docs    # Filter by type
+/sw:discrepancies --priority critical    # Filter by priority
+/sw:discrepancies show DISC-0001   # View details
+/sw:discrepancies ignore DISC-0001 "False positive"  # Ignore with reason
 
 # Code-to-spec discrepancies (legacy)
-/specweave:discrepancies --check          # Run code-spec check now
-/specweave:discrepancies --severity major # Filter by severity
+/sw:discrepancies --check          # Run code-spec check now
+/sw:discrepancies --severity major # Filter by severity
 ```
 
 ## Arguments
@@ -51,8 +51,8 @@ DISC-0003   ⚠️ MINOR      api-route          GET /api/orders path changed
 DISC-0004   ✅ TRIVIAL    type-definition    User type updated
 DISC-0005   ⚠️ MAJOR      api-route          New DELETE /api/users/:id
 
-Use '/specweave:discrepancies show <id>' to view details
-Use '/specweave:discrepancies accept <id>' to apply patch
+Use '/sw:discrepancies show <id>' to view details
+Use '/sw:discrepancies accept <id>' to apply patch
 ```
 
 ### show <id>
@@ -81,8 +81,8 @@ Description: Function signature has changed from documented version.
 Recommended: 👀 review-required
 Patch Available: Yes
 
-Use '/specweave:discrepancies accept DISC-0002' to apply patch
-Use '/specweave:discrepancies dismiss DISC-0002' to mark intentional
+Use '/sw:discrepancies accept DISC-0002' to apply patch
+Use '/sw:discrepancies dismiss DISC-0002' to mark intentional
 ```
 
 ### check
@@ -107,7 +107,7 @@ Results:
   - Minor: 1
   - Trivial: 1
 
-Use '/specweave:discrepancies' to view list
+Use '/sw:discrepancies' to view list
 ```
 
 ### accept <id>
@@ -137,5 +137,5 @@ Remaining: 4 discrepancies
 
 ## Related
 
-- `/specweave:sync-monitor`: Dashboard showing discrepancy count
-- `/specweave:notifications`: View discrepancy notifications
+- `/sw:sync-monitor`: Dashboard showing discrepancy count
+- `/sw:notifications`: View discrepancy notifications

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

@@ -5,9 +5,9 @@ Convert one or more brownfield discrepancies into a new increment for systematic
 ## Usage
 
 ```bash
-/specweave:discrepancy-to-increment DISC-0001
-/specweave:discrepancy-to-increment DISC-0001 DISC-0002 DISC-0003
-/specweave:discrepancy-to-increment --module payment-service
+/sw:discrepancy-to-increment DISC-0001
+/sw:discrepancy-to-increment DISC-0001 DISC-0002 DISC-0003
+/sw:discrepancy-to-increment --module payment-service
 ```
 
 ## Arguments
@@ -40,7 +40,7 @@ Convert one or more brownfield discrepancies into a new increment for systematic
    - Add `incrementId` reference
 
 5. **On Increment Completion**
-   - When increment closes via `/specweave:done`
+   - When increment closes via `/sw:done`
    - All linked discrepancies auto-marked `resolved`
    - Archived to `resolved/YYYY-MM/`
 
@@ -71,8 +71,8 @@ Updated discrepancy status:
 
 Next steps:
   1. Review: .specweave/increments/0087-payment-docs-improvement/spec.md
-  2. Plan: /specweave:plan 0087
-  3. Execute: /specweave:do 0087
+  2. Plan: /sw:plan 0087
+  3. Execute: /sw:do 0087
 ```
 
 ## Generated Spec Structure
@@ -127,7 +127,7 @@ From DISC-0003:
 
 ## Completion Hook
 
-When the increment is closed with `/specweave:done`:
+When the increment is closed with `/sw:done`:
 
 ```typescript
 // Automatically triggered by increment completion
@@ -155,6 +155,6 @@ async function onIncrementComplete(incrementId: string) {
 
 ## Related
 
-- `/specweave:discrepancies` - View pending discrepancies
-- `/specweave:increment` - Create new increment manually
-- `/specweave:done` - Complete increment (triggers resolution)
+- `/sw:discrepancies` - View pending discrepancies
+- `/sw:increment` - Create new increment manually
+- `/sw:done` - Complete increment (triggers resolution)