specweave 0.7.1 → 0.8.1

package/dist/utils/project-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detection.js","sourceRoot":"","sources":["../../src/utils/project-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAE/D,8BAA8B;QAC9B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,kBAAkB;QAClB,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAEzD,wDAAwD;QACxD,2CAA2C;QAC3C,qCAAqC;QACrC,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC/F,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QAEpF,MAAM,KAAK,GAAG,UAAU,IAAI,QAAQ,CAAC;QAErC,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAEjC,qEAAqE;YACrE,IAAI,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpC,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC;YAChC,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sDAAsD;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;QAEpC,8CAA8C;QAC9C,IAAI,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAkB,CAAC;YAEtE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,qCAAqC;gBACrC,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBAClC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAa,CAAC;oBAC3C,IAAI,YAAY,EAAE,IAAI,EAAE,CAAC;wBACvB,OAAO,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;oBACzC,CAAC;gBACH,CAAC;gBAED,iCAAiC;gBACjC,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;oBAChC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAa,CAAC;oBACzC,IAAI,UAAU,EAAE,UAAU,EAAE,CAAC;wBAC3B,OAAO,UAAU,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;oBAC7C,CAAC;gBACH,CAAC;gBAED,0CAA0C;gBAC1C,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;oBAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,MAAa,CAAC;oBACxC,IAAI,SAAS,EAAE,OAAO,EAAE,CAAC;wBACvB,OAAO,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;oBAC9D,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,sDAAsD;QACtD,IAAI,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YAClC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QACnD,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/C,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,qCAAqC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAoB;IAC3D,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,iEAAiE;YAC1E,OAAO,EAAE,WAAW,IAAI,SAAS;YACjC,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;gBAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,OAAO,wBAAwB,CAAC;gBAClC,CAAC;gBAED,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBACjC,OAAO,yEAAyE,CAAC;gBACnF,CAAC;gBAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,OAAO,0CAA0C,CAAC;gBACpD,CAAC;gBAED,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;oBACtB,OAAO,0CAA0C,CAAC;gBACpD,CAAC;gBAED,OAAO,IAAI,CAAC;YACd,CAAC;SACF,CAAC,CAAC,CAAC;IAEJ,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAAmB,EACnB,UAEI,EAAE;IAEN,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAEnC,oBAAoB;IACpB,MAAM,YAAY,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACzD,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,8BAA8B,YAAY,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,qBAAqB;IACrB,MAAM,aAAa,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;IAC3D,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,kCAAkC,aAAa,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,2BAA2B;IAC3B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB,EACnB,UAGI,EAAE;IAEN,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,mBAAmB,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAE/D,oBAAoB;IACpB,MAAM,YAAY,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACzD,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,8BAA8B,YAAY,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,qBAAqB;IACrB,MAAM,aAAa,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;IAC3D,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,kCAAkC,aAAa,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,8BAA8B;IAC9B,IAAI,mBAAmB,EAAE,CAAC;QACxB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;YACtE,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,MAAM,kBAAkB,EAAE,CAAC;IACpC,CAAC;IAED,uCAAuC;IACvC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,sCAAsC;IACtC,MAAM,YAAY,GAA2B;QAC3C,WAAW,EAAE,WAAW;QACxB,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,iBAAiB;KAC7B,CAAC;IAEF,IAAI,YAAY,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAC1C,OAAO,YAAY,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,iDAAiD;IACjD,OAAO,SAAS;SACb,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SACvE,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,wBAAwB,CAAC;IAClC,CAAC;IAED,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,OAAO,yEAAyE,CAAC;IACnF,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,0CAA0C,CAAC;IACpD,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC1B,OAAO,0CAA0C,CAAC;IACpD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.7.1",
+  "version": "0.8.1",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",
@@ -69,6 +69,7 @@
     "chalk": "^5.3.0",
     "commander": "^14.0.2",
     "fs-extra": "^11.2.0",
+    "gray-matter": "^4.0.3",
     "inquirer": "^12.10.0",
     "js-yaml": "^4.1.0",
     "ora": "^9.0.0",

