specweave 0.7.1 → 0.8.1

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

@@ -1,18 +1,16 @@
 ---
-name: validate
+name: specweave:validate
 description: Validate SpecWeave increment with rule-based checks and optional AI quality assessment
 ---
 
 # Validate Increment
 
-**⚡ Convenient Short Form**: Use `/validate` for quick access, or `/specweave:validate` for explicit namespace.
-
 You are helping the user validate a SpecWeave increment with optional AI-powered quality assessment.
 
 ## Usage
 
 ```bash
-/validate-increment <increment-id> [--quality] [--export] [--fix] [--always]
+/specweave:validate <increment-id> [--quality] [--export] [--fix] [--always]
 ```
 
 ## Arguments
@@ -30,7 +28,7 @@ You are helping the user validate a SpecWeave increment with optional AI-powered
 ### Step 1: Parse and Validate Arguments
 
 1. **Extract increment ID**:
-   - Parse from command: `/validate-increment 001` → "001"
+   - Parse from command: `/specweave:validate 001` → "001"
    - Normalize to 4-digit format: "0001"
    - Support formats: "1", "01", "001", "0001"
 
@@ -54,7 +52,7 @@ Available increments:
   • 0003-payment-processing
   • 0004-reporting-dashboard
 
-Usage: /validate-increment <id> [--quality] [--export] [--fix] [--always]
+Usage: /specweave:validate-increment <id> [--quality] [--export] [--fix] [--always]
 ```
 
 ### Step 2: Run Rule-Based Validation (Always)
@@ -438,7 +436,7 @@ To disable:
   1. Initialize your project
   2. Set validation.quality_judge.always_run: false
 
-Or run: /validate-increment <id> (quality will run automatically)
+Or run: /specweave:validate-increment <id> (quality will run automatically)
 ```
 
 ### Step 8: Generate Validation Report
@@ -451,7 +449,7 @@ Or run: /validate-increment <id> (quality will run automatically)
 # Validation Report: Increment 0001-authentication
 
 Generated: 2025-10-28 14:32:15 UTC
-Command: /validate-increment 001 --quality
+Command: /specweave:validate-increment 001 --quality
 
 ## Executive Summary
 
@@ -554,7 +552,7 @@ Command: /validate-increment 001 --quality
 
 | Date | Rule-Based | Quality Score | Command |
 |------|------------|---------------|---------|
-| 2025-10-28 | 120/120 | 87/100 | /validate-increment 001 --quality |
+| 2025-10-28 | 120/120 | 87/100 | /specweave:validate-increment 001 --quality |
 | 2025-10-25 | 115/120 | N/A | Auto-validation on save |
 | 2025-10-24 | 110/120 | N/A | Auto-validation on save |
 
@@ -575,7 +573,7 @@ For details: .specweave/docs/internal/delivery/guides/increment-validation.md
 ### Example 1: Basic Validation (Rule-Based Only)
 
 ```bash
-/validate-increment 001
+/specweave:validate 001
 ```
 
 **Output**:
@@ -588,7 +586,7 @@ For details: .specweave/docs/internal/delivery/guides/increment-validation.md
 ### Example 2: Validation with Quality Assessment
 
 ```bash
-/validate-increment 001 --quality
+/specweave:validate 001 --quality
 ```
 
 **Output**:
@@ -605,7 +603,7 @@ Suggestions: 3 (2 high, 1 medium)
 ### Example 3: Validate and Export Suggestions
 
 ```bash
-/validate-increment 001 --quality --export
+/specweave:validate 001 --quality --export
 ```
 
 **Output**:
@@ -622,7 +620,7 @@ Suggestions: 3 (2 high, 1 medium)
 ### Example 4: Auto-Fix Issues
 
 ```bash
-/validate-increment 001 --quality --fix
+/specweave:validate 001 --quality --fix
 ```
 
 **Output**:
@@ -643,7 +641,7 @@ Re-validated: 92/100 (improvement: +5)
 ### Example 5: Make Quality Assessment Default
 
 ```bash
-/validate-increment 001 --always
+/specweave:validate 001 --always
 ```
 
 **Output**:
@@ -665,7 +663,7 @@ Available increments:
   • 0002-core-enhancements
   • 0003-payment-processing
 
-Usage: /validate-increment <id> [--quality] [--export] [--fix] [--always]
+Usage: /specweave:validate-increment <id> [--quality] [--export] [--fix] [--always]
 ```
 
 ### Invalid Flags
@@ -678,7 +676,7 @@ Valid flags:
   --fix       Auto-fix issues (experimental)
   --always    Make quality assessment default
 
-Usage: /validate-increment <id> [--quality] [--export] [--fix] [--always]
+Usage: /specweave:validate-increment <id> [--quality] [--export] [--fix] [--always]
 ```
 
 ### Quality Assessment Failed
