specweave 0.6.0 → 0.6.3

package/.claude-plugin/README.md

@@ -14,7 +14,7 @@ When you clone this repo and **trust the folder** in Claude Code:
 2. The `.claude/settings.json` file **automatically registers** the marketplace
 3. Install the core plugin:
    ```
-   /plugin install specweave-core@specweave
+   /plugin install specweave@specweave
    ```
 4. **Restart Claude Code**
 5. Commands are now available: `/specweave:inc`, `/specweave:do`, etc.
@@ -43,7 +43,7 @@ If automatic setup doesn't work (or folder not trusted):
 # Should show "specweave" marketplace
 
 # 3. Install core plugin
-/plugin install specweave-core@specweave
+/plugin install specweave@specweave
 
 # 4. (Optional) Install other plugins as needed
 /plugin install specweave-github@specweave
@@ -76,7 +76,7 @@ Type `/github:` to see GitHub commands (if installed):
 └── README.md             # This file
 
 plugins/                  # Individual plugin locations
-├── specweave-core/.claude-plugin/plugin.json       # Core plugin manifest
+├── specweave/.claude-plugin/plugin.json       # Core plugin manifest
 ├── specweave-github/.claude-plugin/plugin.json     # GitHub plugin manifest
 ├── specweave-figma/.claude-plugin/plugin.json      # Figma plugin manifest
 └── ... (18 plugins total, each with plugin.json)
