specweave 1.0.212 → 1.0.213

package/CLAUDE.md

@@ -1,4 +1,4 @@
-<!-- SW:META template="claude" version="1.0.211" sections="header,start,autodetect,metarule,rules,workflow,reflect,context,structure,taskformat,secrets,syncing,testing,tdd,api,limits,troubleshooting,lazyloading,principles,linking,mcp,auto,docs" -->
+<!-- SW:META template="claude" version="1.0.212" sections="header,start,autodetect,metarule,rules,workflow,reflect,context,structure,taskformat,secrets,syncing,testing,tdd,api,limits,troubleshooting,lazyloading,principles,linking,mcp,auto,docs" -->
 
 <!-- SW:SECTION:hook-priority version="1.0.171" -->
 ## ⛔ Hook Instructions Override Everything
@@ -13,7 +13,7 @@
 **SKILL FIRST ≠ only one skill.** Chain: hook skill → `sw-frontend:*` / `sw-backend:*` / etc → implement.
 <!-- SW:END:hook-priority -->
 
-<!-- SW:SECTION:header version="1.0.211" -->
+<!-- SW:SECTION:header version="1.0.212" -->
 **Framework**: SpecWeave | **Truth**: `spec.md` + `tasks.md`
 <!-- SW:END:header -->
 
@@ -123,7 +123,7 @@ claude plugin install sw@specweave --scope project  # Team-shared
 
 SpecWeave auto-installs: LSP → project scope, sw-* → user scope.
 
-<!-- SW:SECTION:start version="1.0.211" -->
+<!-- SW:SECTION:start version="1.0.212" -->
 ## Getting Started
 
 **Initial increment**: `0001-project-setup` (auto-created by `specweave init`)
@@ -133,7 +133,7 @@ SpecWeave auto-installs: LSP → project scope, sw-* → user scope.
 2. **Customize**: Edit spec.md and use for setup tasks
 <!-- SW:END:start -->
 
-<!-- SW:SECTION:autodetect version="1.0.211" -->
+<!-- SW:SECTION:autodetect version="1.0.212" -->
 ## Auto-Detection
 
 SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
@@ -143,7 +143,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 **Opt-out phrases**: "Just brainstorm first" | "Don't plan yet" | "Quick discussion" | "Let's explore ideas"
 <!-- SW:END:autodetect -->
 
-<!-- SW:SECTION:metarule version="1.0.211" -->
+<!-- SW:SECTION:metarule version="1.0.212" -->
 ## Workflow Orchestration
 
 ### 1. Plan Mode Default
@@ -170,7 +170,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 ```
 <!-- SW:END:metarule -->
 
-<!-- SW:SECTION:rules version="1.0.211" -->
+<!-- SW:SECTION:rules version="1.0.212" -->
 ## Rules
 
 1. **Files** → `.specweave/increments/####-name/` (see Structure section for details)
@@ -189,7 +189,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
    Use next available number. **NEVER create duplicate prefixes.**
 <!-- SW:END:rules -->
 
-<!-- SW:SECTION:workflow version="1.0.211" -->
+<!-- SW:SECTION:workflow version="1.0.212" -->
 ## Workflow
 
 `/sw:increment "X"` → `/sw:do` → `/sw:progress` → `/sw:done 0001`
@@ -235,7 +235,7 @@ project/
 **NEVER assume single-repo mode without scanning first!**
 <!-- SW:END:save-nested-repos -->
 
-<!-- SW:SECTION:reflect version="1.0.211" -->
+<!-- SW:SECTION:reflect version="1.0.212" -->
 ## Skill Memories
 
 SpecWeave learns from corrections. Learnings saved here automatically. Edit or delete as needed.
@@ -254,7 +254,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
 - **2026-02-02**: Use subagents liberally for codebase analysis - up to 10+ concurrent for large-scale exploration
 - **2026-02-02**: Prefer leaderboard-style reporting when analyzing usage patterns or identifying deletion candidates
 
-<!-- SW:SECTION:context version="1.0.211" -->
+<!-- SW:SECTION:context version="1.0.212" -->
 ## Context
 
 **Before implementing**: Check ADRs at `.specweave/docs/internal/architecture/adr/`