@@ -688,7 +686,7 @@ Usage: /validate-increment <id> [--quality] [--export] [--fix] [--always]
 ✅ Rule-based validation completed successfully (120/120)
 
 You can:
-  1. Try again: /validate-increment 001 --quality
+  1. Try again: /specweave:validate-increment 001 --quality
   2. Continue with rule-based results
   3. Check logs: .specweave/increments/0001-name/logs/validation.log
 ```
@@ -709,7 +707,7 @@ Export suggestions to tasks? [Y/n]: _
 
 This command can be triggered by:
 
-1. **Manual execution**: `/validate-increment 001 --quality`
+1. **Manual execution**: `/specweave:validate 001 --quality`
 2. **Post-document-save hook**: Auto-runs rule-based validation
 3. **Pre-implementation hook**: Validates before starting tasks
 4. **CI/CD pipeline**: Automated validation in GitHub Actions
@@ -724,7 +722,7 @@ if [[ "$FILE" =~ spec\.md|plan\.md|tasks\.md|tests\.md ]]; then
   INCREMENT_ID=$(echo "$FILE" | grep -oP '(?<=increments/)\d{4}')
 
   # Run validation (rule-based only, no quality unless config says so)
-  /validate-increment "$INCREMENT_ID"
+  /specweave:validate-increment "$INCREMENT_ID"
 fi
 ```
 
@@ -749,6 +747,6 @@ All validation settings use sensible defaults. Quality assessment is prompted ea
 
 **Important**: This command works alongside intent-based validation. Users can say:
 - "Validate quality of increment 001" (intent-based)
-- `/validate-increment 001 --quality` (slash command)
+- `/specweave:validate 001 --quality` (slash command)
 
 Both routes activate the same validation logic for consistency.

package/plugins/specweave/commands/specweave.md

@@ -295,11 +295,11 @@ swnext                    # Instead of /specweave next
 ```yaml
 # .claude/config.yaml
 command_aliases:
-  /inc: /specweave inc
-  /do: /specweave do
-  /next: /specweave next
-  /done: /specweave done
-  /progress: /specweave progress
+  /specweave:increment: /specweave inc
+  /specweave:do: /specweave do
+  /specweave:next: /specweave next
+  /specweave:done: /specweave done
+  /specweave:progress: /specweave progress
 ```
 
 **Usage**:

package/plugins/specweave/skills/SKILLS-INDEX.md

@@ -77,7 +77,7 @@ Step 4: Execute → Follow the increment planning workflow
 
 #### specweave-detector
 
-**Description**: Detects SpecWeave context (.specweave/ directory exists) and provides workflow documentation. v0.3.8+ features PROACTIVE auto-detection - when in SpecWeave folder, product descriptions automatically trigger increment planning. Explicit slash commands still work (/inc, /do, /progress, /validate, /done, /sync-docs, /sync-github). Keywords slash commands, /inc, /increment, /do, /progress, /validate, /done, specweave commands, smart workflow, auto-detection, specweave folder.
+**Description**: Detects SpecWeave context (.specweave/ directory exists) and provides workflow documentation. v0.3.8+ features PROACTIVE auto-detection - when in SpecWeave folder, product descriptions automatically trigger increment planning. Explicit slash commands still work (/specweave:increment, /specweave:do, /specweave:progress, /specweave:validate, /specweave:done, /specweave:sync-docs, /sync-github). Keywords slash commands, specweave commands, smart workflow, auto-detection, specweave folder.
 
 **Location**: `.claude/skills/specweave-detector/SKILL.md`
 

package/plugins/specweave/skills/increment-planner/SKILL.md

@@ -33,6 +33,7 @@ The increment-planner skill automates the creation of implementation plans for A
 - Constitutional compliance
 - Separation of WHAT/WHY (spec) from HOW (plan) from STEPS (tasks with test plans)
 - **v0.7.0+**: Test-Aware Planning (bidirectional AC↔Task↔Test linking)
+- **v0.8.0+**: Multi-Project Support (specs organized by project/team)
 
 ## Increment Types (v0.7.0+)
 
@@ -84,6 +85,34 @@ This skill activates automatically when users say:
 
 ---
 
