specweave 0.33.5 → 0.34.0

package/plugins/specweave-ado/commands/pull.md

@@ -1,11 +1,11 @@
 ---
-name: specweave-ado:pull
+name: sw-ado:pull
 description: Pull latest changes from Azure DevOps (like git pull). Supports increment, project, or full living docs sync.
 ---
 
 # ADO Pull Command
 
-**Usage**: `/specweave-ado:pull [target] [options]`
+**Usage**: `/sw-ado:pull [target] [options]`
 
 **Purpose**: Pull latest changes from Azure DevOps (like `git pull`)
 
@@ -15,19 +15,19 @@ description: Pull latest changes from Azure DevOps (like git pull). Supports inc
 
 ```bash
 # Pull for current/active increment (simple mode)
-/specweave-ado:pull
+/sw-ado:pull
 
 # Pull for specific increment
-/specweave-ado:pull 0005
+/sw-ado:pull 0005
 
 # Pull ALL changes across ALL projects (living docs sync)
-/specweave-ado:pull --all
+/sw-ado:pull --all
 
 # Pull for specific project/board
-/specweave-ado:pull --project clinical-insights
+/sw-ado:pull --project clinical-insights
 
 # Pull specific feature hierarchy (Epic → Feature → User Stories)
-/specweave-ado:pull --feature FS-042
+/sw-ado:pull --feature FS-042
 ```
 
 ---
@@ -36,13 +36,13 @@ description: Pull latest changes from Azure DevOps (like git pull). Supports inc
 
 ### Mode 1: Increment Sync (Default)
 ```bash
-/specweave-ado:pull [increment-id]
+/sw-ado:pull [increment-id]
 ```
 Syncs ONE increment ↔ ONE linked work item.
 
 ### Mode 2: Living Docs Sync (Full)
 ```bash
-/specweave-ado:pull --all [--time-range 1M]
+/sw-ado:pull --all [--time-range 1M]
 ```
 Syncs ALL specs across ALL projects/boards:
 - Discovers all linked specs in `.specweave/docs/internal/specs/`
@@ -52,7 +52,7 @@ Syncs ALL specs across ALL projects/boards:
 
 ### Mode 3: Project-Scoped Sync
 ```bash
-/specweave-ado:pull --project clinical-insights
+/sw-ado:pull --project clinical-insights
 ```
 Syncs all specs within a specific project folder:
 ```
@@ -64,7 +64,7 @@ specs/clinical-insights/
 
 ### Mode 4: Feature Hierarchy Sync
 ```bash
-/specweave-ado:pull --feature FS-042
+/sw-ado:pull --feature FS-042
 ```
 Syncs a specific feature and ALL its children:
 ```
@@ -136,7 +136,7 @@ const metadata = await loadIncrementMetadata(incrementId);
 
 const adoWorkItemId = metadata?.external_sync?.ado?.workItemId;
 if (!adoWorkItemId) {
-  console.log('Not linked to ADO. Run: /specweave-ado:create');
+  console.log('Not linked to ADO. Run: /sw-ado:create');
   return;
 }
 