@@ -262,7 +262,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
 **Load context**: `/sw:context <topic>` loads relevant living docs into conversation
 <!-- SW:END:context -->
 
-<!-- SW:SECTION:structure version="1.0.211" -->
+<!-- SW:SECTION:structure version="1.0.212" -->
 ## Structure
 
 ```
@@ -277,7 +277,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
 **Everything else → subfolders**: `reports/` | `logs/` | `scripts/` | `backups/`
 <!-- SW:END:structure -->
 
-<!-- SW:SECTION:taskformat version="1.0.211" -->
+<!-- SW:SECTION:taskformat version="1.0.212" -->
 ## Task Format
 
 ```markdown
@@ -287,7 +287,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
 ```
 <!-- SW:END:taskformat -->
 
-<!-- SW:SECTION:secrets version="1.0.211" -->
+<!-- SW:SECTION:secrets version="1.0.212" -->
 ## Secrets Check
 
 **BEFORE CLI tools**: Check existing config first!
@@ -301,7 +301,7 @@ gh auth status
 **SECURITY**: NEVER use `grep TOKEN .env` without `-q` flag - it exposes credentials in terminal!
 <!-- SW:END:secrets -->
 
-<!-- SW:SECTION:syncing version="1.0.211" -->
+<!-- SW:SECTION:syncing version="1.0.212" -->
 ## External Sync (GitHub/JIRA/ADO)
 
 **Commands**: `/sw-github:sync {id}` (issues) | `/sw:sync-specs` (living docs only)
@@ -311,7 +311,7 @@ gh auth status
 **Config**: Set `sync.github.enabled: true` + `canUpdateExternalItems: true` in config.json
 <!-- SW:END:syncing -->
 
-<!-- SW:SECTION:testing version="1.0.211" -->
+<!-- SW:SECTION:testing version="1.0.212" -->
 ## Testing
 
 BDD in tasks.md | Unit >80% | `.test.ts` (Vitest)
@@ -323,7 +323,7 @@ vi.mock('./module', () => ({ func: mockFn }));
 ```
 <!-- SW:END:testing -->
 
-<!-- SW:SECTION:tdd version="1.0.211" -->
+<!-- SW:SECTION:tdd version="1.0.212" -->
 ## TDD Mode (Test-Driven Development)
 
 **When `testing.defaultTestMode: "TDD"` is configured**, follow RED-GREEN-REFACTOR discipline:
@@ -384,7 +384,7 @@ When TDD is enabled, tasks include phase markers:
 **Rule**: Complete dependencies BEFORE dependent tasks (RED before GREEN).
 <!-- SW:END:tdd -->
 
-<!-- SW:SECTION:api version="1.0.211" -->
+<!-- SW:SECTION:api version="1.0.212" -->
 ## API Development (OpenAPI-First)
 
 **For API projects only.** Commands: `/sw:api-docs --all` | `--openapi` | `--postman` | `--validate`
@@ -392,13 +392,13 @@ When TDD is enabled, tasks include phase markers:
 Enable in config: `{"apiDocs":{"enabled":true,"openApiPath":"openapi.yaml"}}`
 <!-- SW:END:api -->
 
-<!-- SW:SECTION:limits version="1.0.211" -->
+<!-- SW:SECTION:limits version="1.0.212" -->
 ## Limits
 
 **Max 1500 lines/file** — extract before adding
 <!-- SW:END:limits -->
 
-<!-- SW:SECTION:troubleshooting version="1.0.211" -->
+<!-- SW:SECTION:troubleshooting version="1.0.212" -->
 ## Troubleshooting
 
 | Issue | Fix |
@@ -411,7 +411,7 @@ Enable in config: `{"apiDocs":{"enabled":true,"openApiPath":"openapi.yaml"}}`
 | Session stuck | Kill + `rm -f .specweave/state/*.lock` + restart |
 <!-- SW:END:troubleshooting -->
 
-<!-- SW:SECTION:lazyloading version="1.0.211" -->
+<!-- SW:SECTION:lazyloading version="1.0.212" -->
 ## Plugin Auto-Loading
 
 Plugins load automatically based on project type and keywords. Manual install if needed:
@@ -425,7 +425,7 @@ export SPECWEAVE_DISABLE_AUTO_LOAD=1         # Disable auto-load
 **Token savings**: Core ~3-5K tokens vs all plugins ~60K+
 <!-- SW:END:lazyloading -->
 
-<!-- SW:SECTION:principles version="1.0.211" -->
+<!-- SW:SECTION:principles version="1.0.212" -->
 ## Principles
 
 ### SpecWeave Principles
@@ -441,7 +441,7 @@ export SPECWEAVE_DISABLE_AUTO_LOAD=1         # Disable auto-load
 - **Demand Elegance**: For non-trivial changes, pause and ask "is there a more elegant way?" - but skip this for simple, obvious fixes (don't over-engineer).
 <!-- SW:END:principles -->
 
-<!-- SW:SECTION:linking version="1.0.211" -->
+<!-- SW:SECTION:linking version="1.0.212" -->
 ## Bidirectional Linking
 
 Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
@@ -449,7 +449,7 @@ Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
 Task format: `**AC**: AC-US1-01, AC-US1-02` (CRITICAL for linking)
 <!-- SW:END:linking -->
 
-<!-- SW:SECTION:mcp version="1.0.211" -->
+<!-- SW:SECTION:mcp version="1.0.212" -->
 ## External Services
 
 **Priority**: CLI tools first (simpler) → MCP for complex integrations
@@ -471,7 +471,7 @@ claude mcp add --transport stdio postgres -- npx -y @modelcontextprotocol/server
 MCP supports lazy-loading (auto mode) - tools load on-demand when >10% context.
 <!-- SW:END:mcp -->
 
-<!-- SW:SECTION:auto version="1.0.211" -->
+<!-- SW:SECTION:auto version="1.0.212" -->
 ## Auto Mode
 
 **Commands**: `/sw:auto` (start) | `/sw:auto-status` (check) | `/sw:cancel-auto` (emergency only)
@@ -488,7 +488,7 @@ MCP supports lazy-loading (auto mode) - tools load on-demand when >10% context.
 **STOP & ASK** if: Spec conflicts | Task unnecessary | Requirement ambiguous
 <!-- SW:END:auto -->
 
-<!-- SW:SECTION:docs version="1.0.211" -->
+<!-- SW:SECTION:docs version="1.0.212" -->
 ## Docs
 
 [spec-weave.com](https://spec-weave.com)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "1.0.212",
+  "version": "1.0.213",
   "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",

package/plugins/specweave/.claude-plugin/plugin.json

@@ -18,5 +18,7 @@
     "pm",
     "architect",
     "living-docs"
-  ]
+  ],
+  "commands": "./commands/",
+  "skills": "./skills/"
 }

package/plugins/specweave/.specweave/logs/decisions.jsonl

