specweave 1.0.593 → 2.0.3

package/plugins/specweave/marketplace.json

@@ -1,114 +1,122 @@
 {
   "$schema": "https://spec-weave.com/schemas/skill-marketplace.v1.json",
   "plugin": "sw",
-  "version": "1.1.0",
-  "description": "Skill-level marketplace catalog for the specweave plugin. Lists deprecation state, replacement pointers, and alias routing for each skill.",
+  "description": "Skill catalog for the specweave plugin. The plugin version is tracked in .claude-plugin/plugin.json (stamped from package.json); this file only lists what ships.",
   "skills": [
     {
-      "name": "sw:github-sync",
-      "path": "skills/github-sync/SKILL.md",
-      "deprecated": true,
-      "deprecatedIn": "1.1.0",
-      "removalScheduledIn": "1.3.0",
-      "replacement": "sw-github:sync-spec",
-      "migrationWarning": "sw:github-sync is deprecated. Use sw-github:sync-spec for push/pull operations. Scheduled for removal in v1.3.0."
+      "name": "sw:increment",
+      "path": "skills/increment/SKILL.md",
+      "description": "Plan a unit of work: spec.md with Problem, Scope, numbered ACs and an Approach, plus tasks.md definitions.",
+      "deprecated": false
     },
     {
-      "name": "sw:jira-sync",
-      "path": "skills/jira-sync/SKILL.md",
-      "deprecated": true,
-      "deprecatedIn": "1.1.0",
-      "removalScheduledIn": "1.3.0",
-      "replacement": "sw-jira:push / sw-jira:pull",
-      "migrationWarning": "sw:jira-sync is deprecated. Use sw-jira:push (content) or sw-jira:pull (status) instead. Scheduled for removal in v1.3.0."
+      "name": "sw:do",
+      "path": "skills/do/SKILL.md",
+      "description": "Work the increment task by task through the ledger: task next, claim, implement, commit, task done with evidence.",
+      "deprecated": false
     },
     {
-      "name": "sw:ado-sync",
-      "path": "skills/ado-sync/SKILL.md",
-      "deprecated": true,
-      "deprecatedIn": "1.1.0",
-      "removalScheduledIn": "1.3.0",
-      "replacement": "sw-ado:push / sw-ado:pull",
-      "migrationWarning": "sw:ado-sync is deprecated. Use sw-ado:push (content) or sw-ado:pull (status) instead. Scheduled for removal in v1.3.0."
+      "name": "sw:done",
+      "path": "skills/done/SKILL.md",
+      "description": "Close an increment: ledger check, specweave verify, optional review, specweave complete.",
+      "deprecated": false
     },
     {
-      "name": "sw:tdd-red",
-      "path": "skills/tdd-red/SKILL.md",
-      "deprecated": true,
-      "deprecatedIn": "1.1.0",
-      "removalScheduledIn": "1.3.0",
-      "replacement": "sw:tdd-cycle --phase red",
-      "alias": {
-        "from": "/sw:tdd-red",
-        "to": "/sw:tdd-cycle --phase red",
-        "migrationWarning": "sw:tdd-red is deprecated. Use sw:tdd-cycle --phase red instead."
-      },
-      "migrationWarning": "sw:tdd-red is deprecated. Use sw:tdd-cycle --phase red instead. Scheduled for removal in v1.3.0."
+      "name": "sw:review",
+      "path": "skills/review/SKILL.md",
+      "description": "Adversarial fresh-context review; every finding cites path:line and is re-verified. Replaces grill, code-reviewer and judge-llm.",
+      "deprecated": false
     },
     {
-      "name": "sw:tdd-green",
-      "path": "skills/tdd-green/SKILL.md",
-      "deprecated": true,
-      "deprecatedIn": "1.1.0",
-      "removalScheduledIn": "1.3.0",
-      "replacement": "sw:tdd-cycle --phase green",
-      "alias": {
-        "from": "/sw:tdd-green",
-        "to": "/sw:tdd-cycle --phase green",
-        "migrationWarning": "sw:tdd-green is deprecated. Use sw:tdd-cycle --phase green instead."
-      },
-      "migrationWarning": "sw:tdd-green is deprecated. Use sw:tdd-cycle --phase green instead. Scheduled for removal in v1.3.0."
+      "name": "sw:team",
+      "path": "skills/team/SKILL.md",
+      "description": "Several agents on one increment: a worktree each, claims through the ledger, one closure. Replaces team-lead and team-merge.",
+      "deprecated": false
     },
     {
-      "name": "sw:tdd-refactor",
-      "path": "skills/tdd-refactor/SKILL.md",
-      "deprecated": true,
-      "deprecatedIn": "1.1.0",
-      "removalScheduledIn": "1.3.0",
-      "replacement": "sw:tdd-cycle --phase refactor",
-      "alias": {
-        "from": "/sw:tdd-refactor",
-        "to": "/sw:tdd-cycle --phase refactor",
-        "migrationWarning": "sw:tdd-refactor is deprecated. Use sw:tdd-cycle --phase refactor instead."
-      },
-      "migrationWarning": "sw:tdd-refactor is deprecated. Use sw:tdd-cycle --phase refactor instead. Scheduled for removal in v1.3.0."
+      "name": "sw:handoff",
+      "path": "skills/handoff/SKILL.md",
+      "description": "Portable, secret-scrubbed handoff doc so the work continues in any AI tool or on any machine.",
+      "deprecated": false
     },
     {
-      "name": "sw:github-issue-standard",
-      "path": "skills/github-issue-standard/SKILL.md",
-      "deprecated": true,
-      "deprecatedIn": "1.1.0",
-      "removalScheduledIn": "1.3.0",
-      "replacement": ".specweave/docs/internal/specs/github-issue-standard.md",
-      "migrationWarning": "sw:github-issue-standard was a documentation standard, not an executable skill. Content moved to .specweave/docs/internal/specs/github-issue-standard.md. For GitHub sync, use sw-github:push. Scheduled for removal in v1.3.0."
+      "name": "sw:sync",
+      "path": "skills/sync/SKILL.md",
+      "description": "One sync surface for GitHub, Jira and Azure DevOps: push, pull, status, setup. Replaces the per-provider sync, mapper, validator and import skills.",
+      "deprecated": false
     },
     {
-      "name": "sw/github-multi-project",
-      "path": "skills/github-multi-project/SKILL.md",
-      "deprecated": true,
-      "deprecatedIn": "1.2.0",
-      "removalScheduledIn": "1.3.0",
-      "replacement": "sw/multi-project --tool github",
-      "alias": {
-        "from": "sw/github-multi-project",
-        "to": "sw/multi-project --tool github",
-        "migrationWarning": "sw/github-multi-project is deprecated. Use sw/multi-project --tool github instead."
-      },
-      "migrationWarning": "sw/github-multi-project is deprecated. Use sw/multi-project --tool github instead. Scheduled for removal in v1.3.0."
+      "name": "sw:auto",
+      "path": "skills/auto/SKILL.md",
+      "description": "Unattended execution driven by the Stop hook until every task is done.",
+      "deprecated": false
     },
     {
-      "name": "sw/ado-multi-project",
-      "path": "skills/ado-multi-project/SKILL.md",
-      "deprecated": true,
-      "deprecatedIn": "1.2.0",
-      "removalScheduledIn": "1.3.0",
-      "replacement": "sw/multi-project --tool ado",
-      "alias": {
-        "from": "sw/ado-multi-project",
-        "to": "sw/multi-project --tool ado",
-        "migrationWarning": "sw/ado-multi-project is deprecated. Use sw/multi-project --tool ado instead."
-      },
-      "migrationWarning": "sw/ado-multi-project is deprecated. Use sw/multi-project --tool ado instead. Scheduled for removal in v1.3.0."
+      "name": "sw:brainstorm",
+      "path": "skills/brainstorm/SKILL.md",
+      "description": "Expand the option space before committing to one, ending in a pick handed to sw:increment.",
+      "deprecated": false
+    },
+    {
+      "name": "sw:qa",
+      "path": "skills/qa/SKILL.md",
+      "description": "Risk-scored quality assessment via specweave qa: verdict, blockers, optional export to tasks.md.",
+      "deprecated": false
+    }
+  ],
+  "optionalSkills": {
+    "note": "Not shipped in the plugin. Install with: npx vskill install anton-abyzov/specweave/skills-optional/<name>",
+    "names": [
+      "tdd-cycle",
+      "e2e",
+      "debug",
+      "diagrams",
+      "release-expert"
+    ]
+  },
+  "removedIn2_0": {
+    "note": "Removed in 2.0. Use the replacement; there is no alias routing.",
+    "map": {
+      "sw:grill": "sw:review",
+      "sw:code-reviewer": "sw:review",
+      "sw:judge-llm": "sw:review",
+      "sw:pr-review": "sw:review",
+      "sw:team-lead": "sw:team",
+      "sw:team-merge": "sw:team",
+      "sw:team-build": "sw:team",
+      "sw:plan": "sw:increment",
+      "sw:pm": "sw:increment",
+      "sw:architect": "sw:increment",
+      "sw:validate": "sw:qa",
+      "sw:close-all": "specweave complete --all",
+      "sw:progress": "specweave status",
+      "sw:analytics": "specweave analytics",
+      "sw:help": "specweave help",
+      "sw:get": "specweave get",
+      "sw:umbrella": "specweave init --umbrella",
+      "sw:npm": "skills-optional/release-expert",
+      "sw:pr": "specweave link-pr",
+      "sw:sync-docs": "specweave docs sync",
+      "sw:living-docs": "specweave sync-living-docs",
+      "sw:progress-sync": "sw:sync",
+      "sw:import": "sw:sync",
+      "sw:github-sync": "sw:sync",
+      "sw:jira-sync": "sw:sync",
+      "sw:ado-sync": "sw:sync",
+      "sw:multi-project": "sw:sync",
+      "sw:tdd-red": "skills-optional/tdd-cycle",
+      "sw:tdd-green": "skills-optional/tdd-cycle",
+      "sw:tdd-refactor": "skills-optional/tdd-cycle",
+      "sw:tdd-cycle": "skills-optional/tdd-cycle",
+      "sw:e2e": "skills-optional/e2e",
+      "sw:debug": "skills-optional/debug",
+      "sw:diagrams": "skills-optional/diagrams",
+      "sw:release-expert": "skills-optional/release-expert",
+      "sw:image": "external media skills",
+      "sw:video": "external media skills",
+      "sw:remotion": "external media skills",
+      "sw:skill-gen": "vskill skill-creator",
+      "sw:skill-refine": "vskill skill-creator"
     }
-  ]
+  }
 }

