specweave 0.7.1 → 0.8.2

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

@@ -1,9 +1,9 @@
 ---
-name: qa
+name: specweave:qa
 description: Run quality assessment on a SpecWeave increment with risk scoring and quality gate decisions
 ---
 
-# /qa - Quality Assessment Command
+# /specweave:qa - Quality Assessment Command
 
 **IMPORTANT**: You MUST invoke the CLI `specweave qa` command using the Bash tool. The slash command provides guidance and orchestration only.
 
@@ -18,32 +18,32 @@ Run comprehensive quality assessment on an increment using:
 ## Usage
 
 ```bash
-/qa <increment-id> [options]
+/specweave:qa <increment-id> [options]
 ```
 
 ### Examples
 
 ```bash
 # Quick mode (default)
-/qa 0008
+/specweave:qa 0008
 
 # Pre-implementation check
-/qa 0008 --pre
+/specweave:qa 0008 --pre
 
 # Quality gate check (comprehensive)
-/qa 0008 --gate
+/specweave:qa 0008 --gate
 
 # Export blockers to tasks.md
-/qa 0008 --export
+/specweave:qa 0008 --export
 
 # CI mode (exit 1 on FAIL)
-/qa 0008 --ci
+/specweave:qa 0008 --ci
 
 # Skip AI assessment (rule-based only)
-/qa 0008 --no-ai
+/specweave:qa 0008 --no-ai
 
 # Force run even if rule-based fails
-/qa 0008 --force
+/specweave:qa 0008 --force
 ```
 
 ### Options
@@ -242,4 +242,4 @@ When `--ci` flag used:
 ## Example Session
 
 ```
-User: /qa 0008
+User: /specweave:qa 0008

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

@@ -1,5 +1,5 @@
 ---
-name: resume
+name: specweave:resume
 description: Resume a paused increment
 usage: /specweave:resume <increment-id>
 ---
@@ -28,7 +28,7 @@ Resume a paused increment when:
    - Clears `pausedReason` and `pausedAt`
    - Updates `lastActivity` timestamp
 4. **Displays** context (pause duration, last activity)
-5. **Suggests** next actions (/do to continue work)
+5. **Suggests** next actions (`/specweave:do` to continue work)
 
 ---
 
@@ -36,21 +36,21 @@ Resume a paused increment when:
 
 ### Resume after a few days
 ```bash
-/resume 0006
+/specweave:resume 0006
 
 ✅ Increment 0006 resumed
 ⏱️  Was paused for: 3 days, 4 hours
 💡 Last activity: Created translation pipeline
-📋 Continue with: /do
+📋 Continue with: /specweave:do
 ```
 
 ### Resume after a few hours
 ```bash
-/resume 0007
+/specweave:resume 0007
 
 ✅ Increment 0007 resumed
 ⏱️  Was paused for: 2 hours
-📋 Continue with: /do
+📋 Continue with: /specweave:do
 ```
 
 ---
@@ -59,15 +59,15 @@ Resume a paused increment when:
 
 ### Already Active
 ```bash
-/resume 0006
+/specweave:resume 0006
 
 ⚠️  Increment 0006 is already active
-   No action needed. Continue with: /do
+   No action needed. Continue with: /specweave:do
 ```
 
 ### Cannot Resume Completed
 ```bash
-/resume 0005
+/specweave:resume 0005
 
 ❌ Cannot resume increment 0005
    Status: completed
@@ -76,7 +76,7 @@ Resume a paused increment when:
 
 ### Resume Abandoned (Confirmation Required)
 ```bash
-/resume 0008
+/specweave:resume 0008
 
 ⚠️  Increment 0008 is abandoned
    Reason: Requirements changed
@@ -86,15 +86,15 @@ Resume a paused increment when:
 ✅ Increment 0008 resumed
 ⚠️  Note: Was abandoned 5 days ago
 💡 Review spec.md to ensure still relevant
-📋 Continue with: /do
+📋 Continue with: /specweave:do
 ```
 
 ### Increment Not Found
 ```bash
-/resume 9999
+/specweave:resume 9999
 
 ❌ Increment not found: 9999
-💡 Check paused increments: /status --paused
+💡 Check paused increments: /specweave:status --paused
 ```
 
 ---