@@ -0,0 +1,12 @@
+{"timestamp":"2026-02-03T05:48:20Z","hook":"stop-auto","decision":"approve","reason":"No increments directory","reasonCode":"no_increments_dir","durationMs":0,"context":{}}
+{"timestamp":"2026-02-03T05:48:20Z","hook":"stop-reflect","decision":"approve","reason":"specweave CLI not found","reasonCode":"error","durationMs":0,"context":{"transcriptLines":28,"reflectionEnabled":true,"learningsExtracted":0,"learningCategories":[],"exitReason":"error","triggerReason":"session_end"}}
+{"timestamp":"2026-02-03T05:49:50Z","hook":"stop-auto","decision":"approve","reason":"No increments directory","reasonCode":"no_increments_dir","durationMs":0,"context":{}}
+{"timestamp":"2026-02-03T05:49:50Z","hook":"stop-reflect","decision":"approve","reason":"Transcript too short (5 lines)","reasonCode":"transcript_too_short","durationMs":0,"context":{"transcriptLines":5,"reflectionEnabled":true,"learningsExtracted":0,"learningCategories":[],"exitReason":"transcript_too_short","triggerReason":"session_end"}}
+{"timestamp":"2026-02-03T05:50:08Z","hook":"stop-auto","decision":"approve","reason":"No increments directory","reasonCode":"no_increments_dir","durationMs":0,"context":{}}
+{"timestamp":"2026-02-03T05:50:08Z","hook":"stop-reflect","decision":"approve","reason":"Transcript too short (8 lines)","reasonCode":"transcript_too_short","durationMs":0,"context":{"transcriptLines":8,"reflectionEnabled":true,"learningsExtracted":0,"learningCategories":[],"exitReason":"transcript_too_short","triggerReason":"session_end"}}
+{"timestamp":"2026-02-03T05:50:24Z","hook":"stop-auto","decision":"approve","reason":"No increments directory","reasonCode":"no_increments_dir","durationMs":0,"context":{}}
+{"timestamp":"2026-02-03T05:50:24Z","hook":"stop-reflect","decision":"approve","reason":"specweave CLI not found","reasonCode":"error","durationMs":0,"context":{"transcriptLines":13,"reflectionEnabled":true,"learningsExtracted":0,"learningCategories":[],"exitReason":"error","triggerReason":"session_end"}}
+{"timestamp":"2026-02-03T05:50:46Z","hook":"stop-auto","decision":"approve","reason":"No increments directory","reasonCode":"no_increments_dir","durationMs":0,"context":{}}
+{"timestamp":"2026-02-03T05:50:46Z","hook":"stop-reflect","decision":"approve","reason":"specweave CLI not found","reasonCode":"error","durationMs":0,"context":{"transcriptLines":17,"reflectionEnabled":true,"learningsExtracted":0,"learningCategories":[],"exitReason":"error","triggerReason":"session_end"}}
+{"timestamp":"2026-02-03T05:52:57Z","hook":"stop-auto","decision":"approve","reason":"No increments directory","reasonCode":"no_increments_dir","durationMs":0,"context":{}}
+{"timestamp":"2026-02-03T05:52:57Z","hook":"stop-reflect","decision":"approve","reason":"specweave CLI not found","reasonCode":"error","durationMs":0,"context":{"transcriptLines":399,"reflectionEnabled":true,"learningsExtracted":0,"learningCategories":[],"exitReason":"error","triggerReason":"session_end"}}

package/plugins/specweave/.specweave/logs/reflect/reflect.log

@@ -0,0 +1,8 @@
+[2026-02-03T05:48:20Z] [info] Starting reflection (28 lines)
+[2026-02-03T05:48:20Z] [warn] specweave CLI not found
+[2026-02-03T05:50:24Z] [info] Starting reflection (13 lines)
+[2026-02-03T05:50:24Z] [warn] specweave CLI not found
+[2026-02-03T05:50:46Z] [info] Starting reflection (17 lines)
+[2026-02-03T05:50:46Z] [warn] specweave CLI not found
+[2026-02-03T05:52:57Z] [info] Starting reflection (399 lines)
+[2026-02-03T05:52:57Z] [warn] specweave CLI not found

package/plugins/specweave/.specweave/logs/stop-auto.log

@@ -0,0 +1,6 @@
+[2026-02-03T05:48:20Z] APPROVE: No increments directory
+[2026-02-03T05:49:50Z] APPROVE: No increments directory
+[2026-02-03T05:50:08Z] APPROVE: No increments directory
+[2026-02-03T05:50:24Z] APPROVE: No increments directory
+[2026-02-03T05:50:46Z] APPROVE: No increments directory
+[2026-02-03T05:52:57Z] APPROVE: No increments directory

package/plugins/specweave/.specweave/logs/stop-sync.log

@@ -0,0 +1,10 @@
+[2026-02-03T05:49:50Z] Stop-sync started
+[2026-02-03T05:49:50Z] No pending events to sync
+[2026-02-03T05:50:08Z] Stop-sync started
+[2026-02-03T05:50:08Z] No pending events to sync
+[2026-02-03T05:50:24Z] Stop-sync started
+[2026-02-03T05:50:24Z] No pending events to sync
+[2026-02-03T05:50:46Z] Stop-sync started
+[2026-02-03T05:50:46Z] No pending events to sync
+[2026-02-03T05:52:57Z] Stop-sync started
+[2026-02-03T05:52:57Z] No pending events to sync