package/plugins/specweave/reference/ado/ado-specweave-mapping.md

@@ -2,7 +2,7 @@
 
 **Purpose**: Quick reference for mapping Azure DevOps work items to SpecWeave architecture
 
-**Source of Truth**: [.specweave/docs/internal/delivery/guides/tool-concept-mapping.md](../../../.specweave/docs/internal/delivery/guides/tool-concept-mapping.md)
+**Source of Truth**: this file (the 1.x `tool-concept-mapping.md` guide was removed in 2.0)
 
 **Last Synced**: 2025-11-04
 
@@ -432,7 +432,7 @@ SpecWeave: .specweave/docs/internal/architecture/frontend-auth/
 
 **Start**: ADO Epic #12345 "Payment Integration"
 
-**Trace** (`specweave trace --ado 12345`):
+**Trace** (follow `externalLinks` in each increment's metadata.json; `specweave sync status --json` lists them):
 ```
 ADO Epic: #12345 "Payment Integration"
   ↓
@@ -460,7 +460,7 @@ Runbook: .specweave/docs/internal/operations/runbook-payment-service.md
 
 **Start**: Code file `src/services/payment/stripe.ts`
 
-**Trace** (`specweave trace --file src/services/payment/stripe.ts`):
+**Trace** (from `src/services/payment/stripe.ts` back through the increment that owns it):
 ```
 File: src/services/payment/stripe.ts
   ↓
@@ -541,9 +541,8 @@ AUTH=$(echo -n ":$AZURE_DEVOPS_PAT" | base64)
 
 ## Related Documentation
 
-- **Full Mapping Guide**: [.specweave/docs/internal/delivery/guides/tool-concept-mapping.md](../../../.specweave/docs/internal/delivery/guides/tool-concept-mapping.md)
-- **ADO Sync Skill**: [../skills/ado-sync/SKILL.md](../skills/ado-sync/SKILL.md)
-- **ADO Manager Agent**: [../agents/ado-manager/AGENT.md](../agents/ado-manager/AGENT.md)
+- **Sync Skill**: [../../skills/sync/SKILL.md](../../skills/sync/SKILL.md)
+- **CLI**: `specweave sync push | pull | status | setup`
 
 ---
 

package/plugins/specweave/reference/github/github-specweave-mapping.md

@@ -2,7 +2,7 @@
 
 **Purpose**: Quick reference for mapping GitHub concepts to SpecWeave architecture
 
-**Source of Truth**: [.specweave/docs/internal/delivery/guides/tool-concept-mapping.md](../../../.specweave/docs/internal/delivery/guides/tool-concept-mapping.md)
+**Source of Truth**: this file (the 1.x `tool-concept-mapping.md` guide was removed in 2.0)
 
 **Last Synced**: 2025-11-04
 
@@ -366,9 +366,8 @@ Milestone: v1.0 (release plan)
 
 ## Related Documentation
 
-- **Full Mapping Guide**: [.specweave/docs/internal/delivery/guides/tool-concept-mapping.md](../../../.specweave/docs/internal/delivery/guides/tool-concept-mapping.md)
-- **GitHub Sync Skill**: [../skills/github-sync/SKILL.md](../skills/github-sync/SKILL.md)
-- **GitHub Manager Agent**: [../agents/github-manager/AGENT.md](../agents/github-manager/AGENT.md)
+- **Sync Skill**: [../../skills/sync/SKILL.md](../../skills/sync/SKILL.md)
+- **CLI**: `specweave sync push | pull | status | setup`
 
 ---
 

package/plugins/specweave/reference/jira/jira-specweave-mapping.md

@@ -2,7 +2,7 @@
 
 **Purpose**: Quick reference for mapping Jira concepts to SpecWeave architecture
 
-**Source of Truth**: [.specweave/docs/internal/delivery/guides/tool-concept-mapping.md](../../../.specweave/docs/internal/delivery/guides/tool-concept-mapping.md)
+**Source of Truth**: this file (the 1.x `tool-concept-mapping.md` guide was removed in 2.0)
 
 **Last Synced**: 2025-11-04
 
@@ -409,7 +409,7 @@ SpecWeave: .specweave/docs/internal/architecture/frontend-auth/
 
 **Start**: Jira Epic PROJ-123 "User Authentication"
 
-**Trace** (`specweave trace --jira PROJ-123`):
+**Trace** (follow `externalLinks` in each increment's metadata.json; `specweave sync status --json` lists them):
 ```
 Jira Epic: PROJ-123 "User Authentication"
   ↓
@@ -439,7 +439,7 @@ Runbook: .specweave/docs/internal/operations/runbook-auth-service.md
 
 **Start**: Code file `src/services/auth/oauth.ts`
 
-**Trace** (`specweave trace --file src/services/auth/oauth.ts`):
+**Trace** (from `src/services/auth/oauth.ts` back through the increment that owns it):
 ```
 File: src/services/auth/oauth.ts
   ↓
@@ -503,8 +503,8 @@ AUTH=$(echo -n "$JIRA_EMAIL:$JIRA_API_TOKEN" | base64)
 
 ## Related Documentation
 
-- **Full Mapping Guide**: [.specweave/docs/internal/delivery/guides/tool-concept-mapping.md](../../../.specweave/docs/internal/delivery/guides/tool-concept-mapping.md)
-- **Jira Sync Skill**: [../skills/jira-sync/SKILL.md](../skills/jira-sync/SKILL.md)
+- **Sync Skill**: [../../skills/sync/SKILL.md](../../skills/sync/SKILL.md)
+- **CLI**: `specweave sync push | pull | status | setup`
 
 ---
 

package/plugins/specweave/scripts/README.md

@@ -1,183 +1,38 @@
-# SpecWeave Instant Scripts
+# SpecWeave Plugin Scripts
 
-**Blazingly fast status commands that bypass LLM processing.**
+Small, zero-reasoning helpers that read SpecWeave state and print it. They exist
+so status-style commands do not have to round-trip through the model.
 
-These scripts provide instant (<100ms) output for status queries that don't require AI reasoning.
-
-## Why These Exist
-
-Status commands (`sw:status`, `sw:progress`, `sw:jobs`) were taking 3+ minutes because they expanded as prompts requiring LLM processing. These commands need NO reasoning - they just read JSON and format output.
-
-**Performance comparison:**
-
-| Command | Before | After |
-|---------|--------|-------|
-| `sw:status` | 3+ min | <100ms |
-| `sw:progress` | 2+ min | <100ms |
-| `sw:jobs` | 3+ min | <100ms |
+All user-facing helpers are **Node scripts** — they run identically on macOS,
+Linux and Windows (`cmd`, PowerShell, Git Bash). The 2.0 cleanup removed the
+bash variants (`read-status.sh`, `read-progress.sh`, `read-jobs.sh`, …) and the
+`UserPromptSubmit` hook that used to intercept prompts to run them.
 
 ## Scripts
 
-### Bash Scripts (Recommended)
-
-These read from the pre-computed dashboard cache for <10ms response time.
-
-#### read-status.sh - Increment Status Overview
-
 ```bash
-bash plugins/specweave/scripts/read-status.sh
-bash plugins/specweave/scripts/read-status.sh 0045  # Specific increment
+node plugins/specweave/scripts/status.js      # increment status overview
+node plugins/specweave/scripts/progress.js    # task completion progress
+node plugins/specweave/scripts/jobs.js        # background job status
 ```
 
-#### read-progress.sh - Task Completion Progress
-
-```bash
-bash plugins/specweave/scripts/read-progress.sh
-bash plugins/specweave/scripts/read-progress.sh 0045  # Specific increment
-```
-
-#### read-jobs.sh - Background Job Status
-
-```bash
-bash plugins/specweave/scripts/read-jobs.sh
-bash plugins/specweave/scripts/read-jobs.sh --all     # Include completed
-```
+Supporting helpers: `detect-project-type.js`, `get-default-conditions.js`,
+`chunk-prompt.js`.
 
-### Node.js Scripts (Legacy - Fallback)
+`rebuild-dashboard-cache.sh` is the one remaining shell script; it is invoked by
+`specweave cache --rebuild` and is unix-only (tracked as a follow-up port).
 
-These are used when jq is not available or cache doesn't exist.
+## Equivalent CLI commands
 
 ```bash
-node plugins/specweave/scripts/status.js
-node plugins/specweave/scripts/progress.js
-node plugins/specweave/scripts/jobs.js
-```
-
-## Three Execution Paths
-
-These scripts work across all contexts through a layered architecture:
-
-| Layer | Context | Speed | How It Works |
-|-------|---------|-------|--------------|
-| **Command `!` Block** | Claude Code | <100ms | Command file auto-executes script via `` ```! `` block |
-| **Hook** | Claude Code | <100ms | `UserPromptSubmit` intercepts `sw:*`, runs script, blocks prompt |
-| **CLI** | Terminal | ~500ms | `specweave status` / direct `bash scripts/*.sh` |
-
-### 1. Claude Code (Command Auto-Execution - Primary)
-
-In Claude Code, commands with `` ```! `` blocks auto-execute scripts:
-
-```markdown
-# commands/jobs.md
----
-name: sw:jobs
-allowed-tools: ["Bash(${CLAUDE_PLUGIN_ROOT}/scripts/read-jobs.sh)"]
----
-
-```!
-bash "${CLAUDE_PLUGIN_ROOT}/scripts/read-jobs.sh" "$ARGUMENTS"
-```
-```
-
-When user types `sw:status`, the `` ```! `` block executes automatically.
-
-### 2. Claude Code (Hook - Fallback)
-
-The `UserPromptSubmit` hook provides a fallback intercept layer:
-
-```
-User types: sw:status
-Hook runs: bash plugins/specweave/scripts/read-status.sh
-Output appears instantly (<10ms)
-LLM never processes the prompt
-```
-
-### 3. Terminal (CLI - Direct)
-
-Users can run scripts directly without any LLM:
-
-```bash
-# Full CLI command
-specweave status
-specweave jobs
-
-# Direct script execution (bash preferred)
-bash plugins/specweave/scripts/read-status.sh
-bash plugins/specweave/scripts/read-progress.sh 0045
-```
-
-## When to Use Which
-
-| Situation | Recommended Path |
-|-----------|------------------|
-| Quick status check in Claude Code | Just type `sw:status` (auto-executes) |
-| Using other AI tools (Cursor, etc.) | Not supported - use CLI instead |
-| Terminal/scripting | `specweave status` or `bash scripts/*.sh` |
-| CI/CD pipelines | Direct `bash scripts/*.sh` |
-
-## Adding New Instant Commands
-
-To add a new instant command:
-
-1. Create script in `plugins/specweave/scripts/newcmd.sh`
-2. Add `--help` handling (required)
-3. Create command in `commands/newcmd.md` with `` ```! `` block:
-   ```markdown
-   ---
-   name: sw:newcmd
-   allowed-tools: ["Bash(${CLAUDE_PLUGIN_ROOT}/scripts/newcmd.sh)"]
-   ---
-
-   ```!
-   bash "${CLAUDE_PLUGIN_ROOT}/scripts/newcmd.sh" "$ARGUMENTS"
-   ```
-   ```
-4. (Optional) Add to hook dispatcher in `plugins/specweave/hooks/user-prompt-submit.sh`
-5. Test both paths (command auto-exec, CLI)
-
-### Script Template
-
-```javascript
-#!/usr/bin/env node
-/**
- * Description of what this script does
- * Usage: node newcmd.js [options] [--help]
- */
-
-import fs from 'fs';
-import path from 'path';
-
-// Handle --help (REQUIRED)
-if (process.argv.includes('--help') || process.argv.includes('-h')) {
-  console.log(`
-SpecWeave Instant NewCmd
-
-USAGE
-  node plugins/specweave/scripts/newcmd.js [options]
-
-OPTIONS
-  --help, -h     Show this help message
-
-DESCRIPTION
-  What this command does...
-
-EXECUTION PATHS
-  1. Claude Code:  sw:newcmd  (hook intercepts)
-  2. Any LLM:      Skill instructs to run this script
-  3. Terminal:     specweave newcmd
-`);
-  process.exit(0);
-}
-
-// Your implementation here
-const cwd = process.cwd();
-// ...
+specweave status      # increments overview
+specweave task list   # task progress for one increment
+specweave jobs        # background jobs
 ```
 
-## Design Principles
+## Hooks
 
-1. **Zero LLM tokens**: Pure filesystem reads, no AI reasoning needed
-2. **Single source of truth**: Hook, skill, and CLI all use these same scripts
-3. **Universal compatibility**: Works in Claude Code, Cursor, Copilot, terminal
-4. **Fast feedback**: <100ms response time for status queries
-5. **Self-documenting**: All scripts support `--help`
+SpecWeave registers exactly four Claude Code hooks (SessionStart, PreToolUse,
+Stop, PreCompact) in `plugins/specweave/hooks/hooks.json`. They all run
+`node ${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs <event>` in exec form — no shell, no
+bash. See `plugins/specweave/hooks/run.mjs`.

package/plugins/specweave/scripts/jobs.js

@@ -2,7 +2,8 @@
 /**
  * Instant Background Jobs Status
  *
- * Executed by UserPromptSubmit hook for sw:jobs
+ * Prints background job status. Run directly: node scripts/jobs.js
+ * CLI equivalent: `specweave jobs`.
  * Bypasses LLM entirely - output shown directly to user
  *
  * Usage: node jobs.js [--all] [--id <jobId>] [--help]
@@ -30,7 +31,7 @@ DESCRIPTION
   This script bypasses LLM processing for instant results (<100ms).
 
 EXECUTION PATHS
-  1. Claude Code:  sw:jobs  (hook intercepts, <100ms)
+  1. CLI:          specweave jobs
   2. Any LLM:      Skill instructs to run this script (~2s)
   3. Terminal:     specweave jobs (~500ms)
 

package/plugins/specweave/scripts/progress.js

@@ -2,8 +2,9 @@
 /**
  * Instant Increment Progress (Node.js fallback)
  *
- * Executed by UserPromptSubmit hook for sw:progress when jq is unavailable.
- * Reads files directly (no cache needed). Bypasses LLM entirely.
+ * Prints task-completion progress. Run directly: node scripts/progress.js
+ * Reads tasks.md directly (no cache, no CLI round-trip) and bypasses the LLM
+ * entirely. The CLI equivalent is `specweave task list`.
  *
  * Usage: node progress.js [incrementId] [--help]
  */
@@ -29,7 +30,7 @@ DESCRIPTION
   This script bypasses LLM processing for instant results (<100ms).
 
 EXECUTION PATHS
-  1. Claude Code:  sw:progress  (hook intercepts, <100ms)
+  1. CLI:          specweave status
   2. Any LLM:      Skill instructs to run this script (~2s)
   3. Terminal:     specweave status --verbose (~500ms)
 
@@ -199,7 +200,7 @@ console.log('\n📊 Increment Progress\n');
 if (needsClosure.length > 0) {
   console.log('⚠️  Needs Closure (100% tasks done):');
   for (const inc of needsClosure) {
-    console.log(`  ${inc.id} → sw:done ${inc.id}`);
+    console.log(`  ${inc.id} → specweave complete ${inc.id}`);
   }
   console.log('');
 }
@@ -217,7 +218,7 @@ if (readyForReview.length > 0) {
     }
     console.log(`  ${priBadge} ${inc.id}`);
     console.log(`     ${bar} ${inc.completedTasks}/${inc.totalTasks} tasks${acInfo}`);
-    console.log(`     → sw:done ${inc.id}`);
+    console.log(`     → specweave complete ${inc.id}`);
   }
   console.log('');
 }
@@ -281,11 +282,11 @@ if (totalActionable > 0) {
   console.log('');
 
   if (needsClosure.length > 0) {
-    console.log('💡 Run sw:done <id> to close completed increments');
+    console.log('💡 Run specweave complete <id> to close completed increments');
   } else if (readyForReview.length > 0) {
-    console.log('💡 Run sw:done <id> to close reviewed increments');
+    console.log('💡 Run specweave complete <id> to close reviewed increments');
   } else {
-    console.log('💡 For details: sw:progress <incrementId>');
+    console.log('💡 For details: specweave status');
   }
 } else {
   console.log('No active increments.');

package/plugins/specweave/scripts/status.js

@@ -2,7 +2,8 @@
 /**
  * Instant Increment Status Overview
  *
- * Executed by UserPromptSubmit hook for sw:status
+ * Prints the increment status overview. Run directly: node scripts/status.js
+ * CLI equivalent: `specweave status`.
  * Bypasses LLM entirely - output shown directly to user
  *
  * Usage: node status.js [--help]
@@ -28,7 +29,7 @@ DESCRIPTION
   This script bypasses LLM processing for instant results (<100ms).
 
 EXECUTION PATHS
-  1. Claude Code:  sw:status  (hook intercepts, <100ms)
+  1. CLI:          specweave status
   2. Any LLM:      Skill instructs to run this script (~2s)
   3. Terminal:     specweave status (~500ms)
 
@@ -113,7 +114,7 @@ for (const status of statusOrder) {
       console.log(`   ${item}`);
       // Add action hint for ready_for_review
       if (status === 'ready_for_review') {
-        console.log(`      → sw:done ${item}`);
+        console.log(`      → specweave complete ${item}`);
       }
     }
     if (items.length > 5) {
@@ -161,11 +162,11 @@ console.log('');
 
 // Context-aware command hints
 if (reviewCount > 0) {
-  console.log('💡 Next step: sw:done <id> to close reviewed increment(s)');
+  console.log('💡 Next step: specweave complete <id> to close reviewed increment(s)');
 } else if (activeCount > 0) {
   console.log('💡 Commands:');
-  console.log('   sw:progress        Show task progress');
-  console.log('   sw:do              Execute current tasks');
+  console.log('   specweave status   Show task progress');
+  console.log('   specweave task next  Pick the next task');
 } else {
   console.log('💡 Run sw:increment to start new work');
 }