specweave 0.9.1 → 0.10.1

package/README.md

@@ -10,347 +10,193 @@
 
 ---
 
-## The Problem Everyone Feels But Nobody Talks About
+## The Problem
 
-Your AI coding assistant writes features in 30 minutes.
+AI coding assistants made us **10x faster at shipping**, but **100x worse at maintaining**.
 
-You spend 3 days updating documentation.
-
-By day 4, the code has changed again.
+Your AI writes features in 30 minutes. You spend 3 days updating docs. By day 4, the code changed again.
 
 **The docs? Already wrong.**
 
 ---
 
-## The Dirty Secret of AI Coding
-
-AI coding assistants made us:
-- ✅ **10x faster at shipping**
-- ❌ **100x worse at maintaining**
-
-We're all "vibe coding" now. Fast. Fun. Chaotic.
-
-No structure. No boundaries. No memory of why we built it this way.
-
-New developers? Lost in 1 hour.
-
-**This is not sustainable.**
-
----
-
-## The Fortune 500 Gap
-
-Big companies don't have this problem.
-
-They have systems:
-- **PRDs** (Product Requirements) - What and why
-- **HLDs** (High-Level Design) - Architecture decisions
-- **ADRs** (Architecture Decision Records) - Why we chose X over Y
-- **Runbooks** (Operations) - How to actually run this
-- **Glossaries** (Terms) - What these acronyms mean
-
-Their docs stay updated because there's a team, a process, a **discipline**.
-
-But for solo developers and small teams?
-
-**Impossible to maintain manually.**
-
----
-
-## What is SpecWeave?
+## The Solution
 
 **Fortune 500 discipline. Zero overhead. AI-native.**
 
-SpecWeave is a spec-driven development framework that brings enterprise-grade processes to developers of any size—without the bureaucracy.
-
-It's not just a tool. **It's a movement.**
+SpecWeave brings enterprise-grade processes (PRDs, HLDs, ADRs, runbooks) to developers of any size—without the bureaucracy.
 
 > *"Dad, AI writes your code but you update docs MANUALLY?"*
 > — My 14-year-old daughter (who was absolutely right)
 
-**The new way:**
-- Living docs that ACTUALLY stay synced (automatically)
-- Complete knowledge system (PRDs, HLDs, ADRs, glossaries, runbooks)
-- Tests embedded in tasks (BDD format, full traceability)
-- Enterprise structure without enterprise overhead
-- **Vibe coding... but with boundaries**
+**Living docs that ACTUALLY stay synced** - Automatically updated after every task. No manual intervention.
 
 ---
 
-## What Changes
+## Works for Both
 
-**BEFORE (Vibe Coding):**
-- "I think we used JWT tokens?"
-- "Why did we choose PostgreSQL again?"
-- "What does this acronym mean?"
-- New developer: **Lost in 1 hour**
+**🌱 Greenfield** (New Projects)
+- Start with best practices from day one
+- Spec-driven development from the beginning
+- Clean, documented, maintainable
 