package/plugins/specweave/.specweave/state/dashboard.json

@@ -0,0 +1,43 @@
+{
+  "version": 1,
+  "updatedAt": "2026-02-03T05:49:24Z",
+  "increments": {},
+  "summary": {
+    "total": 0,
+    "active": 0,
+    "paused": 0,
+    "backlog": 0,
+    "planning": 0,
+    "ready_for_review": 0,
+    "completed": 0,
+    "abandoned": 0,
+    "archived": 0,
+    "byType": {
+      "feature": 0,
+      "hotfix": 0,
+      "bug": 0,
+      "refactor": 0,
+      "experiment": 0,
+      "change-request": 0
+    },
+    "byPriority": {
+      "P0": 0,
+      "P1": 0,
+      "P2": 0,
+      "P3": 0
+    }
+  },
+  "jobs": {
+    "running": [],
+    "paused": [],
+    "failed": [],
+    "completedCount": 0
+  },
+  "costs": {
+    "totalTokens": 0,
+    "totalCost": 0,
+    "totalSavings": 0,
+    "byIncrement": {}
+  },
+  "mtimes": {}
+}

package/plugins/specweave/COMMANDS.md

@@ -1,194 +0,0 @@
-# SpecWeave Commands
-
-All SpecWeave commands are namespaced for brownfield safety and follow a consistent naming pattern.
-
-## ⚠️ CRITICAL: No Shortcuts Allowed
-
-**IMPORTANT**: SpecWeave commands MUST be invoked with the `/sw:*` namespace prefix.
-
-**Why?** Shortcuts like `/inc`, `/do`, `/pause`, `/resume` conflict with Claude Code's native commands and break functionality.
-
-**Always use**: `/sw:increment`, `/sw:do`, `/sw:resume`, etc.
-
-## Command Naming Convention
-
-**All command files**: `{command-name}.md`
-**YAML name field**: `{command-name}`
-**Invocation**: `/sw:{command-name}` (namespace prefix required)
-
-### Example:
-- **File**: `increment.md`
-- **YAML**:
-  ```yaml
-  ---
-  name: increment
-  description: Plan new Product Increment
-  ---
-  ```
-- **Usage**: `/sw:increment` (ONLY form, no shortcuts)
-
-## All Available Commands (55 total)
-
-### Core Lifecycle (9 commands)
-1. `increment.md` - Plan new Product Increment → `/sw:increment`
-2. `plan.md` - Generate plan.md and tasks.md using Architect Agent → `/sw:plan`
-3. `do.md` - Execute increment tasks → `/sw:do`
-4. `done.md` - Close increment with PM validation → `/sw:done`
-5. `next.md` - Smart workflow transition (auto-close + suggest next) → `/sw:next`
-6. `progress.md` - Show increment progress → `/sw:progress`
-7. `validate.md` - Validate increment quality → `/sw:validate`
-8. `workflow.md` - Smart workflow navigator → `/sw:workflow`
-9. `context.md` - Load living docs context for LLM → `/sw:context`
-
-### Status & Reporting (5 commands)
-10. `status.md` - Show all increments overview → `/sw:status`
-11. `update-scope.md` - Update living completion report → `/sw:update-scope`
-12. `qa.md` - Quality assessment with risk scoring → `/sw:qa`
-13. `judge-llm.md` - Ultrathink LLM-as-Judge validation → `/sw:judge-llm`
-14. `jobs.md` - Show background jobs and increment status → `/sw:jobs`
-
-### State Management (5 commands)
-15. `pause.md` - Pause active increment → `/sw:pause`
-16. `resume.md` - Resume paused/backlog increment → `/sw:resume`
-17. `abandon.md` - Abandon incomplete increment → `/sw:abandon`
-18. `backlog.md` - Move increment to backlog → `/sw:backlog`
-19. `reopen.md` - Reopen completed increment → `/sw:reopen`
-
-### Testing & Quality (3 commands)
-20. `check-tests.md` - Validate test coverage → `/sw:check-tests`
-21. `sync-tasks.md` - Sync tasks with external tools → `/sw:sync-tasks`
-22. `check-hooks.md` - Health check for hooks → `/sw:check-hooks`
-
-### TDD Workflow (4 commands)
-23. `tdd-red.md` - Write failing tests (TDD red phase) → `/sw:tdd-red`
-24. `tdd-green.md` - Make tests pass (TDD green phase) → `/sw:tdd-green`
-25. `tdd-refactor.md` - Refactor with test safety net → `/sw:tdd-refactor`
-26. `tdd-cycle.md` - Full TDD red-green-refactor cycle → `/sw:tdd-cycle`
-
-### Archiving & Cleanup (6 commands)
-27. `archive.md` - Archive completed increments → `/sw:archive`
-28. `restore.md` - Restore archived increments → `/sw:restore`
-29. `archive-features.md` - Archive features/epics → `/sw:archive-features`
-30. `restore-feature.md` - Restore features/epics → `/sw:restore-feature`
-31. `fix-duplicates.md` - Resolve duplicate increments → `/sw:fix-duplicates`
-32. `revert-wip-limit.md` - Revert WIP limit after adjustment → `/sw:revert-wip-limit`
-
-### Sync & Monitoring (10 commands)
-33. `sync-docs.md` - Strategic documentation sync → `/sw:sync-docs`
-34. `sync-specs.md` - Sync specs to living docs → `/sw:sync-specs`
-35. `sync-progress.md` - Full progress sync to external tools → `/sw:sync-progress`
-36. `sync-acs.md` - Sync AC checkbox status → `/sw:sync-acs`
-37. `sync-status.md` - Fix metadata/spec status desyncs → `/sw:sync-status`
-38. `sync-monitor.md` - Sync orchestration dashboard → `/sw:sync-monitor`
-39. `sync-logs.md` - Query sync audit logs → `/sw:sync-logs`
-40. `sync-diagnostics.md` - Sync circuit breaker diagnostics → `/sw:sync-diagnostics`
-41. `update-status.md` - Force-update status line cache → `/sw:update-status`
-42. `notifications.md` - View sync notifications → `/sw:notifications`
-
-### Brownfield & Documentation (7 commands)
-43. `discrepancies.md` - View code-to-spec discrepancies → `/sw:discrepancies`
-44. `discrepancy-to-increment.md` - Convert discrepancy to increment → `/sw:discrepancy-to-increment`
-45. `import-docs.md` - Import brownfield documentation → `/sw:import-docs`
-46. `import-external.md` - Import external work items → `/sw:import-external`
-47. `living-docs.md` - Launch Living Docs Builder → `/sw:living-docs`
-48. `organize-docs.md` - Smart documentation organization → `/sw:organize-docs`
-49. `validate-features.md` - Validate feature folder consistency → `/sw:validate-features`
-
-### External Tools (2 commands)
-50. `external.md` - View external items dashboard → `/sw:external`
-51. `embed-acs.md` - Embed ACs from living docs into spec.md → `/sw:embed-acs`
-
-### Utilities (4 commands)
-52. `translate.md` - Batch translation → `/sw:translate`
-53. `save.md` - Smart git save across repos → `/sw:save`
-54. `migrate-config.md` - Migrate config format → `/sw:migrate-config`
-55. `sw.md` - Master command reference → `/sw:sw`
-
-**Total**: 55 commands in the core SpecWeave plugin
-
-## Command Categories
-
-**By Frequency of Use**:
-- **ESSENTIAL**: increment, do, done, next, progress, validate, sync-docs, save, context
-- **IMPORTANT**: status, qa, check-tests, update-scope, workflow, sync-specs
-- **STATE MANAGEMENT**: pause, resume, abandon, backlog, reopen
-- **ARCHIVING**: archive, restore, archive-features, restore-feature, fix-duplicates
-- **SYNC & MONITORING**: sync-monitor, sync-logs, sync-progress, sync-acs, sync-status, notifications
-- **BROWNFIELD**: discrepancies, discrepancy-to-increment, import-docs, import-external, living-docs
-- **TDD**: tdd-red, tdd-green, tdd-refactor, tdd-cycle
-- **ADVANCED**: judge-llm, check-hooks, embed-acs, validate-features, organize-docs
-
-## Plugin Commands
-
-SpecWeave plugins provide additional namespaced commands:
-
-| Plugin | Prefix | Commands |
-|--------|--------|----------|
-| **GitHub** | `/sw-github:*` | sync, create, push, pull, close, status, reconcile, clone |
-| **JIRA** | `/sw-jira:*` | sync, create, push, pull, close, status, reconcile |
-| **Azure DevOps** | `/sw-ado:*` | sync, create, push, pull, close, status, reconcile |
-| **Release** | `/sw-release:*` | init, align, rc, platform, npm |
-| **Docs** | `/sw-docs:*` | init, generate, build, view, validate, organize |
-| **Frontend** | `/sw-frontend:*` | component-generate, design-system-init, frontend-scaffold |
-| **Backend** | `/sw-backend:*` | api-scaffold, crud-generate, migration-generate |
-| **Kubernetes** | `/sw-k8s:*` | cluster-setup, deployment-generate, helm-scaffold |
-| **Testing** | `/sw-testing:*` | e2e-setup, test-coverage, test-generate, test-init |
-| **Infrastructure** | `/sw-infra:*` | monitor-setup, slo-implement |
-| **Kafka** | `/sw-kafka:*` | deploy, dev-env, monitor-setup, mcp-configure |
-| **Mobile** | `/sw-mobile:*` | app-scaffold, build-config, screen-generate |
-| **ML** | `/sw-ml:*` | deploy, evaluate, explain, pipeline |
-| **Payments** | `/sw-payments:*` | subscription-manage, webhook-setup |
-| **Diagrams** | `/sw-diagrams:*` | diagrams-generate |
-
-## Removed/Deprecated Commands
-
-**Duplicates removed**:
-- ❌ `inc.md` → Use `/sw:increment`
-
-**Deprecated commands**:
-- ❌ `validate-coverage.md` → Use `/sw:check-tests`
-- ❌ `specweave-validate-coverage.md` → Use `/sw:check-tests`
-- ❌ `list-increments.md` → Use `/sw:status`
-
-**Removed**:
-- ❌ `costs.md` - Cost tracking infrastructure not wired up
-
-## Brownfield Safety
-
-All commands are namespaced to prevent collisions with existing project commands:
-- ✅ **Namespace form**: `/sw:increment` (ONLY way, always safe)
-- ❌ **No shortcuts**: Do NOT use `/inc`, `/do`, `/pause`, `/resume` etc.
-
-## Quick Reference
-
-```bash
-# Core workflow
-/sw:increment "feature"    # Plan new increment
-/sw:do                     # Execute tasks
-/sw:progress               # Check status
-/sw:qa 0007                # Quality check
-/sw:done 0007              # Close increment
-/sw:save                   # Commit & push changes
-
-# Sync to external tools
-/sw-github:sync 0007       # Sync to GitHub
-/sw-jira:sync 0007         # Sync to JIRA
-/sw-ado:sync 0007          # Sync to Azure DevOps
-
-# State management
-/sw:pause 0007             # Pause increment
-/sw:resume 0007            # Resume increment
-/sw:backlog 0007           # Move to backlog
-/sw:abandon 0007           # Abandon increment
-
-# Documentation
-/sw:sync-docs update       # Sync to living docs
-/sw:living-docs            # Launch docs builder
-/sw:import-docs            # Import brownfield docs
-```
-
-## See Also
-
-- **User Documentation**: https://spec-weave.com/docs/commands
-- **CLAUDE.md**: Project contributor guide with complete command reference
-- **Plugin Marketplace**: `.claude-plugin/marketplace.json`