@@ -220,7 +220,7 @@ async function discoverLinkedSpecs(options) {
 ### Example 1: Pull Single Increment
 
 ```
-User: /specweave-ado:pull 0005
+User: /sw-ado:pull 0005
 
 Claude:
 Pulling from ADO...
@@ -236,7 +236,7 @@ Pull complete!
 ### Example 2: Pull All (Living Docs Sync)
 
 ```
-User: /specweave-ado:pull --all
+User: /sw-ado:pull --all
 
 Claude:
 Discovering linked specs...
@@ -266,7 +266,7 @@ Pull Summary:
 ### Example 3: Pull Specific Project
 
 ```
-User: /specweave-ado:pull --project clinical-insights
+User: /sw-ado:pull --project clinical-insights
 
 Claude:
 Pulling specs/clinical-insights/...
@@ -282,7 +282,7 @@ Pull complete! 2 specs updated.
 ### Example 4: Pull Feature Hierarchy
 
 ```
-User: /specweave-ado:pull --feature FS-042
+User: /sw-ado:pull --feature FS-042
 
 Claude:
 Fetching ADO hierarchy for FS-042...
@@ -323,7 +323,7 @@ This ensures QA and stakeholder decisions in ADO take precedence over local stat
 ### Example 1: Simple Pull
 
 ```
-User: /specweave-ado:pull
+User: /sw-ado:pull
 
 Claude:
 Pulling from ADO...
@@ -339,7 +339,7 @@ Pull complete!
 ### Example 2: No Changes
 
 ```
-User: /specweave-ado:pull 0005
+User: /sw-ado:pull 0005
 
 Claude:
 Pulling from ADO...
@@ -353,12 +353,12 @@ Last synced: 2 minutes ago
 ### Example 3: Not Linked
 
 ```
-User: /specweave-ado:pull 0005
+User: /sw-ado:pull 0005
 
 Claude:
 Increment 0005 not linked to ADO yet.
 
-To link: /specweave-ado:create 0005
+To link: /sw-ado:create 0005
 ```
 
 ---
@@ -445,7 +445,7 @@ To link: /specweave-ado:create 0005
 │    ⚠ FS-042/us-003: ADO item #205 not found (deleted?) │
 │    ⚠ FS-050/us-012: Rate limit hit, skipped            │
 ├─────────────────────────────────────────────────────────┤
-│  Retry failed items: /specweave-ado:pull --retry        │
+│  Retry failed items: /sw-ado:pull --retry        │
 └─────────────────────────────────────────────────────────┘
 ```
 
@@ -483,7 +483,7 @@ AZURE_DEVOPS_PAT=your-personal-access-token
 
 | Command | Purpose |
 |---------|---------|
-| `/specweave-ado:push` | Push local changes to ADO |
-| `/specweave-ado:sync` | Two-way sync (pull + push) |
-| `/specweave-ado:status` | Check sync status |
-| `/specweave-ado:create` | Create ADO work item |
+| `/sw-ado:push` | Push local changes to ADO |
+| `/sw-ado:sync` | Two-way sync (pull + push) |
+| `/sw-ado:status` | Check sync status |
+| `/sw-ado:create` | Create ADO work item |

package/plugins/specweave-ado/commands/push.md

@@ -1,11 +1,11 @@
 ---
-name: specweave-ado:push
+name: sw-ado:push
 description: Push local changes to Azure DevOps (like git push). Supports increment, project, or full living docs sync.
 ---
 
 # ADO Push Command
 
-**Usage**: `/specweave-ado:push [target] [options]`
+**Usage**: `/sw-ado:push [target] [options]`
 
 **Purpose**: Push local changes to Azure DevOps (like `git push`)
 
@@ -15,19 +15,19 @@ description: Push local changes to Azure DevOps (like git push). Supports increm
 
 ```bash
 # Push current/active increment (simple mode)
-/specweave-ado:push
+/sw-ado:push
 
 # Push specific increment
-/specweave-ado:push 0005
+/sw-ado:push 0005
 
 # Push ALL local changes to ADO (living docs sync)
-/specweave-ado:push --all
+/sw-ado:push --all
 
 # Push specific project/board
-/specweave-ado:push --project clinical-insights
+/sw-ado:push --project clinical-insights
 
 # Push specific feature hierarchy
-/specweave-ado:push --feature FS-042
+/sw-ado:push --feature FS-042
 ```
 
 ---
@@ -97,7 +97,7 @@ To enable writes, update .specweave/config.json:
   "sync": { "settings": { "canUpdateExternalItems": true } }
 
 Or use read-only mode:
-  /specweave-ado:pull ${incrementId}
+  /sw-ado:pull ${incrementId}
 `);
   return;
 }