@@ -164,16 +164,16 @@ abandoned ──resume──> active (with confirmation)
 
 ## Automatic Suggestions
 
-When you run `/status`, stale paused increments trigger suggestions:
+When you run `/specweave:status`, stale paused increments trigger suggestions:
 
 ```bash
-/status
+/specweave:status
 
 ⏸️  Paused (2):
   🔄 0006-stripe [feature]
      Paused: 3 days ago
      Reason: Waiting for API keys
-     💡 Check if API keys arrived → /resume 0006
+     💡 Check if API keys arrived → /specweave:resume 0006
 
   🔄 0007-refactor [refactor]
      Paused: 10 days ago
@@ -188,7 +188,7 @@ When you run `/status`, stale paused increments trigger suggestions:
 After resuming, the command shows helpful context:
 
 ```bash
-/resume 0006
+/specweave:resume 0006
 
 ✅ Increment 0006 resumed
 
@@ -200,17 +200,17 @@ After resuming, the command shows helpful context:
 💡 Next steps:
    1. Review spec.md (requirements may have changed)
    2. Check dependencies (are API keys available?)
-   3. Continue with: /do
+   3. Continue with: /specweave:do
 
 📋 Quick commands:
-   /do           # Resume work
-   /progress     # See detailed progress
-   /validate     # Check increment health
+   /specweave:do           # Resume work
+   /specweave:progress     # See detailed progress
+   /specweave:validate     # Check increment health
 ```
 
 ---
 
-**Command**: `/specweave:resume` (or `/resume`)
+**Command**: `/specweave:resume`
 **Plugin**: specweave (core)
 **Version**: v0.7.0+
 **Part of**: Increment 0007 - Smart Status Management

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

@@ -1,5 +1,5 @@
 ---
-name: status
+name: specweave:status
 description: Show increment status overview with rich details (active, paused, completed, abandoned)
 usage: /specweave:status [--active|--paused|--completed|--abandoned|--stale]
 ---
@@ -27,7 +27,7 @@ Display comprehensive increment status overview:
 ### Default (All Increments)
 
 ```bash
-/status
+/specweave:status
 
 📊 Increment Status Overview
 
@@ -74,30 +74,30 @@ Display comprehensive increment status overview:
   - Resume or abandon 0007 (stale)
 
 Commands:
-  /do              # Continue current work
-  /resume 0007     # Resume paused increment
-  /abandon 0007    # Abandon if obsolete
+  /specweave:do              # Continue current work
+  /specweave:resume 0007     # Resume paused increment
+  /specweave:abandon 0007    # Abandon if obsolete
 ```
 
 ### Filtered Views
 
 ```bash
 # Active only
-/status --active
+/specweave:status --active
 
 🔥 Active Increments (2):
   🚨 0005-payment-hotfix [hotfix] (90% done, 6 hours)
   🔧 0006-i18n [feature] (50% done, 2 days)
 
 # Paused only
-/status --paused
+/specweave:status --paused
 
 ⏸️  Paused Increments (1):
   🔄 0007-stripe [feature] (paused 3 days)
      Reason: Waiting for API keys
 
 # Stale only (paused >7 days OR active >30 days)
-/status --stale
+/specweave:status --stale
 
 ⚠️  Stale Increments (2):
   🔄 0008-experiment [experiment] (paused 10 days)
@@ -201,8 +201,8 @@ Paused >7 days → warning:
      ⚠️  STALE! Review or abandon?
 
 💡 Actions:
-   /resume 0007  # If unblocked
-   /abandon 0007 # If no longer needed
+   /specweave:resume 0007  # If unblocked
+   /specweave:abandon 0007 # If no longer needed
 ```
 
 ### Long-Running Active Increments
@@ -244,7 +244,7 @@ Experiments inactive >14 days → warning:
      🚨 AUTO-ABANDON WARNING
 
 💡 Experiments auto-abandon after 14 days of inactivity
-   To prevent: Update via /do or /touch 0010
+   To prevent: Update via /specweave:do or /touch 0010
 ```
 
 ---