package/plugins/specweave/commands/sw.md

@@ -1,127 +0,0 @@
----
-name: sw
-description: SpecWeave command reference and help. Shows available commands. DO NOT use routing syntax like '/specweave do' - always use full namespaced commands like '/sw:do' instead.
----
-
-# SpecWeave Command Reference
-
-**⚠️ IMPORTANT: This is a REFERENCE ONLY, not a router!**
-
-**DO NOT use**: `/specweave do`, `/specweave inc`, etc.
-**ALWAYS use**: `/sw:do`, `/sw:increment`, etc.
-
-Claude Code does not support command routing. Each command must be invoked directly by its full namespaced name.
-
-**Namespace Protection**: All SpecWeave commands are prefixed with `specweave:` to avoid collisions with existing project commands.
-
----
-
-## Available Commands
-
-**All commands use the `specweave:` prefix** (note the colon!)
-
-### Increment Lifecycle
-
-| Command | Description | Example |
-|---------|-------------|---------|
-| `/sw:increment` | Create new increment (PM-led) | `/sw:increment "User auth"` |
-| `/sw:do` | Execute tasks (auto-resumes) | `/sw:do` or `/sw:do 0031` |
-| `/sw:next` | Smart transition (close + suggest) | `/sw:next` |
-| `/sw:done` | Manual closure with PM validation | `/sw:done 0031` |
-| `/sw:progress` | Check status and next action | `/sw:progress` |
-| `/sw:validate` | Validate increment quality | `/sw:validate 0031` |
-
-### Documentation & Sync
-
-| Command | Description | Example |
-|---------|-------------|---------|
-| `/sw:sync-docs` | Sync living docs | `/sw:sync-docs update` |
-| `/sw:sync-tasks` | Sync tasks with status | `/sw:sync-tasks` |
-
-### GitHub Plugin
-
-| Command | Description | Example |
-|---------|-------------|---------|
-| `/sw-github:create-issue` | Create GitHub issue | `/sw-github:create-issue 0031` |
-| `/sw-github:sync` | Two-way sync | `/sw-github:sync 0031` |
-| `/sw-github:sync-tasks` | Sync tasks as sub-issues | `/sw-github:sync-tasks 0031` |
-| `/sw-github:close-issue` | Close GitHub issue | `/sw-github:close-issue 0031` |
-| `/sw-github:status` | Show sync status | `/sw-github:status` |
-
----
-
-## ⚠️ NO ROUTING SUPPORT
-
-**Claude Code does not implement command routing!**
-
-This file is a **reference guide only**. You cannot do:
-- ❌ `/specweave do` (doesn't work, no routing!)
-- ❌ `/specweave inc "feature"` (doesn't work!)
-- ❌ `/specweave next` (doesn't work!)
-
-**Instead, always use full namespaced commands:**
-- ✅ `/sw:do`
-- ✅ `/sw:increment "feature"`
-- ✅ `/sw:next`
-
-**Why This Matters:**
-Calling both `/specweave` and `/sw:do` causes **duplicate invocations**! Always use the namespaced version with the colon.
-
----
-
-## Usage Examples
-
-### ✅ CORRECT Usage
-
-```bash
-# Create increment
-/sw:increment "User authentication"
-
-# Execute tasks
-/sw:do
-
-# Check progress
-/sw:progress
-
-# Complete increment
-/sw:done 0031
-```
-
-### ❌ INCORRECT Usage (Causes Duplicates!)
-
-```bash
-# DO NOT use routing syntax:
-/specweave do           # ❌ Won't work, no routing!
-/specweave inc "feat"   # ❌ Won't work!
-/specweave next         # ❌ Won't work!
-
-# ALWAYS use namespaced commands:
-/sw:do           # ✅ Correct!
-/sw:increment "feat"  # ✅ Correct!
-/sw:next         # ✅ Correct!
-```
-
----
-
-## Why Namespacing?
-
-**Namespace Protection**: All SpecWeave commands use `specweave:` prefix to avoid collisions with existing project commands in brownfield setups.
-
-**Benefits:**
-1. **No collisions** - SpecWeave commands never overwrite user commands
-2. **Clear ownership** - `specweave:` prefix shows it's a framework command
-3. **Easy identification** - Clear indication of SpecWeave actions
-4. **Brownfield safe** - Can install in any existing project
-5. **Uninstall clean** - Remove `specweave:*` commands, user's commands intact
-
----
-
-## Related Documentation
-
-- [Getting Started](https://spec-weave.com/docs/getting-started)
-- [Command Reference](https://spec-weave.com/docs/commands)
-- [Workflow Guide](https://spec-weave.com/docs/workflow)
-
----
-
-**⚠️ Remember**: Always use `/sw:` with a colon, never `/specweave ` with a space!