@@ -114,7 +114,7 @@ const metadata = JSON.parse(await fs.readFile(
 
 const adoWorkItemId = metadata?.external_sync?.ado?.workItemId;
 if (!adoWorkItemId) {
-  console.log(`Not linked to ADO. Run: /specweave-ado:create ${incrementId}`);
+  console.log(`Not linked to ADO. Run: /sw-ado:create ${incrementId}`);
   return;
 }
 
@@ -204,7 +204,7 @@ If `canUpdateStatus` is false, progress is posted but state unchanged.
 ### Example 1: Simple Push
 
 ```
-User: /specweave-ado:push
+User: /sw-ado:push
 
 Claude:
 Checking permissions...
@@ -225,7 +225,7 @@ Push complete!
 ### Example 2: Permission Denied
 
 ```
-User: /specweave-ado:push 0005
+User: /sw-ado:push 0005
 
 Claude:
 Checking permissions...
@@ -237,13 +237,13 @@ To enable ADO writes:
 1. Edit .specweave/config.json
 2. Set sync.settings.canUpdateExternalItems = true
 
-Or use read-only: /specweave-ado:pull 0005
+Or use read-only: /sw-ado:pull 0005
 ```
 
 ### Example 3: 100% Complete
 
 ```
-User: /specweave-ado:push 0005
+User: /sw-ado:push 0005
 
 Claude:
 Pushing to ADO...
@@ -256,7 +256,7 @@ Comment posted:
 State updated:
   Active -> Resolved (canUpdateStatus = true)
 
-Ready to close: /specweave-ado:close 0005
+Ready to close: /sw-ado:close 0005
 ```
 
 ---
@@ -330,7 +330,7 @@ Ready to close: /specweave-ado:close 0005
 │    ↑ Status: Active → Resolved                          │
 ├─────────────────────────────────────────────────────────┤
 │  🎉 INCREMENT READY TO CLOSE                            │
-│     Run: /specweave-ado:close 0005                      │
+│     Run: /sw-ado:close 0005                      │
 └─────────────────────────────────────────────────────────┘
 ```
 
@@ -347,7 +347,7 @@ Ready to close: /specweave-ado:close 0005
 │    sync.settings.canUpdateExternalItems = true          │
 │                                                         │
 │  OR USE READ-ONLY:                                      │
-│    /specweave-ado:pull 0005                             │
+│    /sw-ado:pull 0005                             │
 └─────────────────────────────────────────────────────────┘
 ```
 
@@ -385,7 +385,7 @@ AZURE_DEVOPS_PAT=your-personal-access-token
 
 | Command | Purpose |
 |---------|---------|
-| `/specweave-ado:pull` | Pull changes from ADO |
-| `/specweave-ado:sync` | Two-way sync (pull + push) |
-| `/specweave-ado:status` | Check sync status |
-| `/specweave-ado:close` | Close completed work item |
+| `/sw-ado:pull` | Pull changes from ADO |
+| `/sw-ado:sync` | Two-way sync (pull + push) |
+| `/sw-ado:status` | Check sync status |
+| `/sw-ado:close` | Close completed work item |

package/plugins/specweave-ado/commands/reconcile.md

@@ -1,5 +1,5 @@
 ---
-name: specweave-ado:reconcile
+name: sw-ado:reconcile
 description: Reconcile Azure DevOps work item states with increment statuses. Fixes drift by closing work items for completed increments and reactivating work items for resumed increments.
 ---
 
@@ -10,7 +10,7 @@ Scan all increments and fix any drift between local metadata.json status and ADO
 ## Usage
 
 ```bash
-/specweave-ado:reconcile [options]
+/sw-ado:reconcile [options]
 ```
 
 ## Options
@@ -81,7 +81,7 @@ if (result.errors.length > 0) {
 ## Dry Run Mode
 
 ```bash
-/specweave-ado:reconcile --dry-run
+/sw-ado:reconcile --dry-run
 ```
 
 Shows what would be changed without making any modifications:
@@ -114,7 +114,7 @@ Shows what would be changed without making any modifications:
 
 ## Related Commands
 
-- `/specweave-ado:status`: View sync status for increments
-- `/specweave-ado:sync`: Manual sync to ADO
-- `/specweave:done`: Close increment (triggers auto-close)
-- `/specweave:resume`: Resume increment (now triggers auto-reopen)
+- `/sw-ado:status`: View sync status for increments
+- `/sw-ado:sync`: Manual sync to ADO
+- `/sw:done`: Close increment (triggers auto-close)
+- `/sw:resume`: Resume increment (now triggers auto-reopen)

package/plugins/specweave-ado/commands/status.md

@@ -1,11 +1,11 @@
 ---
-name: specweave-ado:status
+name: sw-ado:status
 description: Check Azure DevOps sync status for increment
 ---
 
 # ADO Status Command
 
-**Usage**: `/specweave-ado:status <increment-id>`
+**Usage**: `/sw-ado:status <increment-id>`
 
 **Purpose**: Display ADO sync status and work item details
 
@@ -58,8 +58,8 @@ Next Sync: Automatic on task completion
 
 | Command | Purpose |
 |---------|---------|
-| `/specweave-ado:pull` | Pull changes from ADO |
-| `/specweave-ado:push` | Push progress to ADO |
-| `/specweave-ado:sync` | Two-way sync |
-| `/specweave-ado:create` | Create ADO work item |
-| `/specweave-ado:close` | Close work item |
+| `/sw-ado:pull` | Pull changes from ADO |
+| `/sw-ado:push` | Push progress to ADO |
+| `/sw-ado:sync` | Two-way sync |
+| `/sw-ado:create` | Create ADO work item |
+| `/sw-ado:close` | Close work item |

package/plugins/specweave-ado/commands/sync.md

@@ -1,11 +1,11 @@
 ---
-name: specweave-ado:sync
+name: sw-ado:sync
 description: Two-way sync between SpecWeave increment and Azure DevOps work item (push & pull by default)
 ---
 
 # Sync ADO Work Item Command
 
-**Usage**: `/specweave-ado:sync <increment-id> [options]`
+**Usage**: `/sw-ado:sync <increment-id> [options]`
 
 **Purpose**: Two-way synchronization between SpecWeave increment and Azure DevOps work item
 
@@ -24,13 +24,13 @@ description: Two-way sync between SpecWeave increment and Azure DevOps work item
 
 ```bash
 # Two-way sync (default - both directions)
-/specweave-ado:sync 0005
+/sw-ado:sync 0005
 
 # Push only (one-way to ADO)
-/specweave-ado:sync 0005 --direction to-ado
+/sw-ado:sync 0005 --direction to-ado
 
 # Pull only (one-way from ADO)
-/specweave-ado:sync 0005 --direction from-ado
+/sw-ado:sync 0005 --direction from-ado
 ```
 
 ---
@@ -74,7 +74,7 @@ Cannot push changes to ADO (sync.settings.canUpdateExternalItems = false).
 
 Options:
 1. Enable writes: Set canUpdateExternalItems to true in config.json
-2. Pull-only mode: /specweave-ado:sync ${incrementId} --direction from-ado
+2. Pull-only mode: /sw-ado:sync ${incrementId} --direction from-ado
 `);
     return;
   }