+## 🆕 Multi-Project Support (v0.8.0+)
+
+**Key Changes**:
+- Specs are now organized by project: `.specweave/docs/internal/projects/{project-id}/specs/`
+- Use `ProjectManager` (from `src/core/project-manager.ts`) to get correct paths
+- Single project uses `projects/default/` automatically (transparent)
+- Multi-project mode allows multiple teams/repos
+
+**Path Resolution**:
+```typescript
+import { ProjectManager } from '../../core/project-manager';
+
+const projectManager = new ProjectManager(projectRoot);
+const activeProject = projectManager.getActiveProject();
+
+// Get correct paths for active project
+const specsPath = projectManager.getSpecsPath();  // projects/{activeProject.id}/specs/
+const modulesPath = projectManager.getModulesPath();  // projects/{activeProject.id}/modules/
+const teamPath = projectManager.getTeamPath();  // projects/{activeProject.id}/team/
+```
+
+**In PM Agent Instructions**:
+- DO NOT hardcode `.specweave/docs/internal/specs/`
+- USE ProjectManager to get correct path for active project
+- Specs go to: `{projectManager.getSpecsPath()}/spec-{number}-{name}.md`
+
+---
+
 ## ⚠️ CRITICAL: Living Documentation Workflow
 
 **MANDATORY**: Feature planner must orchestrate **BOTH** living docs and increment files.