@@ -256,7 +256,7 @@ Experiments inactive >14 days → warning:
 Show only active increments
 
 ```bash
-/status --active
+/specweave:status --active
 
 🔥 Active (2):
   🚨 0005-hotfix [hotfix] (90% done)
@@ -268,7 +268,7 @@ Show only active increments
 Show only paused increments
 
 ```bash
-/status --paused
+/specweave:status --paused
 
 ⏸️  Paused (2):
   🔄 0007-stripe [feature] (paused 3 days)
@@ -284,7 +284,7 @@ Show only paused increments
 Show only completed increments
 
 ```bash
-/status --completed
+/specweave:status --completed
 
 ✅ Completed (5):
   0001-core-framework (completed 30 days ago)
@@ -299,7 +299,7 @@ Show only completed increments
 Show only abandoned increments
 
 ```bash
-/status --abandoned
+/specweave:status --abandoned
 
 ❌ Abandoned (3):
   0008-old-approach (Requirements changed)
@@ -318,7 +318,7 @@ Show only abandoned increments
 Show only stale increments (paused >7 days OR active >30 days)
 
 ```bash
-/status --stale
+/specweave:status --stale
 
 ⚠️  Stale Increments (3):
   🔄 0007-stripe [feature] (paused 10 days)
@@ -365,7 +365,7 @@ Show only stale increments (paused >7 days OR active >30 days)
 Future enhancement (v0.8.0+):
 
 ```bash
-/status --analytics
+/specweave:status --analytics
 
 📊 Increment Analytics (Last 90 Days):
 
@@ -391,7 +391,7 @@ Recommendations:
 
 ---
 
-**Command**: `/specweave:status` (or `/status`)
+**Command**: `/specweave:status`
 **Plugin**: specweave (core)
 **Version**: v0.7.0+
 **Part of**: Increment 0007 - Smart Status Management

package/plugins/specweave/commands/specweave-switch-project.md