@@ -200,7 +200,7 @@ This allows:
 ### Two-way Sync (Default)
 
 ```
-User: /specweave-ado:sync 0005-payment-integration
+User: /sw-ado:sync 0005-payment-integration
 
 Claude:
 Checking permissions...
@@ -232,7 +232,7 @@ Work Item: https://dev.azure.com/acme-corp/My%20Project/_workitems/edit/12345
 ### Permission Denied
 
 ```
-User: /specweave-ado:sync 0005 --direction to-ado
+User: /sw-ado:sync 0005 --direction to-ado
 
 Claude:
 Checking permissions...
@@ -244,7 +244,7 @@ Cannot push changes to ADO.
 
 Options:
 1. Enable writes: Set sync.settings.canUpdateExternalItems = true
-2. Pull-only: /specweave-ado:sync 0005 --direction from-ado
+2. Pull-only: /sw-ado:sync 0005 --direction from-ado
 ```
 
 ---
@@ -255,10 +255,10 @@ For most use cases, use the git-style commands:
 
 | Command | Purpose |
 |---------|---------|
-| `/specweave-ado:pull` | Pull changes from ADO (read-only) |
-| `/specweave-ado:push` | Push progress to ADO |
+| `/sw-ado:pull` | Pull changes from ADO (read-only) |
+| `/sw-ado:push` | Push progress to ADO |
 
-Use `/specweave-ado:sync` when you need explicit two-way sync with options.
+Use `/sw-ado:sync` when you need explicit two-way sync with options.
 
 ---
 
@@ -326,8 +326,8 @@ AZURE_DEVOPS_PAT=your-personal-access-token
 
 | Command | Purpose |
 |---------|---------|
-| `/specweave-ado:pull` | Pull from ADO (git-style) |
-| `/specweave-ado:push` | Push to ADO (git-style) |
-| `/specweave-ado:create` | Create new ADO work item |
-| `/specweave-ado:status` | Check sync status |
-| `/specweave-ado:close` | Close work item when complete |
+| `/sw-ado:pull` | Pull from ADO (git-style) |
+| `/sw-ado:push` | Push to ADO (git-style) |
+| `/sw-ado:create` | Create new ADO work item |
+| `/sw-ado:status` | Check sync status |
+| `/sw-ado:close` | Close work item when complete |

package/plugins/specweave-ado/hooks/post-living-docs-update.sh

@@ -8,8 +8,8 @@
 # CRITICAL: External tool status ALWAYS wins in conflicts!
 #
 # Triggers:
-# 1. After /specweave:done (increment completion)
-# 2. After /specweave:sync-docs update
+# 1. After /sw:done (increment completion)
+# 2. After /sw:sync-docs update
 # 3. After manual spec edits
 # 4. After webhook from ADO
 #

package/plugins/specweave-ado/lib/ado-project-detector.js

@@ -483,7 +483,7 @@ ${PROJECT_KEYWORDS[projectName]?.join(", ") || "TBD"}
 
 ## Getting Started
 
-1. Create a new spec: \`/specweave:increment "feature-name"\`
+1. Create a new spec: \`/sw:increment "feature-name"\`
 2. Specs will be organized here automatically
 3. Sync to Azure DevOps: \`/specweave-ado:sync-spec spec-001\`
 

package/plugins/specweave-ado/lib/ado-project-detector.ts

@@ -547,7 +547,7 @@ ${PROJECT_KEYWORDS[projectName]?.join(', ') || 'TBD'}
 
 ## Getting Started
 
-1. Create a new spec: \`/specweave:increment "feature-name"\`
+1. Create a new spec: \`/sw:increment "feature-name"\`
 2. Specs will be organized here automatically
 3. Sync to Azure DevOps: \`/specweave-ado:sync-spec spec-001\`
 

package/plugins/specweave-ado/skills/{specweave-ado-mapper → ado-mapper}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: specweave-ado-mapper
+name: ado-mapper
 description: Expert in bidirectional conversion between SpecWeave increments and Azure DevOps (ADO) Epics/Features/User Stories/Tasks. Handles export (increment → ADO), import (ADO → increment), and bidirectional sync with conflict resolution. Activates for ADO sync, Azure DevOps sync, work item creation, import from ADO.
 tools: Read, Write, Edit, Bash
 model: claude-opus-4-5-20251101
@@ -448,7 +448,7 @@ Validate all conversions using test cases in `test-cases/`:
 
 **Run tests**:
 ```bash