package/plugins/specweave/agents/pm/AGENT.md

@@ -147,7 +147,8 @@ if (shouldSuggestLivingDocs) {
   console.log('  ✅ Complete requirements in one place');
   console.log('  ✅ Increment specs reference it (avoid duplication)');
   console.log('');
-  console.log('Location: .specweave/docs/internal/specs/spec-####-{name}/spec.md');
+  console.log('Location: .specweave/docs/internal/specs/spec-####-{name}.md');
+  console.log('⚠️  CRITICAL: Specs are FILES, not directories!');
   console.log('');
   console.log('💡 See FAQ: https://spec-weave.com/docs/faq#do-i-need-both-for-every-feature');
   console.log('');
@@ -232,7 +233,9 @@ The PM Agent acts as your AI Product Manager, helping you:
 
 ### Output 1: Spec (Living Docs - Source of Truth, Permanent) ✅
 
-**Location**: `.specweave/docs/internal/specs/spec-{number}-{name}/spec.md`
+**Location**: `.specweave/docs/internal/specs/spec-{number}-{name}.md`
+
+**CRITICAL**: Specs are **FILES**, not directories! The spec file itself contains all content.
 
 **Purpose**: Complete, detailed requirements specification - PERMANENT source of truth
 
@@ -442,7 +445,7 @@ High-level business context: [Strategy Overview](../../docs/internal/strategy/{m
 ```markdown
 # Feature: [Name]
 
-**Complete Requirements**: See [SPEC-{number}-{name}](../../docs/internal/specs/spec-{number}-{name}/spec.md)
+**Complete Requirements**: See [SPEC-{number}-{name}](../../docs/internal/specs/spec-{number}-{name}.md)
 
 **Quick Summary**:
 - US-001: View current weather
@@ -1283,7 +1286,7 @@ Total estimated effort to fix: X hours
 Action Plan:
   1. [Step-by-step plan to address blockers]
   2. [...]
-  3. Re-run /done {id} for validation
+  3. Re-run /specweave:done {id} for validation
 
 Increment remains: in-progress
 ```

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

@@ -1,5 +1,5 @@
 ---
-name: abandon
+name: specweave:abandon
 description: Abandon an incomplete increment (requirements changed, obsolete)
 usage: /specweave:abandon <increment-id> --reason="<reason>"
 ---
@@ -42,7 +42,7 @@ Abandon an increment when:
 
 ### Abandon with reason
 ```bash
-/abandon 0008 --reason="Requirements changed - feature no longer needed"
+/specweave:abandon 0008 --reason="Requirements changed - feature no longer needed"
 
 ⚠️  This will move increment 0008 to _abandoned/
    Reason: Requirements changed - feature no longer needed
@@ -59,7 +59,7 @@ Continue? [y/N]: y
 
 ### Abandon without reason (prompts)
 ```bash
-/abandon 0009
+/specweave:abandon 0009
 
 ❓ Why are you abandoning this increment?
    1. Requirements changed
@@ -85,7 +85,7 @@ Continue? [y/N]: y
 
 ### Cannot Abandon Completed
 ```bash
-/abandon 0005
+/specweave:abandon 0005
 
 ❌ Cannot abandon increment 0005
    Status: completed
@@ -96,7 +96,7 @@ Continue? [y/N]: y
 
 ### Already Abandoned
 ```bash
-/abandon 0008
+/specweave:abandon 0008
 
 ⚠️  Increment 0008 is already abandoned
    Location: .specweave/increments/_abandoned/0008-old-feature/
@@ -107,15 +107,15 @@ No action needed.
 
 ### Increment Not Found
 ```bash
-/abandon 9999
+/specweave:abandon 9999
 
 ❌ Increment not found: 9999
-💡 Check available increments: /status
+💡 Check available increments: /specweave:status
 ```
 
 ### Cancel Abandonment
 ```bash
-/abandon 0008 --reason="Not needed"
+/specweave:abandon 0008 --reason="Not needed"
 
 ⚠️  This will move increment 0008 to _abandoned/
    Reason: Not needed
@@ -209,7 +209,7 @@ mv .specweave/increments/_abandoned/0008-feature \
    .specweave/increments/0008-feature
 
 # 2. Resume via command
-/resume 0008
+/specweave:resume 0008
 
 ✅ Increment 0008 resumed
 ⚠️  Note: Was abandoned 10 days ago
@@ -221,10 +221,10 @@ mv .specweave/increments/_abandoned/0008-feature \
 
 ## Related Commands
 
-- `/pause <id>` - Pause increment (temporary, can resume)
-- `/resume <id>` - Resume paused or abandoned increment
-- `/status` - Show all increments (including abandoned count)
-- `/status --abandoned` - Show only abandoned increments
+- `/specweave:pause <id>` - Pause increment (temporary, can resume)
+- `/specweave:resume <id>` - Resume paused or abandoned increment
+- `/specweave:status` - Show all increments (including abandoned count)
+- `/specweave:status --abandoned` - Show only abandoned increments
 
 ---
 
@@ -255,7 +255,7 @@ Experiments (--type=experiment) auto-abandon after **14 days** of inactivity:
 # ... 15 days pass with no activity ...
 
 # Automatic abandonment
-/status
+/specweave:status
 
 📊 Auto-Abandoned (1):
   🧪 0010-graphql-experiment [experiment]
@@ -264,7 +264,7 @@ Experiments (--type=experiment) auto-abandon after **14 days** of inactivity:
      Last activity: 15 days ago
 
 💡 Experiments auto-abandon after 14 days of inactivity
-   To prevent: Update lastActivity via /do or manual touch
+   To prevent: Update lastActivity via /specweave:do or manual touch
 ```
 
 ---
@@ -274,7 +274,7 @@ Experiments (--type=experiment) auto-abandon after **14 days** of inactivity:
 View abandonment statistics:
 
 ```bash
-/status
+/specweave:status
 
 ✅ Completed (4):
   0001-core-framework
@@ -308,7 +308,7 @@ Abandoned work is valuable!
 
 ---
 
-**Command**: `/specweave:abandon` (or `/abandon`)
+**Command**: `/specweave:abandon`
 **Plugin**: specweave (core)
 **Version**: v0.7.0+
 **Part of**: Increment 0007 - Smart Status Management

package/plugins/specweave/commands/specweave-check-tests.md

@@ -1,5 +1,5 @@
 ---
-name: check-tests
+name: specweave: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
-/check-tests
+/specweave:check-tests
 
 # Check tests for specific increment
-/check-tests 0007
+/specweave:check-tests 0007
 
 # Detailed report with test case breakdown
-/check-tests 0007 --detailed
+/specweave:check-tests 0007 --detailed
 
 # AC-ID coverage report only
-/check-tests 0007 --ac-coverage
+/specweave:check-tests 0007 --ac-coverage
 ```
 
 ---
@@ -58,7 +58,7 @@ Shows:
 ## Output Example (NEW Format)
 
 ```bash
-/check-tests 0007
+/specweave:check-tests 0007
 
 📊 Test Status Report: 0007-smart-increment-discipline
 
@@ -138,7 +138,7 @@ Summary:
 ## Detailed Report (--detailed flag)
 
 ```bash
-/check-tests 0007 --detailed
+/specweave: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
-/check-tests 0007 --ac-coverage
+/specweave: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
-/check-tests 0003  # Old format increment
+/specweave:check-tests 0003  # Old format increment
 
 ⚠️  OLD FORMAT DETECTED: tests.md exists
 
@@ -365,12 +365,12 @@ if (hasTestsMd) {
    ```bash
    # Implement T-001
    # Write tests
-   /check-tests  # Verify tests pass
+   /specweave:check-tests  # Verify tests pass
    ```
 
 2. **Before PR**: Ensure coverage meets targets
    ```bash
-   /check-tests 0007
+   /specweave: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
-   /done 0007
-   # PM Agent runs /check-tests automatically
+   /specweave:done 0007
+   # PM Agent runs /specweave:check-tests automatically
    # Verifies >80% coverage before closure
    ```
 
@@ -396,7 +396,7 @@ if (hasTestsMd) {
 For CI/CD integration:
 
 ```bash
-/check-tests 0007
+/specweave:check-tests 0007
 echo $?  # Exit code
 
 # Exit codes:

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

@@ -1,5 +1,5 @@
 ---
-name: costs
+name: specweave:costs
 description: Display AI cost dashboard for current or specified increment with real-time savings tracking
 ---
 

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

@@ -1,5 +1,5 @@
 ---
-name: do
+name: specweave:do
 description: Execute increment implementation following spec and plan - hooks run after EVERY task
 ---
 
@@ -367,8 +367,8 @@ This will:
 
 Next steps:
 1. Run full test suite: npm test
-2. Validate increment: /validate 0001 --quality
-3. Close increment: /done 0001 (PM validates before closing)
+2. Validate increment: /specweave:validate 0001 --quality
+3. Close increment: /specweave:done 0001 (PM validates before closing)
 ```
 
 ---
@@ -445,7 +445,7 @@ After each task, Claude should manually update:
 ### Example 1: Execute Complete Increment
 
 ```bash
-/do 0001
+/specweave:do 0001
 ```
 
 **Output**:
@@ -465,13 +465,13 @@ Task T001: Create User model
 
 🎉 All tasks completed (42/42)
 
-Next: /validate 0001 --quality
+Next: /specweave:validate 0001 --quality
 ```
 
 ### Example 2: Execute with Blocker
 
 ```bash
-/do 0002
+/specweave:do 0002
 ```
 
 **Output**:
@@ -494,7 +494,7 @@ Your choice? [A/B/C]: _
 ### Example 3: Execute with Test Failure
 
 ```bash
-/do 0003
+/specweave:do 0003
 ```
 
 **Output**:
@@ -531,7 +531,7 @@ Available increments:
   • 0002-core-enhancements (planned)
   • 0003-payment-processing (in-progress)
 
-Usage: /do <increment-id>
+Usage: /specweave:do <increment-id>
 ```
 
 ### Increment Not Planned
@@ -540,7 +540,7 @@ Usage: /do <increment-id>
 
 Increment must be "planned" before execution.
 
-Run: /increment "User authentication" to plan this increment first.
+Run: /specweave:increment "User authentication" to plan this increment first.
 ```
 
 ### No Tasks to Execute
@@ -552,7 +552,7 @@ This usually means:
   2. Tasks.md is empty or missing
 
 Options:
-  1. Re-plan increment: /increment 0001 (regenerate tasks)
+  1. Re-plan increment: /specweave:increment 0001 (regenerate tasks)
   2. Add tasks manually: Edit .specweave/increments/0001-name/tasks.md
 ```
 
@@ -591,6 +591,6 @@ Options:
 
 ---
 
-**Important**: This command is designed for continuous execution. It's normal to run `/do` and let it execute multiple tasks sequentially with documentation updates after each one.
+**Important**: This command is designed for continuous execution. It's normal to run `/specweave:do` and let it execute multiple tasks sequentially with documentation updates after each one.
 
-**Best Practice**: Always run `/validate 0001 --quality` after execution to ensure quality before closing with `/done`.
+**Best Practice**: Always run `/specweave:validate 0001 --quality` after execution to ensure quality before closing with `/specweave:done`.

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

@@ -1,20 +1,20 @@
 ---
-name: done
+name: specweave:done
 description: Close increment with PM validation - checks tasks, tests, and docs before closing
 ---
 
 # Close Increment (PM Validated)
 
-**⚡ Convenient Short Form**: Use `/done` for quick access, or `/specweave:done` for explicit namespace.
-
 **Product Manager-Led Closure**: PM validates tasks, tests, and docs before closing.
 
 You are acting as the Product Manager to validate increment completion before closure. You must check all 3 gates: tasks done, tests passing, and docs updated.
 
+**NEW (v0.8.0+)**: Automatic GitHub issue reopening when validation fails. If PM gates fail and a GitHub issue exists for this increment, the system automatically reopens the issue with validation failure details. This ensures issues aren't prematurely closed when work is incomplete.
+
 ## Usage
 
 ```bash
-/done <increment-id>
+/specweave:done <increment-id>
 ```
 
 ## Arguments
@@ -316,7 +316,7 @@ Closing increment 0001-user-authentication...
 Next steps:
   1. Create PR: git push && gh pr create
   2. Deploy to staging: npm run deploy:staging
-  3. Create new increment: /increment "Next feature"
+  3. Create new increment: /specweave:increment "Next feature"
 ```
 
 #### Scenario B: One or More Gates Fail ❌
@@ -348,11 +348,24 @@ Action Plan:
   2. Complete T008 (JWT validation) - 3h
   3. Update CLAUDE.md - 30m
   4. Update README.md - 1h
-  5. Re-run /done 0001 for validation
+  5. Re-run /specweave:done 0001 for validation
 
 Increment remains: in-progress
 
-Try again after fixing blockers: /done 0001
+🔄 GitHub Issue Auto-Reopen (if exists):
+  Checking metadata for GitHub issue...
+  ✓ Found: GitHub issue #42
+  ✓ Reopening with validation failure details...
+  ✓ Issue #42 reopened with comment:
+    "❌ Validation failed - increment not ready for closure
+
+     Gate failures:
+     • Gate 1: 2 P1 tasks incomplete
+     • Gate 3: Documentation outdated
+
+     See PM validation report for details."
+
+Try again after fixing blockers: /specweave:done 0001
 ```
 
 ### Step 4: Handle Incomplete Work
@@ -397,7 +410,7 @@ Closing increment 0001-user-authentication...
 ### Example 1: Successful Closure
 
 ```bash
-/done 0001
+/specweave:done 0001
 ```
 
 **Output**:
@@ -410,13 +423,13 @@ PM Approval: ✅ APPROVED
 
 🎉 Increment 0001 closed successfully!
 
-Next: /increment "Next feature"
+Next: /specweave:increment "Next feature"
 ```
 
 ### Example 2: Blocked by Failing Tests
 
 ```bash
-/done 0002
+/specweave:done 0002
 ```
 
 **Output**:
@@ -437,7 +450,7 @@ Increment remains: in-progress
 ### Example 3: Blocked by Outdated Docs
 
 ```bash
-/done 0003
+/specweave:done 0003
 ```
 
 **Output**:
@@ -460,7 +473,7 @@ Increment remains: in-progress
 ### Example 4: Scope Creep - Transfer to Next Increment
 
 ```bash
-/done 0004
+/specweave:done 0004
 ```
 
 **Output**:
@@ -494,7 +507,7 @@ Available increments:
   • 0002-core-enhancements (in-progress)
   • 0003-payment-processing (planned)
 
-Usage: /done <increment-id>
+Usage: /specweave:done <increment-id>
 ```
 
 ### Increment Not In-Progress
@@ -503,7 +516,7 @@ Usage: /done <increment-id>
 
 Increment must be "in-progress" before closing.
 
-Run: /do 0001 to start implementation first.
+Run: /specweave:do 0001 to start implementation first.
 ```
 
 ### Major Blockers Found
@@ -559,7 +572,7 @@ All PM validation settings use sensible defaults:
 
 **Important**: This command represents PM validation and MUST NOT be bypassed. All 3 gates (tasks, tests, docs) must pass before increment can close.
 
-**Best Practice**: Always run `/validate 0001 --quality` before `/done 0001` to catch issues early.
+**Best Practice**: Always run `/specweave:validate 0001 --quality` before `/specweave:done 0001` to catch issues early.
 
 **PM Role**: The PM agent acts as the final quality gate, ensuring:
 - ✅ Business value delivered (tasks complete)