specweave 1.0.137 → 1.0.139

package/CLAUDE.md

@@ -1,10 +1,10 @@
-<!-- SW:META template="claude" version="1.0.135" sections="header,start,autodetect,metarule,rules,workflow,reflect,context,lsp,structure,taskformat,secrets,syncing,mapping,testing,api,limits,troubleshooting,lazyloading,principles,linking,mcp,autoexecute,auto,docs" -->
+<!-- SW:META template="claude" version="1.0.138" sections="header,start,autodetect,metarule,rules,workflow,reflect,context,lsp,structure,taskformat,secrets,syncing,mapping,testing,api,limits,troubleshooting,lazyloading,principles,linking,mcp,autoexecute,auto,docs" -->
 
-<!-- SW:SECTION:header version="1.0.135" -->
+<!-- SW:SECTION:header version="1.0.138" -->
 **Framework**: SpecWeave | **Truth**: `spec.md` + `tasks.md`
 <!-- SW:END:header -->
 
-<!-- SW:SECTION:start version="1.0.135" -->
+<!-- SW:SECTION:start version="1.0.138" -->
 ## Getting Started
 
 **Initial increment**: `0001-project-setup` (auto-created by `specweave init`)
@@ -14,7 +14,7 @@
 2. **Customize**: Edit spec.md and use for setup tasks
 <!-- SW:END:start -->
 
-<!-- SW:SECTION:autodetect version="1.0.135" -->
+<!-- SW:SECTION:autodetect version="1.0.138" -->
 ## Auto-Detection
 
 SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
@@ -24,7 +24,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.135" -->
+<!-- SW:SECTION:metarule version="1.0.138" -->
 ## Meta-Rule: Think-Before-Act
 
 **Satisfy dependencies BEFORE dependent operations.**
@@ -35,7 +35,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 ```
 <!-- SW:END:metarule -->
 
-<!-- SW:SECTION:rules version="1.0.135" -->
+<!-- SW:SECTION:rules version="1.0.138" -->
 ## Rules
 
 1. **Files** → `.specweave/increments/####-name/` (spec.md, plan.md, tasks.md at root; reports/, scripts/, logs/ subfolders)
@@ -48,7 +48,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 8. **⛔ Marketplace refresh**: ALWAYS use `specweave refresh-marketplace` CLI command. NEVER suggest `scripts/refresh-marketplace.sh` - end users don't have the scripts folder (npm global install).
 <!-- SW:END:rules -->
 
-<!-- SW:SECTION:workflow version="1.0.135" -->
+<!-- SW:SECTION:workflow version="1.0.138" -->
 ## Workflow
 
 `/sw:increment "X"` → `/sw:do` → `/sw:progress` → `/sw:done 0001`
@@ -68,7 +68,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 **Natural language**: "Let's build X" → `/sw:increment` | "What's status?" → `/sw:progress` | "We're done" → `/sw:done` | "Ship while sleeping" → `/sw:auto`
 <!-- SW:END:workflow -->
 
-<!-- SW:SECTION:reflect version="1.0.135" -->
+<!-- SW:SECTION:reflect version="1.0.138" -->
 ## Self-Improving Skills (Reflect)
 
 **Learn once, never repeat.** Claude learns from corrections and patterns across sessions.