-npm run test:agents:specweave-ado-mapper
+npm run test:agents:ado-mapper
 ```
 
 ---

package/plugins/specweave-ado/skills/ado-multi-project/SKILL.md

@@ -284,7 +284,7 @@ This folder contains specifications for the {Project} project.
 ### Sync Increment to Projects
 
 ```bash
-/specweave-ado:sync-increment 0014
+/sw-ado:sync-increment 0014
 
 # Detects projects from spec
 # Creates work items in each project
@@ -294,7 +294,7 @@ This folder contains specifications for the {Project} project.
 ### Sync Spec to Project
 
 ```bash
-/specweave-ado:sync-spec AuthService/spec-001
+/sw-ado:sync-spec AuthService/spec-001
 
 # Syncs single spec to specific project
 # Updates existing work item or creates new
@@ -303,7 +303,7 @@ This folder contains specifications for the {Project} project.
 ### Sync All Specs
 
 ```bash
-/specweave-ado:sync-all
+/sw-ado:sync-all
 
 # Syncs all specs across all projects
 # Maintains relationships
@@ -430,9 +430,9 @@ Related Specs:
 
 Prefix increment names with primary project:
 ```bash
-/specweave:increment "payment-stripe-integration"
-/specweave:increment "auth-oauth-provider"
-/specweave:increment "user-profile-redesign"
+/sw:increment "payment-stripe-integration"
+/sw:increment "auth-oauth-provider"
+/sw:increment "user-profile-redesign"
 ```
 
 ## Error Handling

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

@@ -25,7 +25,7 @@ This skill ensures your Azure DevOps configuration in `.env` is valid and all re
 
 ✅ **Automatically activates when**:
 - You set up Azure DevOps integration for the first time
-- You run `/specweave-ado:sync` and resources are missing
+- You run `/sw-ado:sync` and resources are missing
 - Your `.env` has invalid Azure DevOps configuration
 - You mention "ado setup" or "azure devops validation"
 
@@ -227,7 +227,7 @@ Checking teams...
 
 **Scenario**: New setup with multiple projects for different teams
 
-**Action**: Run `/specweave-ado:sync`
+**Action**: Run `/sw-ado:sync`
 
 **What Happens**:
 ```bash
@@ -462,7 +462,7 @@ export async function validateAzureDevOpsResources(
 npx specweave init
 
 # Also runs automatically before sync
-/specweave-ado:sync 0014
+/sw-ado:sync 0014
 ```
 
 **Manual validation**:
@@ -751,10 +751,10 @@ Contact Azure DevOps support for limit increases.
 
 ### Automatic Validation
 
-When using `/specweave-ado:sync`, validation runs automatically:
+When using `/sw-ado:sync`, validation runs automatically:
 
 ```bash
-/specweave-ado:sync 0014
+/sw-ado:sync 0014
 
 # Internally calls:
 1. validateAzureDevOpsResources()