@@ -119,11 +119,8 @@ SpecWeave's marketplace.json follows Claude's official schema format. Here's the
 - ✅ `source` - Relative path to plugin directory (e.g., `"../plugins/specweave-github"`)
 - ✅ `category` - Plugin category: `development`, `productivity`, `security`, or `learning`
 - ✅ `author.email` - Author email address (required by Claude's schema)
-- ❌ No separate `path` field (was in older SpecWeave format)
-- ❌ No `source: "local"` type indicator (was in older SpecWeave format)
-
-**Migration Note**: Prior to v0.6.1, SpecWeave used a custom marketplace schema with separate `source` and `path` fields. This has been updated to match Claude's official schema for compatibility.
-
+- ❌ No separate `path` field (follows Claude's schema)
+- ❌ No `source: "local"` type indicator (follows Claude's schema)
 
 ## How It Works
 
@@ -133,23 +130,23 @@ SpecWeave's marketplace.json follows Claude's official schema format. Here's the
 - No namespacing
 
 **With Plugin System** (new):
-- Commands: `/specweave-core:inc`, `/specweave-core:do`, `/specweave-github:sync`
+- Commands: `/specweave:inc`, `/specweave:do`, `/specweave-github:sync`
 - Plugin-namespaced via `.claude-plugin/`
 - Proper marketplace structure
-- Each plugin has its own namespace (e.g., `specweave-core`, `specweave-github`)
+- Each plugin has its own namespace (e.g., `specweave`, `specweave-github`)
 
 ## Available Plugins
 
-### 1. SpecWeave Core (`specweave-core`)
-**Commands** (invoked as `/specweave-core:command`):
+### 1. SpecWeave Core (`specweave`)
+**Commands** (invoked as `/specweave:command`):
 - `increment` - Plan new product increment
 - `do` - Execute implementation tasks
 - `next` - Smart increment transition
 - `done` - Close increment with validation
 - `progress` - Show increment progress
 - `validate` - Validate increment quality
-- `status` - Show all increments (NEW in v0.6.0)
-- `close-previous` - Close incomplete increments (NEW in v0.6.0)
+- `status` - Show all increments
+- `close-previous` - Close incomplete increments
 
 **Skills**:
 - `increment-planner` - PM-led planning workflow
@@ -209,8 +206,8 @@ SpecWeave's marketplace.json follows Claude's official schema format. Here's the
 # Check installed plugins
 /plugin list
 
-# If specweave-core is missing, install it
-/plugin install specweave-core@specweave
+# If specweave is missing, install it
+/plugin install specweave@specweave
 
 # Restart Claude Code
 ```
@@ -222,8 +219,8 @@ ls .claude/commands/
 
 # Should show specweave.*.md files
 # If missing, reinstall plugin:
-/plugin uninstall specweave-core
-/plugin install specweave-core@specweave
+/plugin uninstall specweave
+/plugin install specweave@specweave
 
 # Then restart Claude Code
 ```
@@ -281,7 +278,7 @@ cd plugins/
 
 4. **Install specific plugin**:
    ```bash
-   /plugin install specweave-core@specweave
+   /plugin install specweave@specweave
    ```
 
 ### ".claude/settings.json not working"
@@ -308,16 +305,6 @@ git add -f .claude/settings.json
 git commit -m "feat: add Claude settings for auto-marketplace registration"
 ```
 
-## Version
-
-**Current**: v0.6.0 (Increment Discipline Enforcement)
-
-**Changelog**:
-- v0.6.0: Added `/specweave:status` and `/specweave:close-previous` commands
-- v0.5.1: Cross-platform path detection
-- v0.5.0: Plugin architecture foundation
-- v0.4.0: GitHub plugin
-
 ## Support
 
 - **Docs**: https://spec-weave.com

package/.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
   "name": "specweave",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "SpecWeave - Spec-Driven Development Framework. PM-led planning, intelligent model selection, living documentation, multi-tool support.",
   "owner": {
     "name": "Anton Abyzov",
@@ -9,11 +9,11 @@
   },
   "plugins": [
     {
-      "name": "specweave-core",
-      "description": "SpecWeave core framework - increment lifecycle, living docs, PM-led planning",
-      "source": "./plugins/specweave-core",
+      "name": "specweave",
+      "description": "SpecWeave framework - increment lifecycle, living docs, PM-led planning",
+      "source": "./plugins/specweave",
       "category": "development",
-      "version": "0.6.0",
+      "version": "0.6.1",
       "author": {
         "name": "Anton Abyzov",
         "email": "anton@spec-weave.com"

package/CLAUDE.md

@@ -1,8 +1,6 @@
 # SpecWeave - Development Guide
 
 **Project**: SpecWeave - Spec-Driven Development Framework
-**Version**: 0.6.0 (LLM-Native i18n Complete! - Ready for Release)
-**NPM Version**: 0.5.1 (Latest Published)
 **Type**: Open Source NPM Package (TypeScript CLI)
 **Repository**: https://github.com/anton-abyzov/specweave
 **Website**: https://spec-weave.com
@@ -601,7 +599,7 @@ if (parentSpecweave) {
 
 ### Core Plugin (Always Auto-Loaded)
 
-**Plugin**: `specweave-core` - The essential SpecWeave plugin loaded in every project:
+**Plugin**: `specweave` - The essential SpecWeave plugin loaded in every project:
 - **Skills**: 9 skills (increment-planner, tdd-workflow, rfc-generator, context-loader, project-kickstarter, brownfield-analyzer, brownfield-onboarder, increment-quality-judge, context-optimizer)
 - **Agents**: 22 agents (PM, Architect, Tech Lead, + 19 specialized including tdd-orchestrator)
 - **Commands**: 22 commands (/specweave:inc, /specweave:do, /specweave:next, /specweave:done, /specweave:progress, /specweave:validate, /specweave:sync-docs, + 15 specialized)
@@ -678,26 +676,96 @@ if (parentSpecweave) {
 - ML pipeline: Core + ml-ops + github ≈ **18K tokens** (64% reduction!)
 - SpecWeave itself: Core + github + diagrams ≈ **15K tokens** (70% reduction!)
 
-### How to Enable Plugins
+### How Plugins Are Loaded (Intelligent Auto-Loading)
 
-**Auto-Detection** (recommended):
-```bash
-specweave init  # Auto-detects and suggests plugins
-```
+**SpecWeave's plugin system is designed to be intelligent and non-intrusive:**
 
-**Manual**:
-```bash
-specweave plugin list           # See all available
-specweave plugin enable kubernetes
-specweave plugin disable figma-ecosystem
-```
+#### Phase 1: Initialize (FULLY AUTOMATED!)
+
+When you run `specweave init`:
+
+1. ✅ **Marketplace Auto-Registration**
+   - Creates `.claude/settings.json` with marketplace reference
+   - Claude Code automatically discovers plugins
+   - No manual `/plugin marketplace add` needed!
+
+2. ✅ **Core Plugin Auto-Installation** (NEW! v0.6.1+)
+   - Automatically runs: `claude plugin marketplace add` and `claude plugin install specweave@specweave`
+   - Works via CLI during init (uses user's shell to access `claude` command)
+   - Slash commands available IMMEDIATELY - no manual install!
+   - Success message: "✔ SpecWeave core plugin installed automatically!"
+   - Graceful fallback: If CLI unavailable, shows manual install instructions
+
+3. ℹ️  **Optional Plugins Suggested**
+   - Based on project detection (Git, package.json, etc.)
+   - User can install now or later
+
+#### Phase 2: Increment Planning (On-Demand Loading)
+
+When you create increments (e.g., `/specweave:inc "Add Stripe billing"`):
+
+1. **Spec Analysis** (NEW! v0.6.0+)
+   - increment-planner skill scans spec.md content
+   - Detects keywords: "Stripe", "GitHub", "Kubernetes", "React", etc.
+   - Maps keywords → required plugins (see Step 6 in increment-planner/SKILL.md)
+
+2. **Plugin Suggestion** (Non-Blocking)
+   ```
+   🔌 This increment requires additional plugins:
+
+   Required:
+   • specweave-payments - Stripe integration (detected: "billing", "Stripe")
+
+   📦 Install: /plugin install specweave-payments@specweave
+
+   Or continue without it (can install later)
+   ```
+
+3. **User Decision**
+   - Install now → Plugin activates immediately (after Claude Code restart)
+   - Install later → Skills won't be available until plugin installed
+   - Skip → Increment creation continues (not blocked)
+
+#### Phase 3: Implementation (Auto-Activation)
+
+When plugins are installed:
+
+1. **Skills Auto-Activate**
+   - Based on description keywords (Claude Code native behavior)
+   - No manual invocation needed
+   - Example: Mention "GitHub" → github-sync skill activates
+
+2. **Context Efficiency**
+   - Only loaded plugins consume tokens
+   - 70%+ reduction vs. monolithic approach
+   - Real-time: Simple React app = 16K tokens (was 50K in v0.3.7)
+
+### Manual Plugin Management
+
+All plugin management happens through Claude Code's native commands:
 
-**Spec-Based** (during increment planning):
 ```bash
-/specweave:inc "deploy to Kubernetes"
-# → Suggests kubernetes plugin before creating spec
+# List installed plugins
+/plugin list --installed
+
+# Install a specific plugin
+/plugin install specweave-kubernetes@specweave
+
+# Uninstall a plugin
+/plugin uninstall specweave-kubernetes
+
+# List all available plugins from marketplace
+/plugin list specweave
 ```
 
+**Key Insight**: SpecWeave uses **ONLY** Claude Code's native plugin system:
+- Plugins install globally via `/plugin install specweave-{name}@specweave`
+- Work across ALL projects (like VS Code extensions)
+- Auto-activate based on skills' description keywords
+- Managed by Claude Code (updates, uninstall, etc.)
+
+No per-project installation needed!
+
 ---
 
 ## Project Architecture
@@ -721,7 +789,7 @@ src/                            ← SOURCE OF TRUTH (TypeScript code only)
 └── utils/                      ← Utility functions
 
 plugins/                        ← ROOT: All plugins (version controlled)
-├── specweave-core/             ← CORE PLUGIN (framework essentials)
+├── specweave/             ← CORE PLUGIN (framework essentials)
 │   ├── .claude-plugin/         ← plugin.json (Claude native)
 │   ├── skills/                 ← Core skills (9 total)
 │   │   ├── rfc-generator/
@@ -734,8 +802,8 @@ plugins/                        ← ROOT: All plugins (version controlled)
 │   │   ├── tech-lead/
 │   │   └── ...
 │   ├── commands/               ← Core commands (7 core + 15 specialized)
-│   │   ├── specweave.inc.md
-│   │   ├── specweave.do.md
+│   │   ├── inc.md
+│   │   ├── do.md
 │   │   └── ...
 │   ├── hooks/                  ← Lifecycle hooks (8 total)
 │   │   ├── post-task-completion.sh
@@ -765,7 +833,7 @@ plugins/                        ← ROOT: All plugins (version controlled)
 **Rules**:
 - ✅ `src/` = TypeScript code ONLY (compiled to `dist/`)
 - ✅ ALL skills/agents/commands/hooks = Inside plugins (including core!)
-- ✅ `plugins/specweave-core/` = Core framework plugin (always loaded)
+- ✅ `plugins/specweave/` = Core framework plugin (always loaded)
 - ✅ `.claude/` = Installed from all enabled plugins
 - ❌ NEVER mix `*.ts` and `SKILL.md` in the same directory
 - ❌ NEVER edit files in `.claude/` directly (they get overwritten)
@@ -774,7 +842,7 @@ plugins/                        ← ROOT: All plugins (version controlled)
 **Key Architectural Principle**:
 - TypeScript code (`*.ts`) goes in `src/` → compiled to `dist/`
 - Claude-native files (`SKILL.md`, `AGENT.md`, `*.md`) go in `plugins/` → copied to `.claude/`
-- Even "core" framework components are in `plugins/specweave-core/` (everything is a plugin!)
+- Even "core" framework components are in `plugins/specweave/` (everything is a plugin!)
 - This separation ensures clean builds and prevents mixing compiled code with runtime files
 
 ### Tech Stack
@@ -836,7 +904,7 @@ specweave/
 │   └── utils/                  # Utility functions
 │
 ├── plugins/                    # ALL PLUGINS (root level)
-│   ├── specweave-core/         # CORE PLUGIN (framework essentials)
+│   ├── specweave/         # CORE PLUGIN (framework essentials)
 │   │   ├── .claude-plugin/
 │   │   │   └── plugin.json     # Claude native manifest
 │   │   ├── skills/             # Core skills (9 total)
@@ -855,9 +923,9 @@ specweave/
 │   │   │   ├── tech-lead/      # Tech Lead agent
 │   │   │   └── ...
 │   │   ├── commands/           # Core commands (22 total)
-│   │   │   ├── specweave.inc.md        # /specweave:inc
-│   │   │   ├── specweave.do.md         # /specweave:do
-│   │   │   ├── specweave.done.md       # /specweave:done
+│   │   │   ├── inc.md        # /specweave:inc
+│   │   │   ├── do.md         # /specweave:do
+│   │   │   ├── done.md       # /specweave:done
 │   │   │   └── ...
 │   │   ├── hooks/              # Lifecycle hooks (8 total)
 │   │   │   ├── post-task-completion.sh # Auto-runs after tasks complete
@@ -996,7 +1064,7 @@ specweave/
 **1. Editing Skills** (any plugin):
 ```bash
 # Core plugin (auto-loaded):
-vim plugins/specweave-core/skills/rfc-generator/SKILL.md
+vim plugins/specweave/skills/rfc-generator/SKILL.md
 
 # Other plugins (opt-in):
 vim plugins/specweave-github/skills/github-sync/SKILL.md
@@ -1007,7 +1075,7 @@ vim plugins/specweave-github/skills/github-sync/SKILL.md
 **2. Editing Agents** (any plugin):
 ```bash
 # Core plugin (auto-loaded):
-vim plugins/specweave-core/agents/pm/AGENT.md
+vim plugins/specweave/agents/pm/AGENT.md
 
 # Other plugins (opt-in):
 vim plugins/specweave-github/agents/github-manager/AGENT.md
@@ -1018,7 +1086,7 @@ vim plugins/specweave-github/agents/github-manager/AGENT.md
 **3. Editing Commands** (any plugin):
 ```bash
 # Core plugin (auto-loaded):
-vim plugins/specweave-core/commands/specweave.do.md
+vim plugins/specweave/commands/do.md
 
 # Other plugins (opt-in):
 vim plugins/specweave-github/commands/github-sync.md
@@ -1122,14 +1190,14 @@ Solution: Inactivity-based detection
 
 ```
 SpecWeave = Collection of Claude Code Plugins
-├── specweave-core (auto-loaded) ← The "framework" IS a plugin
+├── specweave (auto-loaded) ← The "framework" IS a plugin
 ├── specweave-github (opt-in)
 ├── specweave-figma (opt-in)
 └── ...all other plugins (opt-in)
 ```
 
 **What this means**:
-- ✅ `specweave-core` is a Claude Code plugin (happens to auto-load)
+- ✅ `specweave` is a Claude Code plugin (happens to auto-load)
 - ✅ All plugins follow identical structure (`.claude-plugin/plugin.json`, `skills/`, `agents/`, `commands/`)
 - ✅ Adding a skill = adding it to a plugin (always)
 - ❌ There are NO "core framework components" outside plugins
@@ -1165,7 +1233,7 @@ plugins/specweave-{name}/
 ```
 
 **Key Plugins** (for reference):
-- `specweave-core` - Framework essentials (always loaded)
+- `specweave` - Framework essentials (always loaded)
 - `specweave-github` - GitHub Issues integration
 - `specweave-{frontend|backend|infrastructure}` - Tech stack plugins
 
@@ -1179,10 +1247,10 @@ plugins/specweave-{name}/
 
 ```
 Is this feature...
-├─ Used by EVERY project? → specweave-core (auto-loaded)
+├─ Used by EVERY project? → specweave (auto-loaded)
 │  Examples: increment-planner, rfc-generator, tdd-workflow, PM/Architect agents
 │
-├─ Part of increment lifecycle? → specweave-core (auto-loaded)
+├─ Part of increment lifecycle? → specweave (auto-loaded)
 │  Examples: /specweave:inc, /specweave:do, living docs hooks
 │
 ├─ Tech stack specific? → New plugin: specweave-{stack}
@@ -1343,7 +1411,7 @@ Other tools simply can't match these capabilities. The adapters remain in the co
 **All components go into plugins** (see "Plugins" section above for complete instructions).
 
 **Quick reference**:
-- **Core components**: `plugins/specweave-core/{skills|agents|commands|hooks}/`
+- **Core components**: `plugins/specweave/{skills|agents|commands|hooks}/`
 - **Plugin components**: `plugins/specweave-{name}/{skills|agents|commands}/`
 - **Tests**: `tests/integration/{component-name}/` or `tests/unit/`