@@ -0,0 +1,168 @@
+---
+name: specweave:switch-project
+description: Switch active project for increment planning. Future increments will use the selected project's specs, modules, and team folders.
+---
+
+# Switch Active Project
+
+Switch the active project. Future increments will use the selected project's specs folder.
+
+## Usage
+
+```bash
+/specweave:switch-project <project-id>
+```
+
+## Examples
+
+### Example 1: Switch to Specific Project
+
+```bash
+/specweave:switch-project web-app
+
+# Result:
+# ✅ Switched to project: Web Application (web-app)
+# ℹ️  Future increments will use:
+#    - projects/web-app/specs/
+#    - projects/web-app/modules/
+#    - projects/web-app/team/
+```
+
+### Example 2: List Available Projects
+
+```bash
+/specweave:switch-project
+
+# If no project ID provided, shows list of projects:
+#
+# 📋 Available Projects:
+#
+#   default - Default Project
+#     Team: Engineering Team
+#
+# → web-app - Web Application
+#     Team: Frontend Team
+#     Tech: React, TypeScript, Node.js
+#
+#   mobile-app - Mobile Application
+#     Team: Mobile Team
+#     Tech: React Native, Firebase
+#
+# Active project: web-app (→)
+#
+# Usage: /specweave:switch-project <project-id>
+```
+
+## What Happens
+
+1. **Updates config** - Sets `multiProject.activeProject` in `.specweave/config.json`
+2. **Clears cache** - Forces reload of project context
+3. **Future operations** use new project:
+   - `/specweave:increment` creates specs in new project's `specs/` folder
+   - Module docs go to new project's `modules/` folder
+   - Team docs go to new project's `team/` folder
+
+## Requirements
+
+- Multi-project mode must be enabled
+- Project ID must exist in config
+
+## Error Cases
+
+### Multi-Project Not Enabled
+
+```bash
+/specweave:switch-project web-app
+
+# Error:
+# ❌ Multi-project mode not enabled
+#    Run /specweave:init-multiproject first
+```
+
+### Project Not Found
+
+```bash
+/specweave:switch-project nonexistent
+
+# Error:
+# ❌ Project 'nonexistent' not found
+#    Available projects: default, web-app, mobile-app
+```
+
+## Integration with Increments
+
+When you create an increment, it uses the active project:
+
+```bash
+# Switch to web-app
+/specweave:switch-project web-app
+
+# Create increment
+/specweave:increment "Add user authentication"
+
+# Result:
+# Spec created in: projects/web-app/specs/spec-001-user-auth.md
+# Increment: .specweave/increments/0013-user-auth/
+# Linked to project: web-app
+```
+
+## Integration with External Sync
+
+Each project can have its own sync profiles:
+
+```json
+{
+  "multiProject": {
+    "projects": [{
+      "id": "web-app",
+      "syncProfiles": ["web-app-github", "web-app-jira"]
+    }]
+  }
+}
+```
+
+When you switch projects, the relevant sync profiles become active.
+
+## Checking Current Project
+
+```bash
+# List all projects (shows active with →)
+/specweave:switch-project
+
+# Or check config directly
+cat .specweave/config.json | grep activeProject
+```
+
+## Use Cases
+
+### Multi-Team Organization
+```bash
+# Morning: Work on web app
+/specweave:switch-project web-app
+/specweave:increment "Add payment integration"
+
+# Afternoon: Work on mobile app
+/specweave:switch-project mobile-app
+/specweave:increment "Add push notifications"
+```
+
+### Platform Engineering
+```bash
+# Manage infrastructure project
+/specweave:switch-project platform-infra
+/specweave:increment "Upgrade Kubernetes cluster"
+
+# Then switch to application project
+/specweave:switch-project backend-api
+/specweave:increment "Add rate limiting"
+```
+
+## See Also
+
+- `/specweave:init-multiproject` - Enable multi-project mode
+- `/specweave:increment` - Create increments (uses active project)
+- [Multi-Project Guide](https://docs.spec-weave.com/guides/multi-project-setup)
+
+---
+
+**Implementation**: `src/cli/commands/switch-project.ts`

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

@@ -1,5 +1,5 @@
 ---
-name: sync-docs
+name: specweave:sync-docs
 description: Bidirectional documentation sync - review strategic docs before implementation OR update living docs from completed increments with conflict resolution
 ---
 

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

@@ -1,5 +1,5 @@
 ---
-name: sync-tasks
+name: specweave:sync-tasks
 description: Sync tasks.md with actual completion status (GitHub issue or reality check)
 ---
 
@@ -212,31 +212,31 @@ Progress recalculated:
 
 ✓ tasks.md synced successfully!
 
-Next: Run /progress to verify
+Next: Run /specweave:progress to verify
 ```
 
 ---
 
 ## Integration with Other Commands
 
-### /progress
+### /specweave:progress
 ```bash
 # Check sync status before showing progress
-/sync-tasks --validate
+/specweave:sync-tasks --validate
 # If out of sync, warn user
 ```
 
-### /validate
+### /specweave:validate
 ```bash
 # Validate tasks.md is in sync
-/sync-tasks --validate
+/specweave:sync-tasks --validate
 # Fail validation if mismatch detected
 ```
 
-### /done
+### /specweave:done
 ```bash
 # Ensure tasks.md is current before closing
-/sync-tasks --auto
+/specweave:sync-tasks --auto
 # Auto-sync if needed, then proceed
 ```
 
@@ -249,7 +249,7 @@ Next: Run /progress to verify
 - ✅ Syncs from git history (fallback)
 - ✅ Updates progress counters accurately
 - ✅ Commits changes with clear message
-- ✅ Integrates with /progress, /validate, /done
+- ✅ Integrates with /specweave:progress, /specweave:validate, /specweave:done
 
 ---
 

package/plugins/specweave/commands/specweave-tdd-cycle.md

@@ -1,3 +1,10 @@
+---
+name: specweave:tdd-cycle
+description: Execute comprehensive TDD workflow with strict red-green-refactor discipline. Orchestrates test-first development with automated validation gates at each phase.
+---
+
+# TDD Cycle - Comprehensive Test-Driven Development
+
 Execute a comprehensive Test-Driven Development (TDD) workflow with strict red-green-refactor discipline:
 
 [Extended thinking: This workflow enforces test-first development through coordinated agent orchestration. Each phase of the TDD cycle is strictly enforced with fail-first verification, incremental implementation, and continuous refactoring. The workflow supports both single test and test suite approaches with configurable coverage thresholds.]

package/plugins/specweave/commands/specweave-tdd-green.md

@@ -1,3 +1,10 @@
+---
+name: specweave:tdd-green
+description: Implement minimal code to make failing tests pass in TDD green phase. Focuses on simplicity and making tests green without over-engineering.
+---
+
+# TDD Green Phase - Make Tests Pass
+
 Implement minimal code to make failing tests pass in TDD green phase:
 
 [Extended thinking: This tool uses the test-automator agent to implement the minimal code necessary to make tests pass. It focuses on simplicity, avoiding over-engineering while ensuring all tests become green.]

package/plugins/specweave/commands/specweave-tdd-red.md

@@ -1,3 +1,10 @@
+---
+name: specweave:tdd-red
+description: Write comprehensive failing tests following TDD red phase principles. Generates failing tests that properly define expected behavior.
+---
+
+# TDD Red Phase - Write Failing Tests
+
 Write comprehensive failing tests following TDD red phase principles.
 
 [Extended thinking: Generates failing tests that properly define expected behavior using test-automator agent.]

package/plugins/specweave/commands/specweave-tdd-refactor.md

@@ -1,3 +1,10 @@
+---
+name: specweave:tdd-refactor
+description: Refactor code with confidence using comprehensive test safety net. Applies design patterns, improves code quality, and optimizes performance while keeping all tests green.
+---
+
+# TDD Refactor Phase - Improve Code Quality
+
 Refactor code with confidence using comprehensive test safety net:
 
 [Extended thinking: This tool uses the tdd-orchestrator agent (opus model) for sophisticated refactoring while maintaining all tests green. It applies design patterns, improves code quality, and optimizes performance with the safety of comprehensive test coverage.]

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

@@ -1,5 +1,5 @@
 ---
-name: translate
+name: specweave:translate
 description: Translate SpecWeave project content to target language using LLM-native zero-cost translation
 ---
 

package/plugins/specweave/commands/specweave-update-scope.md

@@ -1,5 +1,5 @@
 ---
-name: update-scope
+name: specweave:update-scope
 description: Update living completion report with scope changes during increment execution
 ---
 
@@ -50,13 +50,13 @@ Future: "Why was Task 5 removed?" → Check report, find exact reason
 ### Quick Log
 
 ```bash
-/update-scope "Added dark mode toggle (stakeholder request from CMO, +16 hours)"
+/specweave:update-scope "Added dark mode toggle (stakeholder request from CMO, +16 hours)"
 ```
 
 ### Detailed Log
 
 ```bash
-/update-scope
+/specweave:update-scope
 # Interactive prompts:
 # - What changed? (Added/Removed/Modified user story)
 # - What specifically? (e.g., "US6: Dark mode toggle")
@@ -80,7 +80,7 @@ const active = await MetadataManager.getActive();
 
 if (active.length === 0) {
   console.error('❌ No active increment found');
-  console.error('   Run /status to check increment status');
+  console.error('   Run /specweave:status to check increment status');
   process.exit(1);
 }
 
@@ -107,7 +107,7 @@ const reportPath = `.specweave/increments/${increment}/reports/COMPLETION-REPORT
 if (!fs.existsSync(reportPath)) {
   console.error('❌ Completion report not found');
   console.error(`   Expected: ${reportPath}`);
-  console.error('   Run /inc to create increment properly');
+  console.error('   Run /specweave:increment to create increment properly');
   process.exit(1);
 }
 
@@ -342,9 +342,9 @@ Always include:
 
 ## Related Commands
 
-- `/inc "feature"` - Creates increment with initial completion report
-- `/done <id>` - Finalizes report and marks increment complete
-- `/status` - Check which increment is active
+- `/specweave:increment "feature"` - Creates increment with initial completion report
+- `/specweave:done <id>` - Finalizes report and marks increment complete
+- `/specweave:status` - Check which increment is active
 
 ---