-**AFTER (SpecWeave):**
-- Check ADR-003: JWT vs Session Tokens (we chose JWT, here's why)
-- Check HLD: Database section (Postgres for ACID compliance)
-- Check Glossary: All technical terms defined
-- New developer: **Productive in 1 hour**
+**🏭 Brownfield** (Existing Projects)
+- Import docs from Notion, Confluence, Wiki
+- AI-powered classification (85%+ accuracy)
+- Gradual migration without disruption
 
----
-
-## 📊 Engineering Metrics (DORA)
-
-[![Deploy Frequency](https://img.shields.io/badge/dynamic/json?url=https://raw.githubusercontent.com/anton-abyzov/specweave/develop/metrics/dora-latest.json&query=$.metrics.deploymentFrequency.value&label=Deploy%20Frequency&suffix=/month&color=brightgreen)](https://spec-weave.com/docs/metrics)
-[![Lead Time](https://img.shields.io/badge/dynamic/json?url=https://raw.githubusercontent.com/anton-abyzov/specweave/develop/metrics/dora-latest.json&query=$.metrics.leadTime.value&label=Lead%20Time&suffix=h&color=brightgreen)](https://spec-weave.com/docs/metrics)
-[![Change Failure Rate](https://img.shields.io/badge/dynamic/json?url=https://raw.githubusercontent.com/anton-abyzov/specweave/develop/metrics/dora-latest.json&query=$.metrics.changeFailureRate.value&label=Change%20Failure%20Rate&suffix=%25&color=brightgreen)](https://spec-weave.com/docs/metrics)
-[![MTTR](https://img.shields.io/badge/dynamic/json?url=https://raw.githubusercontent.com/anton-abyzov/specweave/develop/metrics/dora-latest.json&query=$.metrics.mttr.value&label=MTTR&suffix=min&color=brightgreen)](https://spec-weave.com/docs/metrics)
-
-[View detailed metrics dashboard →](https://spec-weave.com/docs/metrics)
-
----
-
-## 📖 Full Documentation
-
-**For complete guides, tutorials, and API reference:**
-
-### **[spec-weave.com](https://spec-weave.com)**
+**[→ Brownfield Import Guide](https://spec-weave.com/docs/workflows/brownfield)**
 
 ---
 
 ## Quick Start
 
+### Greenfield (New Project)
 ```bash
-# Install SpecWeave CLI
+# Install SpecWeave
 npm install -g specweave
 
-# Initialize your project
+# Initialize new project
 specweave init my-project
 cd my-project
 
-# Start building - SpecWeave guides you through the entire workflow
+# Start building
 /specweave:increment "User authentication"  # Plan increment
-/specweave:do                               # Implement tasks (auto-pauses if blocked, auto-resumes when ready)
+/specweave:do                               # Implement tasks
 /specweave:done 0001                        # Complete increment
 ```
 
-**New to SpecWeave?** → **[Getting Started Guide](https://spec-weave.com/docs/guides/getting-started/quickstart)**
-
----
-
-## Key Features
-
-### 🧪 Test-Aware Planning
-Embedded test plans in every task with BDD format (Given/When/Then) for clarity
-
-### 🎯 Disciplined Progress
-Cannot start increment N+1 until N is DONE - enforces completion before moving forward
-
-### ⏸️ Intelligent Status Management
-Automatically detects when you're blocked (missing API keys, waiting for approval), pauses work with clear context, and resumes when ready - no manual intervention needed
-
-### 📚 Living Documentation
-Auto-updates after every task via Claude Code hooks - never outdated
-
-### 🤖 Intelligent Agents
-PM Agent, Architect, test-aware-planner, Quality Judge - specialized AI agents guide you
-
-
-### 🌍 Multilingual Support ($0 Cost!)
+### Brownfield (Existing Project)
+```bash
+# Initialize SpecWeave in existing project
+cd my-existing-project
+specweave init .
 
-Work in 11 languages with **FREE zero-cost translation**:
+# Import existing docs
+/specweave:import-docs ~/Downloads/notion-export --source=notion
 
-- **Primary Approach**: In-session translation (FREE, works with any model)
-- **Optional Approach**: Automated hooks (convenience, ~$0.003/increment)
-- **11 Languages**: English, Russian, Spanish, Chinese, German, French, Japanese, Korean, Portuguese, Arabic, Hebrew
-- **Any Model**: Claude, GPT-4, Gemini, DeepSeek, and more
-- **Any Tool**: Claude Code, Cursor, Copilot, ChatGPT
+# Continue normally
+/specweave:increment "Add dark mode"
+```
 
-**Zero API costs** - uses your current conversation context for translation!
+**[→ Complete Quickstart Guide](https://spec-weave.com/docs/guides/getting-started/quickstart)**
 
 ---
 
-## Enterprise Features
-
-### 🏢 Multi-Project Support (v0.8.0+)
-
-Organize documentation by team, repo, or microservice:
-
-- **Team-Based Organization**: Frontend, Backend, Mobile, Platform teams with separate documentation
-- **Microservices Architecture**: Each service gets its own specs, modules, and team playbooks
-- **Per-Project Sync**: Link projects to different GitHub repos, JIRA projects, or ADO boards
-- **Unified Architecture**: Single project = multi-project with 1 project (NO special cases!)
-
-**Five Documentation Types Per Project**:
-1. **specs/** - Living documentation specs (user stories, AC)
-2. **modules/** - Module/component documentation (architecture, APIs)
-3. **team/** - Team playbooks (onboarding, conventions, workflows)
-4. **architecture/** - Project-specific ADRs (optional)
-5. **legacy/** - Brownfield imports (temporary)
+## Real-World Example
 
-**[→ Multi-Project Setup Guide](https://spec-weave.com/docs/guides/multi-project-setup)**
+**Scenario**: Building authentication for SaaS app
 
-### 🔗 Issue Tracker Integration (v0.9.0+)
-
-**Strategy-based team mapping** adapts to your organization's structure:
-
-#### **GitHub - 3 Strategies**
-
-1. **Repository-per-team** (Most Common)
-   ```bash
-   GITHUB_STRATEGY=repository-per-team
-   GITHUB_REPOS=frontend-app,backend-api,mobile-app
-   ```
-   Best for: Microservices, independent deployments
-
-2. **Team-based** (Monorepo)
-   ```bash
-   GITHUB_STRATEGY=team-based
-   GITHUB_REPO=main-product
-   GITHUB_TEAMS=frontend-team,backend-team
-   ```
-   Best for: Monorepos (Nx, Turborepo, Lerna)
+```bash
+# 1. Plan increment (PM Agent creates spec with user stories)
+/specweave:increment "User authentication with OAuth"
 
-3. **Team-multi-repo** (Platform Teams)
-   ```bash
-   GITHUB_STRATEGY=team-multi-repo
-   GITHUB_TEAM_REPO_MAPPING='{"platform-team":["api-gateway","auth"]}'
-   ```
-   Best for: Platform teams owning multiple services
+# Result:
+# ✅ spec.md - User stories, acceptance criteria
+# ✅ plan.md - Architecture, implementation steps
+# ✅ tasks.md - Tasks with embedded tests (BDD format)
 
-#### **Jira - 3 Strategies**
+# 2. Implement (auto-pauses if blocked, resumes when ready)
+/specweave:do
 
-1. **Project-per-team** - Separate projects for each team
-2. **Component-based** - One project with components
-3. **Board-based** - One project with filtered boards
+# While you work:
+# - Living docs sync automatically after each task
+# - Tests embedded in tasks guide implementation
+# - ADRs document "why we chose X over Y"
+# - GitHub issues auto-sync (optional)
 
-#### **Azure DevOps - Team-Based**
+# 3. Complete (Quality Judge validates)
+/specweave:done 0001
 
-Fixed hierarchy: Organization → Project (ONE) → Teams (multiple)
-```bash
-AZURE_DEVOPS_PROJECT=MyProject
-AZURE_DEVOPS_TEAMS=Frontend,Backend,Mobile
+# Result:
+# ✅ Code implemented
+# ✅ Tests passing (90% coverage)
+# ✅ Docs synced (ADRs, HLDs, runbooks)
+# ✅ GitHub issues updated
+# ✅ New dev can onboard in 1 hour (not 1 week!)
 ```
 
-**[→ Complete Integration Guide](https://spec-weave.com/docs/integrations/issue-trackers)**
+---
+
+## 📊 Engineering Metrics (DORA)
 
-### 📦 Brownfield Import
+[![Deploy Frequency](https://img.shields.io/badge/dynamic/json?url=https://raw.githubusercontent.com/anton-abyzov/specweave/develop/metrics/dora-latest.json&query=$.metrics.deploymentFrequency.value&label=Deploy%20Frequency&suffix=/month&color=brightgreen)](https://github.com/anton-abyzov/specweave/blob/develop/.specweave/docs/internal/delivery/dora-metrics.md)
+[![Lead Time](https://img.shields.io/badge/dynamic/json?url=https://raw.githubusercontent.com/anton-abyzov/specweave/develop/metrics/dora-latest.json&query=$.metrics.leadTime.value&label=Lead%20Time&suffix=h&color=brightgreen)](https://github.com/anton-abyzov/specweave/blob/develop/.specweave/docs/internal/delivery/dora-metrics.md)
+[![Change Failure Rate](https://img.shields.io/badge/dynamic/json?url=https://raw.githubusercontent.com/anton-abyzov/specweave/develop/metrics/dora-latest.json&query=$.metrics.changeFailureRate.value&label=Change%20Failure%20Rate&suffix=%25&color=brightgreen)](https://github.com/anton-abyzov/specweave/blob/develop/.specweave/docs/internal/delivery/dora-metrics.md)
+[![MTTR](https://img.shields.io/badge/dynamic/json?url=https://raw.githubusercontent.com/anton-abyzov/specweave/develop/metrics/dora-latest.json&query=$.metrics.mttr.value&label=MTTR&suffix=min&color=brightgreen)](https://github.com/anton-abyzov/specweave/blob/develop/.specweave/docs/internal/delivery/dora-metrics.md)
 
-Import existing documentation from external sources:
+**[→ Live Dashboard](https://spec-weave.com/docs/metrics)** | **[→ Detailed Report](https://github.com/anton-abyzov/specweave/blob/develop/metrics/dora-report.md)**
 
-- **Automatic Classification**: AI-powered keyword detection (85%+ accuracy)
-- **Supported Sources**: Notion, Confluence, GitHub Wiki, custom markdown folders
-- **Smart Organization**: Classifies into specs, modules, team docs, or legacy
-- **Migration Reports**: Complete audit trail with confidence scores and manual review checklist
+---
 
-**Example**:
-```bash
-# Import Notion export to web-app project
-/specweave:import-docs ~/Downloads/notion-export --source=notion --project=web-app
+## Key Features
 
-# Result:
-# ✅ Classified 127 files
-#    - 37 specs → projects/web-app/specs/
-#    - 18 modules → projects/web-app/modules/
-#    - 12 team docs → projects/web-app/team/
-#    - 60 legacy → projects/web-app/legacy/notion/
-```
+- 🧪 **Test-Aware Planning** - Embedded tests in BDD format (Given/When/Then)
+- 🎯 **Disciplined Progress** - Can't start increment N+1 until N is DONE
+- ⏸️ **Intelligent Pausing** - Auto-detects blockers, pauses with context, resumes when ready
+- 📚 **Living Documentation** - Auto-updates after every task (no manual sync!)
+- 🤖 **AI Agents** - PM, Architect, Quality Judge guide your work
+- 🌍 **Multilingual** - Work in 11 languages (FREE translation)
+- 🏢 **Multi-Project** - Organize by team/repo/microservice
+- 🔗 **Issue Tracker Sync** - GitHub, Jira, Azure DevOps integration
 
-**[→ Brownfield Integration Guide](https://spec-weave.com/docs/workflows/brownfield)**
+**[→ Complete Feature List](https://spec-weave.com/docs/overview/features)**
 
 ---
 
-## Documentation Hub
+## 📖 Documentation
 
-**Learn SpecWeave:**
-- 📘 [What is SpecWeave?](https://spec-weave.com/docs/overview/introduction)
-- 🚀 [Quickstart Guide](https://spec-weave.com/docs/guides/getting-started/quickstart)
-- 🏗️ [Complete Workflow Journey](https://spec-weave.com/docs/workflows/overview)
-- ❓ [FAQ - Common Questions](https://spec-weave.com/docs/faq)
+**Complete guides, tutorials, and API reference:**
 
-**Commands & API:**
-- 📋 [Commands Reference](https://spec-weave.com/docs/commands/status-management)
-- 🔧 [API Documentation](https://spec-weave.com/docs/api)
+### **[spec-weave.com](https://spec-weave.com)**
 
-**Advanced Topics:**
-- 📊 [DORA Metrics Dashboard](https://spec-weave.com/docs/metrics)
-- 🏢 [Brownfield Integration](https://spec-weave.com/docs/workflows/brownfield)
-- 🌍 [Multilingual Support](https://spec-weave.com/docs/tutorial-extras/multilingual-support)
-- 🔗 [GitHub Actions Setup](https://spec-weave.com/docs/guides/github-action-setup)
+**Start here:**
+- 🚀 [Quickstart Guide](https://spec-weave.com/docs/guides/getting-started/quickstart) - 5-minute setup
+- 📘 [Complete Workflow](https://spec-weave.com/docs/workflows/overview) - End-to-end journey
+- 📋 [Commands Reference](https://spec-weave.com/docs/commands/status-management) - All commands
+- ❓ [FAQ](https://spec-weave.com/docs/faq) - Common questions
 
 ---
 
-## Community & Support
-
-**Join the Community:**
+## Community
 
-- 💬 **[Discord Server](https://discord.gg/UYg4BGJ65V)** - Get help, share tips, discuss features
-- 🎥 **[YouTube Channel](https://www.youtube.com/@antonabyzov)** - Tutorials, demos, deep dives
-- 📖 **[Documentation](https://spec-weave.com)** - Complete guides and API reference
-- 🐛 **[GitHub Issues](https://github.com/anton-abyzov/specweave/issues)** - Bug reports and feature requests
-- 💡 **[GitHub Discussions](https://github.com/anton-abyzov/specweave/discussions)** - Q&A and community discussions
-
-**Need Help?**
-1. Check the **[FAQ](https://spec-weave.com/docs/faq)** first
-2. Ask in **[Discord](https://discord.gg/UYg4BGJ65V)** for quick answers
-3. Create a **[GitHub Discussion](https://github.com/anton-abyzov/specweave/discussions)** for detailed questions
+- 💬 **[Discord](https://discord.gg/UYg4BGJ65V)** - Get help, share tips
+- 🎥 **[YouTube](https://www.youtube.com/@antonabyzov)** - Tutorials, demos
+- 🐛 **[GitHub Issues](https://github.com/anton-abyzov/specweave/issues)** - Report bugs
+- 💡 **[Discussions](https://github.com/anton-abyzov/specweave/discussions)** - Q&A, feature requests
 
 ---
 
 ## Contributing
 
-**Development Setup:**
-
 ```bash
-# Clone and setup
+# Setup
 git clone https://github.com/anton-abyzov/specweave.git
 cd specweave
-npm install
-npm run build
+npm install && npm run build
 
-# Run tests
+# Test
 npm test
 ```
 
-**To Contribute:**
-1. Fork repository
-2. Create feature branch: `git checkout -b features/002-new-feature`
-3. Follow SpecWeave conventions (see CLAUDE.md)
-4. Add tests (minimum 3 test cases)
-5. Create PR to `develop` branch
-
 **[→ Contributor Guide](https://spec-weave.com/docs/guides/contributing)**
 
 ---
 
-## Best Results with Claude Code
+## Best with Claude Code
 
-SpecWeave gives **best results with Claude Code** due to unique capabilities:
+SpecWeave works best with **[Claude Code](https://claude.com/claude-code)** (native plugins, auto-activating skills, lifecycle hooks).
 
-- ✅ **Native Plugin Marketplace** - Skills and agents auto-activate (no manual setup)
-- ✅ **Auto-Activating Skills** - Context-aware activation (no @ mentions)
-- ✅ **Isolated Agent Contexts** - True multi-agent role separation
-- ✅ **Pre/Post Lifecycle Hooks** - Automated living docs sync after every task
-- ✅ **MCP Protocol** - Industry standard for context management
-
-**Also works with**: Cursor, GitHub Copilot, ChatGPT (with manual workflow, reduced automation)
+Also works with: Cursor, GitHub Copilot, ChatGPT (manual workflow).
 
 **[→ Tool Comparison](https://spec-weave.com/docs/overview/features#claude-code-native)**
 
 ---
 
-## Status & License
+## License
 
-**Status**: Beta - Ready for testing and contributions
-**License**: MIT
-**Repository**: [github.com/anton-abyzov/specweave](https://github.com/anton-abyzov/specweave)
+MIT - [github.com/anton-abyzov/specweave](https://github.com/anton-abyzov/specweave)
 
 ---
 
-## Acknowledgments
-
-SpecWeave is inspired by:
-- [spec-kit](https://github.com/github/spec-kit) - GitHub's specification toolkit
-- [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) - Agentic agile framework
-- [Claude Code](https://claude.com/claude-code) - Anthropic's native plugin system
-- [C4 Model](https://c4model.com/) - Software architecture diagrams
-
----
-
-**SpecWeave** - AI made us fast. SpecWeave makes us sustainable.
-
-**Get started**: `npm install -g specweave` → `specweave init my-project` → **[Read the Docs](https://spec-weave.com)**
+**Get started**: `npm install -g specweave` → **[Read the Docs](https://spec-weave.com)**

package/bin/install-agents.sh

@@ -7,7 +7,7 @@
 
 set -e
 
-AGENTS_SRC="plugins/specweave-core/agents"
+AGENTS_SRC="plugins/specweave/agents"
 AGENTS_DEST=".claude/agents"
 
 # Parse arguments

package/bin/install-commands.sh

@@ -5,7 +5,7 @@
 
 set -e
 
-COMMANDS_SRC="plugins/specweave-core/commands"
+COMMANDS_SRC="plugins/specweave/commands"
 COMMANDS_DEST=".claude/commands"
 
 echo "════════════════════════════════════════════════════════"

package/bin/install-hooks.sh

@@ -7,7 +7,7 @@
 
 set -e
 
-HOOKS_SRC="plugins/specweave-core/hooks"
+HOOKS_SRC="plugins/specweave/hooks"
 HOOKS_DEST=".claude/hooks"
 
 # Parse arguments

package/bin/install-skills.sh

@@ -7,7 +7,7 @@
 
 set -e
 
-SKILLS_SRC="plugins/specweave-core/skills"
+SKILLS_SRC="plugins/specweave/skills"
 SKILLS_DEST=".claude/skills"
 
 # Parse arguments

package/bin/specweave.js

@@ -131,6 +131,33 @@ program
     await qaCommand(incrementId, options);
   });
 
+// Validate plugins command - Plugin validation
+program
+  .command('validate-plugins')
+  .description('Validate SpecWeave plugin installation')
+  .option('--auto-install', 'Auto-install missing components', false)
+  .option('--context <description>', 'Increment description for context detection')
+  .option('--dry-run', 'Show what would be installed without installing', false)
+  .option('-v, --verbose', 'Show detailed validation steps', false)
+  .action(async (options) => {
+    const { setupValidatePluginsCommand } = await import('../dist/cli/commands/validate-plugins.js');
+    // Create a temporary program for this command
+    const tempProgram = new Command();
+    setupValidatePluginsCommand(tempProgram);
+    // Execute the action directly
+    await import('../dist/cli/commands/validate-plugins.js').then(m => m.runValidation(options));
+  });
+
+// Validate Jira command - Jira resource validation
+program
+  .command('validate-jira')
+  .description('Validate Jira configuration and create missing resources')
+  .option('--env <path>', 'Path to .env file', '.env')
+  .action(async (options) => {
+    const { runJiraValidation } = await import('../dist/cli/commands/validate-jira.js');
+    await runJiraValidation(options);
+  });
+
 // Help text
 program.on('--help', () => {
   console.log('');
@@ -150,6 +177,11 @@ program.on('--help', () => {
   console.log('  $ specweave qa 0008                         # Quick quality check');
   console.log('  $ specweave qa 0008 --pre                   # Pre-implementation check');
   console.log('  $ specweave qa 0008 --gate --export         # Quality gate + export to tasks');
+  console.log('  $ specweave validate-plugins                # Validate plugin installation');
+  console.log('  $ specweave validate-plugins --auto-install # Auto-install missing plugins');
+  console.log('  $ specweave validate-plugins --dry-run      # Preview what would be installed');
+  console.log('  $ specweave validate-jira                   # Validate Jira configuration');
+  console.log('  $ specweave validate-jira --env .env.prod   # Validate with custom .env file');
   console.log('');
   console.log('Supported AI Tools:');
   console.log('  - Claude Code (full automation) - Native skills, agents, hooks');

package/dist/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAoBA,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CA6qBf"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAoBA,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAysBf"}

package/dist/cli/commands/init.js

@@ -441,7 +441,35 @@ export async function initCommand(projectName, options = {}) {
                 enableDocsPreview = response.enableDocsPreview;
                 if (enableDocsPreview) {
                     console.log(chalk.green('   ✔ Documentation preview enabled'));
-                    console.log(chalk.gray('   → Preview with: /specweave:docs preview'));
+                    // 🚨 CRITICAL FIX: Actually install the docs-preview plugin!
+                    // User said Yes → Install plugin immediately (like issue tracker setup)
+                    if (detectClaudeCli()) {
+                        console.log(chalk.gray('   → Installing specweave-docs-preview plugin...'));
+                        try {
+                            const result = execFileNoThrowSync('claude', [
+                                'plugin',
+                                'install',
+                                'specweave-docs-preview' // NO @marketplace suffix
+                            ]);
+                            if (result.success) {
+                                console.log(chalk.green('   ✔ specweave-docs-preview plugin installed'));
+                                console.log(chalk.gray('   → Preview with: /specweave:docs preview'));
+                            }
+                            else {
+                                console.log(chalk.yellow('   ⚠️  Plugin install failed (can install later)'));
+                                console.log(chalk.gray('   → Try manually: /plugin install specweave-docs-preview'));
+                            }
+                        }
+                        catch (error) {
+                            console.log(chalk.yellow('   ⚠️  Plugin install failed (can install later)'));
+                            console.log(chalk.gray('   → Try manually: /plugin install specweave-docs-preview'));
+                        }
+                    }
+                    else {
+                        console.log(chalk.gray('   → Preview with: /specweave:docs preview'));
+                        console.log(chalk.yellow('   ⚠️  Claude CLI not detected - install plugin manually:'));
+                        console.log(chalk.gray('   → /plugin install specweave-docs-preview'));
+                    }
                 }
                 else {
                     console.log(chalk.gray('   → Skipped (can enable later in .specweave/config.json)'));