@@ -114,7 +143,9 @@ Task(
   You MUST create living Spec (living docs - source of truth) AND optionally create increment spec.md:
 
   1. Spec (living docs - SOURCE OF TRUTH, permanent):
-     - Create .specweave/docs/internal/specs/spec-{number}-{name}/spec.md
+     - IMPORTANT: Use ProjectManager to get correct path for active project
+     - Create at: {projectManager.getSpecsPath()}/spec-{number}-{name}.md
+       (This resolves to projects/{activeProject}/specs/ automatically)
      - This is the COMPLETE, PERMANENT source of truth
      - Include ALL of:
        * User stories (US-001, US-002, etc.) with full details
@@ -236,12 +267,17 @@ STEP 5: Validate Living Docs and Increment Files
 
 #### Living Spec (Living Docs - Source of Truth) ✅
 ```
-.specweave/docs/internal/specs/
-└── spec-{number}-{name}/             # ← PM Agent (MANDATORY)
-    └── spec.md                      # COMPLETE user stories, AC, requirements
+.specweave/docs/internal/projects/{project-id}/specs/  # ← Multi-project (v0.8.0+)
+└── spec-{number}-{name}.md          # ← PM Agent (MANDATORY)
+                                     # COMPLETE user stories, AC, requirements
                                      # This is the PERMANENT source of truth
                                      # Can be linked to Jira/ADO/GitHub Issues
                                      # Persists after increment completes
+
+# Examples:
+# Single project: projects/default/specs/spec-001-user-auth.md
+# Multi-project: projects/web-app/specs/spec-001-user-auth.md
+#                projects/mobile/specs/spec-001-push-notifications.md
 ```
 
 #### Strategy Docs (Optional, High-Level) ⚠️

package/plugins/specweave/skills/increment-quality-judge/SKILL.md

@@ -25,7 +25,7 @@ Provide nuanced quality assessment of SpecWeave artifacts (spec.md, plan.md, tes
 
 **Triggered by:**
 - Natural language: "validate quality of increment 0001", "quality check", "assess spec"
-- Slash command: `/validate-increment 0001 --quality` (supports --export, --fix, --always flags)
+- Slash command: `/specweave:validate 0001 --quality` (supports --export, --fix, --always flags)
 - Manual invocation when reviewing docs
 
 ## What It Does
@@ -116,7 +116,7 @@ interface Suggestion {
 ### 3. Interactive Workflow
 
 ```bash
-/validate-increment 001
+/specweave:validate 001
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 VALIDATION RESULTS: Increment 0001-authentication
@@ -352,7 +352,7 @@ if (confidence < 0.80) {
 ### Current: Rule-Based Only
 
 ```
-User: /validate-increment 001
+User: /specweave:validate-increment 001
 ↓
 Run 120 rule-based checks
 ↓
@@ -362,7 +362,7 @@ Show results: ✅ PASSED or ❌ FAILED
 ### With Quality Judge (Interactive)
 
 ```
-User: /validate-increment 001
+User: /specweave:validate-increment 001
 ↓
 Run 120 rule-based checks
 ↓
@@ -380,7 +380,7 @@ Prompt: "Export suggestions to tasks? [Y/n]"
 ### With Quality Judge (Always-On)
 
 ```
-User: /validate-increment 001
+User: /specweave:validate-increment 001
 ↓
 Run in parallel:
   • Rule-based checks (120 rules)

package/plugins/specweave/skills/increment-quality-judge-v2/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: increment-quality-judge-v2
-description: Enhanced AI-powered quality assessment with RISK SCORING (BMAD pattern) and quality gate decisions. Evaluates specifications, plans, and tests for clarity, testability, completeness, feasibility, maintainability, edge cases, and RISKS. Provides PASS/CONCERNS/FAIL decisions. Activates for validate quality, quality check, assess spec, evaluate increment, spec review, quality score, risk assessment, qa check, quality gate, /qa command.
+description: Enhanced AI-powered quality assessment with RISK SCORING (BMAD pattern) and quality gate decisions. Evaluates specifications, plans, and tests for clarity, testability, completeness, feasibility, maintainability, edge cases, and RISKS. Provides PASS/CONCERNS/FAIL decisions. Activates for validate quality, quality check, assess spec, evaluate increment, spec review, quality score, risk assessment, qa check, quality gate, /specweave:qa command.
 allowed-tools: Read, Grep, Glob
 ---
 
@@ -303,7 +303,7 @@ Would you like to:
 ### Quick Mode (Default)
 
 ```
-User: /qa 0001
+User: /specweave:qa 0001
 
 Step 1: Rule-based validation (120 checks) - FREE, FAST
 ├── If FAILED → Stop, show errors
@@ -320,7 +320,7 @@ Output: Enhanced report with risks and gate decision
 ### Pre-Implementation Mode
 
 ```
-User: /qa 0001 --pre
+User: /specweave:qa 0001 --pre
 
 Checks:
 ✅ Spec quality (clarity, testability, completeness)
@@ -334,7 +334,7 @@ Gate decision before implementation starts
 ### Quality Gate Mode
 
 ```
-User: /qa 0001 --gate
+User: /specweave:qa 0001 --gate
 
 Comprehensive checks:
 ✅ All pre-implementation checks
@@ -496,4 +496,4 @@ gate_decision = decide({
 
 **Version**: 2.0.0
 **Since**: v0.8.0
-**Related**: /qa command, QAOrchestrator agent (v0.9.0)
+**Related**: /specweave:qa command, QAOrchestrator agent (v0.9.0)

package/plugins/specweave/skills/specweave-detector/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: specweave-detector
-description: Detects SpecWeave context (.specweave/ directory exists) and provides workflow documentation. v0.3.8+ features PROACTIVE auto-detection - when in SpecWeave folder, product descriptions automatically trigger increment planning. Explicit slash commands still work (/inc, /do, /progress, /validate, /done, /specweave:sync-docs, /sync-github). Keywords slash commands, /inc, /increment, /do, /progress, /validate, /done, specweave commands, smart workflow, auto-detection, specweave folder.
+description: Detects SpecWeave context (.specweave/ directory exists) and provides workflow documentation. v0.3.8+ features PROACTIVE auto-detection - when in SpecWeave folder, product descriptions automatically trigger increment planning. Explicit slash commands still work (/inc, /specweave:do, /specweave:progress, /specweave:validate, /specweave:done, /specweave:sync-docs, /sync-github). Keywords slash commands, /specweave:increment, /increment, /specweave:do, /specweave:progress, /specweave:validate, /specweave:done, specweave commands, smart workflow, auto-detection, specweave folder.
 ---
 
 # SpecWeave - Smart Workflow with Auto-Detection
@@ -86,7 +86,7 @@ npx specweave init my-saas
 /do
 # Auto-finds active increment 0002
 
-# Repeat: /inc → /do → /progress → /inc (auto-closes) → /do...
+# Repeat: /specweave:increment → /specweave:do → /specweave:progress → /specweave:increment (auto-closes) → /specweave:do...
 ```
 
 ## Command Details
@@ -329,7 +329,7 @@ User: "What SpecWeave commands are available?"
 **Command syntax**:
 ```
 User: "How do I create a new increment?"
-→ Claude explains /inc command with examples
+→ Claude explains /specweave:increment command with examples
 ```
 
 ## Documentation

package/plugins/specweave-ado/commands/{close-workitem.md → specweave-ado-close-workitem.md}

@@ -1,5 +1,5 @@
 ---
-name: close-workitem
+name: specweave-ado:close-workitem
 description: Close Azure DevOps work item when increment complete
 ---
 

package/plugins/specweave-ado/commands/{create-workitem.md → specweave-ado-create-workitem.md}

@@ -1,5 +1,5 @@
 ---
-name: create-workitem
+name: specweave-ado:create-workitem
 description: Create Azure DevOps work item from SpecWeave increment
 ---
 

package/plugins/specweave-ado/commands/{status.md → specweave-ado-status.md}

@@ -1,5 +1,5 @@
 ---
-name: status
+name: specweave-ado:status
 description: Check Azure DevOps sync status for increment
 ---
 

package/plugins/specweave-ado/commands/{sync.md → specweave-ado-sync.md}

@@ -1,5 +1,5 @@
 ---
-name: sync
+name: specweave-ado:sync
 description: Sync SpecWeave increment progress with Azure DevOps work item
 ---