@@ -112,7 +112,7 @@ ls ~/.specweave/memory/*.md 2>/dev/null
 **Enable auto-learning**: `/sw:reflect-on` → Stop hook analyzes sessions automatically
 <!-- SW:END:reflect -->
 
-<!-- SW:SECTION:context version="1.0.135" -->
+<!-- SW:SECTION:context version="1.0.138" -->
 ## Living Docs Context
 
 **Before implementing features**: Check existing docs for patterns and decisions.
@@ -132,7 +132,7 @@ grep -ril "keyword" .specweave/docs/internal/
 **Use `/sw:context <topic>`** to load relevant living docs into conversation.
 <!-- SW:END:context -->
 
-<!-- SW:SECTION:lsp version="1.0.135" -->
+<!-- SW:SECTION:lsp version="1.0.138" -->
 ## LSP-Enhanced Exploration
 
 **USE LSP ACTIVELY** for semantic code understanding (100x faster than grep).
@@ -149,7 +149,7 @@ go install golang.org/x/tools/gopls@latest  # Go
 **Best Practices**: ALWAYS use `findReferences` before refactoring | Use `goToDefinition` instead of grep | Combine with Explore agent
 <!-- SW:END:lsp -->
 
-<!-- SW:SECTION:structure version="1.0.135" -->
+<!-- SW:SECTION:structure version="1.0.138" -->
 ## Structure
 
 ```
@@ -219,7 +219,7 @@ my-project/
 ```
 <!-- SW:END:structure -->
 
-<!-- SW:SECTION:taskformat version="1.0.135" -->
+<!-- SW:SECTION:taskformat version="1.0.138" -->
 ## Task Format
 
 ```markdown
@@ -229,7 +229,7 @@ my-project/
 ```
 <!-- SW:END:taskformat -->
 
-<!-- SW:SECTION:secrets version="1.0.135" -->
+<!-- SW:SECTION:secrets version="1.0.138" -->
 ## Secrets Check
 
 **BEFORE CLI tools**: Check existing config first!
@@ -243,7 +243,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.135" -->
+<!-- SW:SECTION:syncing version="1.0.138" -->
 ## External Sync (GitHub/JIRA/ADO)
 
 **After increment creation**: Run `/sw-github:sync {id}` to create issues!
@@ -271,7 +271,7 @@ Living docs sync ≠ External sync. They are separate:
 **Verify tokens**: `grep -q GITHUB_TOKEN .env && echo "Token configured"` | `gh auth status`
 <!-- SW:END:syncing -->
 
-<!-- SW:SECTION:mapping version="1.0.135" -->
+<!-- SW:SECTION:mapping version="1.0.138" -->
 ## GitHub Mapping
 
 | SpecWeave | GitHub |
@@ -281,7 +281,7 @@ Living docs sync ≠ External sync. They are separate:
 | Task T-XXX | Checkbox |
 <!-- SW:END:mapping -->
 
-<!-- SW:SECTION:testing version="1.0.135" -->
+<!-- SW:SECTION:testing version="1.0.138" -->
 ## Testing
 
 BDD in tasks.md | Unit >80% | `.test.ts` (Vitest)
@@ -293,7 +293,7 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 ```
 <!-- SW:END:testing -->
 
-<!-- SW:SECTION:api version="1.0.135" -->
+<!-- SW:SECTION:api version="1.0.138" -->
 ## API Development (OpenAPI-First)
 
 **For API projects only.** OpenAPI = source of truth → Postman derived from it.
@@ -312,13 +312,13 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 **Import**: Postman → Import collection + env → Fill secrets → Select env
 <!-- SW:END:api -->
 
-<!-- SW:SECTION:limits version="1.0.135" -->
+<!-- SW:SECTION:limits version="1.0.138" -->
 ## Limits
 
 **Max 1500 lines/file** — extract before adding
 <!-- SW:END:limits -->
 
-<!-- SW:SECTION:troubleshooting version="1.0.135" -->
+<!-- SW:SECTION:troubleshooting version="1.0.138" -->
 ## Troubleshooting
 
 | Issue | Fix |
@@ -340,7 +340,7 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 | Need all plugins loaded | `specweave load-plugins all` (~60K tokens) |
 <!-- SW:END:troubleshooting -->
 
-<!-- SW:SECTION:lazyloading version="1.0.135" -->
+<!-- SW:SECTION:lazyloading version="1.0.138" -->
 ## Lazy Plugin Loading (Auto-Loading)
 
 **SpecWeave automatically loads plugins** when you need them - no manual action required.
@@ -395,7 +395,7 @@ export SPECWEAVE_DISABLE_AUTO_LOAD=1  # Disable auto-loading
 | Agent spawn (forked) | 0 tokens in main context |
 <!-- SW:END:lazyloading -->
 
-<!-- SW:SECTION:principles version="1.0.135" -->
+<!-- SW:SECTION:principles version="1.0.138" -->
 ## Principles
 
 1. **Spec-first**: `/sw:increment` before coding
@@ -405,7 +405,7 @@ export SPECWEAVE_DISABLE_AUTO_LOAD=1  # Disable auto-loading
 5. **Clean**: All files in increment folders
 <!-- SW:END:principles -->
 
-<!-- SW:SECTION:linking version="1.0.135" -->
+<!-- SW:SECTION:linking version="1.0.138" -->
 ## Bidirectional Linking
 
 Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
@@ -413,7 +413,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.135" -->
+<!-- SW:SECTION:mcp version="1.0.138" -->
 ## External Service Connection
 
 **Priority**: MCP Server → REST API → CLI → Direct Connection
@@ -438,7 +438,7 @@ wrangler whoami 2>/dev/null
 ```
 <!-- SW:END:mcp -->
 
-<!-- SW:SECTION:autoexecute version="1.0.135" -->
+<!-- SW:SECTION:autoexecute version="1.0.138" -->
 ## Auto-Execute Rule
 
 **NEVER** output "Manual Step Required" when credentials exist. **EXECUTE DIRECTLY.**
@@ -453,7 +453,7 @@ wrangler whoami 2>/dev/null && gh auth status 2>/dev/null
 ```
 <!-- SW:END:autoexecute -->
 
-<!-- SW:SECTION:auto version="1.0.135" -->
+<!-- SW:SECTION:auto version="1.0.138" -->
 ## Auto Mode (Autonomous Execution)
 
 **Continuous execution until all tasks complete.**
@@ -530,7 +530,7 @@ wrangler whoami 2>/dev/null && gh auth status 2>/dev/null
 **Circuit Breaker**: External API fails 3x? Queue & continue
 <!-- SW:END:auto -->
 
-<!-- SW:SECTION:docs version="1.0.135" -->
+<!-- SW:SECTION:docs version="1.0.138" -->
 ## Docs
 
 [spec-weave.com](https://spec-weave.com) | `.specweave/docs/internal/`

package/bin/specweave.js

@@ -508,13 +508,14 @@ program
     await updateInstructionsCommand(options);
   });
 
-// Unified update command - One-stop update for everything (self-updates CLI by default)
+// Unified update command - One-stop update for everything (self-updates CLI AND plugins by default)
 program
   .command('update')
-  .description('Update SpecWeave: CLI (via npm), instructions, config, and optionally plugins')
+  .description('Update SpecWeave: CLI, instructions, config, AND plugins (default)')
   .option('--no-self', 'Skip CLI self-update via npm')
-  .option('--plugins', 'Also refresh marketplace plugins')
-  .option('--all', 'Full update including all plugins (not just router)')
+  .option('--no-plugins', 'Skip marketplace plugins refresh')
+  .option('--all', 'Install ALL plugins (not just router)')
+  .option('--minimal', 'Clean /plugin output (removes marketplace, no lazy loading)')
   .option('--check', 'Dry run - show what would change without making changes')
   .option('-v, --verbose', 'Show detailed output')
   .option('-f, --force', 'Force refresh even if up to date')
@@ -817,6 +818,7 @@ program
   .option('--local', 'Use local development version (ONLY for active dev)')
   .option('--github', 'Pull latest from GitHub (default, recommended)')
   .option('--all', 'Install ALL plugins (legacy mode, ~60K tokens)')
+  .option('--minimal', 'Remove marketplace, install only core plugins (clean /plugin output, no lazy loading)')
   .option('-f, --force', 'Force reinstall all plugins (clears cache, ensures fresh copy)')
   .option('-v, --verbose', 'Show detailed error messages')
   .action(async (options) => {

package/dist/src/adapters/claude/README.md

@@ -194,14 +194,16 @@ Agents are invoked explicitly via Task tool:
 
 ```typescript
 await Task({
-  subagent_type: "specweave:pm:pm",
-  prompt: "Create product requirements for user authentication",
-  description: "Product requirements analysis"
+  subagent_type: "sw-frontend:frontend-architect",
+  prompt: "Design React component architecture for dashboard",
+  description: "Frontend architecture design"
 });
 ```
 
 Agents have separate context windows to prevent pollution of main conversation.
 
+**Note**: Skills like PM and Architect auto-activate based on keywords - you don't invoke them via Task. Only specialized plugin agents (sw-frontend, sw-testing, sw-k8s, etc.) use Task invocation.
+
 ### Hooks Execution
 
 Hooks run automatically on events:

package/dist/src/adapters/cursor/README.md

@@ -107,10 +107,12 @@ User: "create increment for auth"
 
 **Claude Code (automatic)**:
 ```typescript
-Task({ subagent_type: "specweave:pm:pm", prompt: "create spec" })
-→ PM agent invoked with separate context window
+Task({ subagent_type: "sw-frontend:frontend-architect", prompt: "design components" })
+→ Frontend agent invoked with separate context window
 ```
 
+**Note**: In Claude Code, PM/Architect are SKILLS that auto-activate on keywords, not agents you invoke via Task.
+
 **Cursor (manual adoption)**:
 ```typescript
 User: "act as PM and create spec"

package/dist/src/adapters/generic/README.md

@@ -152,14 +152,16 @@ You manually execute the entire workflow!
 **In Claude Code**: Specialized roles with separate context windows
 **In Generic**: YOU tell AI which role to adopt
 
-### Example: PM Agent
+### Example: Frontend Agent
 
 **Claude Code (automatic)**:
 ```typescript
-Task({ subagent_type: "specweave:pm:pm", prompt: "create spec" })
-→ PM agent creates spec.md
+Task({ subagent_type: "sw-frontend:frontend-architect", prompt: "design components" })
+→ Frontend agent designs components with separate context window
 ```
 
+**Note**: In Claude Code, PM/Architect are SKILLS that auto-activate on keywords, not agents invoked via Task.
+
 **Generic (manual)**:
 ```
 You paste to ChatGPT:

package/dist/src/cli/commands/refresh-marketplace.d.ts

@@ -15,14 +15,22 @@
  *   - No intermediate cache needed (marketplace IS the cache!)
  *   - Result: ~5K tokens at startup instead of ~60K (90% savings!)
  *
+ * MINIMAL MODE (--minimal):
+ *   - Removes specweave marketplace entirely
+ *   - Installs only core plugins (sw, sw-router)
+ *   - Clean /plugin output (only shows installed plugins)
+ *   - Tradeoff: Lazy loading disabled (use --all to reinstall all)
+ *
  * Usage:
  *   specweave refresh-marketplace           # Lazy mode (default) - router only
  *   specweave refresh-marketplace --all     # Legacy mode - install all plugins
+ *   specweave refresh-marketplace --minimal # Minimal mode - clean /plugin output
  *   specweave refresh-marketplace --local   # Use local dev version
  *   specweave refresh-marketplace --github  # Use GitHub version (default)
  *
  * @since 1.0.60
  * @updated 1.0.122 - Added lazy loading support
+ * @updated 1.0.138 - Added minimal mode for clean /plugin output
  */
 interface RefreshOptions {
     local?: boolean;
@@ -31,6 +39,9 @@ interface RefreshOptions {
     force?: boolean;
     /** Install ALL plugins (legacy mode). Default: false (lazy loading - router only) */
     all?: boolean;
+    /** Minimal mode: Remove marketplace entirely, install only core plugins directly.
+     * Results in clean /plugin output but disables lazy loading. */
+    minimal?: boolean;
 }
 export declare function refreshMarketplaceCommand(options?: RefreshOptions): Promise<void>;
 export {};

package/dist/src/cli/commands/refresh-marketplace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refresh-marketplace.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/refresh-marketplace.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAkBH,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qFAAqF;IACrF,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAseD,wBAAsB,yBAAyB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgb3F"}
+{"version":3,"file":"refresh-marketplace.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/refresh-marketplace.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAkBH,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qFAAqF;IACrF,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;oEACgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA0rBD,wBAAsB,yBAAyB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+hB3F"}