specweave 0.1.5 → 0.1.7

package/README.md

@@ -3,14 +3,18 @@
 > **Spec-Driven Development Framework** - Where specifications and documentation are the source of truth
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Version](https://img.shields.io/badge/version-0.1.0--beta.1-blue.svg)](https://github.com/specweave/specweave/releases/tag/v0.1.0-beta.1)
+[![Version](https://img.shields.io/badge/version-0.1.6-blue.svg)](https://github.com/anton-abyzov/specweave/releases/tag/v0.1.6)
 [![Status](https://img.shields.io/badge/status-beta-blue.svg)]()
+[![Website](https://img.shields.io/badge/website-spec--weave.com-green.svg)](https://spec-weave.com)
 
 ---
 
 ## Overview
 
-**SpecWeave** is an AI development framework that replaces "vibe coding" with **specification-first development**. Built on the principle that **specifications are the source of truth**, SpecWeave enables building software from solo projects to enterprise systems with confidence, precision, and 70%+ context reduction.
+**SpecWeave** is an AI development framework that replaces "vibe coding" with **specification-first development**. Built on the principle that **specifications are the source of truth**, SpecWeave enables building software from solo projects to enterprise systems with confidence and precision.
+
+**🌐 Website**: [spec-weave.com](https://spec-weave.com)
+**📦 npm**: [npmjs.com/package/specweave](https://www.npmjs.com/package/specweave)
 
 ### 🎯 Core Philosophy
 
@@ -18,16 +22,15 @@
 2. **Living Documentation** - Specs evolve with code, never diverge
 3. **Regression Prevention** - Document before modifying existing code
 4. **Test-Validated Features** - Every feature proven through automated tests
-5. **Context Precision** - Load only relevant specs (70%+ token reduction)
-6. **Auto-Role Routing** - Skills detect and delegate automatically
+5. **Ready Out of the Box** - All components pre-installed, no setup needed
 
 ---
 
 ## ✨ Key Features
 
-- 🤖 **19 Specialized Agents** - PM, Architect, DevOps, QA, Security, Backend, Frontend, and more
-- 🎯 **24 AI Skills** - Auto-detection, routing, context loading, orchestration
-- 📊 **Context Manifests** - 70%+ token reduction by loading only relevant specs
+- 🤖 **10 Specialized Agents** - PM, Architect, DevOps, QA, Security, SRE, Tech Lead, and more (all pre-installed!)
+- 🎯 **35+ AI Skills** - Technology stacks, integrations, utilities (all pre-installed!)
+- 📦 **Pre-Installed Components** - Everything ready immediately after `specweave init`
 - 🧪 **4-Level Testing** - Specification → Feature → Component → Automated tests
 - 📝 **Living Documentation** - Auto-updates via Claude Code hooks
 - 🎨 **Diagram Generation** - C4 Model diagrams (Context, Container, Component)
@@ -87,172 +90,133 @@ specweave init my-saas
 ### Available Commands
 
 ```bash
-specweave init [project]           # Create new project
-specweave list                     # List all available components
-specweave list --installed         # Show auto-installed components
+specweave init [project]           # Create new project with ALL components
 specweave --version                # Show version
 specweave --help                   # Show help
 ```
 
-**Note**: Components (agents & skills) auto-install on-demand - no manual installation needed!
+**Note**: All 10 agents and 35+ skills are copied to your project during `init` - ready to use immediately!
 
 ---
 
 ## 🚀 Quick Example
 
+**CRITICAL**: SpecWeave uses **EXPLICIT SLASH COMMANDS** - type them to activate the framework!
+
 ```bash
-# SpecWeave auto-activates when .specweave/ detected
+# Initialize project - ALL components pre-installed!
+npx specweave init my-app
+cd my-app
 
-User: "Create Next.js authentication with email and OAuth"
-    ↓
-SpecWeave: 🔷 SpecWeave Active
+# Everything ready immediately:
+# ✅ 10 agents in .claude/agents/
+# ✅ 35+ skills in .claude/skills/
+# ✅ 10 slash commands in .claude/commands/
 
-           📦 Installing required components...
-              ✅ Installed nextjs skill
-              ✅ Installed nodejs-backend skill
-              ✅ Installed security agent
-              ✅ Installed pm agent
-              ✅ Installed architect agent
+# Open Claude Code and use slash commands:
+
+User: /pi "Next.js authentication with email and OAuth"
+    ↓
+SpecWeave: 🔷 SpecWeave Active (/create-increment)
 
            🚀 Creating increment 0001-user-authentication...
+           📝 Using nextjs skill (already installed!)
+           🤖 PM agent creating requirements...
+           🏗️  Architect agent designing system...
 
 ✅ Increment created: .specweave/increments/0001-user-authentication/
 ✅ Files: spec.md, plan.md, tasks.md, tests.md
 
-User: "Create C4 context diagram for authentication"
+User: "Create C4 context diagram for authentication"  # Regular conversation for implementation
     ↓
-SpecWeave: (coordinates diagrams-generator → diagrams-architect)
+SpecWeave: 🎨 Using diagrams-generator skill
+           🤖 Coordinating with diagrams-architect agent
+
 ✅ Diagram saved: .specweave/docs/internal/architecture/diagrams/auth.c4-context.mmd
 
-User: "Implement authentication"
+User: "Implement authentication based on plan.md"  # Regular conversation
     ↓
-SpecWeave: (orchestrates PM → Architect → Backend → QA → Docs)
+SpecWeave: 🤖 Implementing based on specifications
+
 ✅ Code: src/auth/
 ✅ Tests: tests/auth/
 ✅ Docs: Updated automatically
+
+User: /done 0001  # Close increment with slash command
+✅ Increment 0001 closed successfully
 ```
 
 **How it works**:
-1. `.specweave/` detected → `specweave-detector` activates automatically
-2. **User intent analyzed** → required components auto-installed (just-in-time)
-3. Request parsed → routed to appropriate skills
-4. Skills coordinate agents → artifacts generated
-5. Context loaded precisely → only relevant specs (70%+ reduction)
+1. `specweave init` → ALL components pre-installed (10 agents + 35+ skills)
+2. **Use `/pi "feature"`** → Creates increment with specs (spec.md, plan.md, tasks.md, tests.md)
+3. **Regular conversation** → Implement code based on specifications
+4. **Use `/done 0001`** → Close increment when complete
+5. All components ready - no waiting, no installation
+
+**Why slash commands?** Auto-activation doesn't work reliably - slash commands ensure SpecWeave ALWAYS activates when you want it.
 
 ---
 
-## 🤖 Agents (19 Total)
-
-SpecWeave includes **19 specialized AI agents** that provide domain expertise:
-
-### Strategic Layer
-| Agent | Role | Status |
-|-------|------|--------|
-| **pm** | Product Manager - requirements, user stories, roadmap | ✅ Implemented |
-| **architect** | System Architect - design, ADRs, technology decisions | ✅ Implemented |
-| **tech-lead** | Technical Lead - code review, best practices | ✅ Implemented |
-
-### Implementation Layer
-| Agent | Role | Status |
-|-------|------|--------|
-| **nodejs-backend** | Node.js/TypeScript backend development | ✅ Implemented |
-| **python-backend** | Python/FastAPI backend development | ✅ Implemented |
-| **dotnet-backend** | C#/.NET/ASP.NET Core development | ✅ Implemented |
-| **frontend** | React/Vue frontend development | ✅ Implemented |
-| **nextjs** | Next.js App Router specialist | ✅ Implemented |
-
-### Quality & Operations
-| Agent | Role | Status |
-|-------|------|--------|
-| **qa-lead** | QA Lead - test strategy, test cases, quality gates | ✅ Implemented |
-| **security** | Security Engineer - threat modeling, OWASP, compliance | ✅ Implemented |
-| **devops** | DevOps - CI/CD, infrastructure, deployment | ✅ Implemented |
-| **sre** | SRE - monitoring, incidents, reliability | ✅ Implemented |
-| **performance** | Performance Engineer - profiling, optimization | ✅ Implemented |
-
-### Documentation & Design
-| Agent | Role | Status |
-|-------|------|--------|
-| **docs-writer** | Technical Writer - API docs, guides, tutorials | ✅ Implemented |
-| **diagrams-architect** | Diagram generation - C4 Model, Mermaid, architecture | ✅ Implemented |
-| **figma-designer** | Figma designer - design systems, UI/UX | ✅ Implemented |
-| **figma-implementer** | Figma to code - React/Angular components | ✅ Implemented |
-
-### Integration
-| Agent | Role | Status |
-|-------|------|--------|
-| **specweave-jira-mapper** | JIRA ↔ SpecWeave bidirectional sync | ✅ Implemented |
-| **specweave-ado-mapper** | Azure DevOps ↔ SpecWeave bidirectional sync | ✅ Implemented |
-
-**All agents** have AGENT.md with YAML frontmatter and 3+ test cases.
+## 🤖 Agents (10 Total - All Pre-Installed!)
+
+SpecWeave includes **10 specialized AI agents** that work with slash commands and during implementation:
+
+| Agent | Role | When It Activates |
+|-------|------|-------------------|
+| **pm** | Product Manager - requirements, user stories | Planning features, creating increments |
+| **architect** | System Architect - design, ADRs, decisions | Technical design, architecture |
+| **security** | Security Engineer - threat modeling, OWASP | Security review, vulnerability assessment |
+| **qa-lead** | QA Lead - test strategy, quality gates | Testing, quality assurance |
+| **devops** | DevOps Engineer - CI/CD, infrastructure | Deployment, infrastructure needs |
+| **tech-lead** | Technical Lead - code review, best practices | Code review, refactoring |
+| **sre** | SRE - incident response, monitoring | Production incidents, troubleshooting |
+| **docs-writer** | Technical Writer - documentation | Writing docs, API documentation |
+| **performance** | Performance Engineer - optimization | Performance issues, profiling |
+| **diagrams-architect** | Diagram Expert - C4 Model, Mermaid | Creating diagrams (via diagrams-generator skill) |
+
+**All agents pre-installed** in `.claude/agents/` after `specweave init` - ready to use immediately!
 
 ---
 
-## 🎯 Skills (24 Total)
-
-SpecWeave includes **24 AI skills** that coordinate agents and provide specialized capabilities:
-
-### Core Orchestration
-| Skill | Purpose | Status |
-|-------|---------|--------|
-| **specweave-detector** | Auto-detect SpecWeave projects (proactive entry point) | ✅ Implemented |
-| **skill-router** | Route requests to appropriate skills/agents (>90% accuracy) | ✅ Implemented |
-| **context-loader** | Load specs selectively (70%+ token reduction) | ✅ Implemented |
-| **role-orchestrator** | Multi-agent coordinator (factory of agents) | ✅ Implemented |
-
-### Feature Planning
-| Skill | Purpose | Status |
-|-------|---------|--------|
-| **increment-planner** | Plan features with context awareness | ✅ Implemented |
-| **task-builder** | Break features into executable tasks | ✅ Implemented |
-| **docs-updater** | Auto-update documentation via hooks | ✅ Implemented |
-
-### Brownfield Tools
-| Skill | Purpose | Status |
-|-------|---------|--------|
-| **brownfield-analyzer** | Analyze existing codebases | ✅ Implemented |
-| **brownfield-onboarder** | Merge existing CLAUDE.md intelligently | ✅ Implemented |
-
-### Integration
-| Skill | Purpose | Status |
-|-------|---------|--------|
-| **jira-sync** | Sync with JIRA (coordinates with specweave-jira-mapper) | ✅ Implemented |
-| **ado-sync** | Sync with Azure DevOps (coordinates with specweave-ado-mapper) | ✅ Implemented |
-| **github-sync** | Sync with GitHub issues | ✅ Implemented |
-
-### Infrastructure
-| Skill | Purpose | Status |
-|-------|---------|--------|
-| **hetzner-provisioner** | Provision Hetzner Cloud infrastructure | ✅ Implemented |
-| **cost-optimizer** | Optimize cloud infrastructure costs | ✅ Implemented |
-
-### Diagram & Design
-| Skill | Purpose | Status |
-|-------|---------|--------|
-| **diagrams-generator** | Generate C4 diagrams (coordinates with diagrams-architect) | ✅ Implemented |
-| **design-system-architect** | Design system creation (Atomic Design) | ✅ Implemented |
-| **figma-mcp-connector** | Connect to Figma MCP servers | ✅ Implemented |
-| **figma-to-code** | Convert Figma designs to code | ✅ Implemented |
-
-### Product Features
-| Skill | Purpose | Status |
-|-------|---------|--------|
-| **calendar-system** | Calendar and scheduling features | ✅ Implemented |
-| **notification-system** | Email, push, SMS, in-app notifications | ✅ Implemented |
-| **stripe-integrator** | Stripe payment integration | ✅ Implemented |
-
-### Framework Comparison
-| Skill | Purpose | Status |
-|-------|---------|--------|
-| **bmad-method-expert** | BMAD-METHOD comparison and gap analysis | ✅ Implemented |
-| **spec-kit-expert** | spec-kit comparison and gap analysis | ✅ Implemented |
-
-### Meta
-| Skill | Purpose | Status |
-|-------|---------|--------|
-| **skill-creator** | Guide for creating new skills | ✅ Implemented |
-
-**All skills** have SKILL.md with YAML frontmatter and 3+ test cases.
+## 🎯 Skills (35+ Total - All Pre-Installed!)
+
+SpecWeave includes **35+ AI skills** that work with slash commands:
+
+### Core Framework Skills
+- **specweave-detector** - Slash command documentation
+- **increment-planner** - Plan features via `/pi` command
+- **skill-router** - Route requests to appropriate skills
+- **context-loader** - Load relevant specifications
+- **role-orchestrator** - Coordinate multiple agents
+
+### Technology Stack Skills
+- **nextjs** - Next.js App Router, Server Components
+- **nodejs-backend** - Node.js, Express, NestJS APIs
+- **python-backend** - FastAPI, Django APIs
+- **dotnet-backend** - ASP.NET Core APIs
+- **frontend** - React, Vue, Angular components
+
+### Integration Skills
+- **jira-sync** - Sync with JIRA issues
+- **ado-sync** - Sync with Azure DevOps
+- **github-sync** - Sync with GitHub issues
+
+### Design & Diagram Skills
+- **diagrams-generator** - Generate C4 diagrams
+- **figma-designer** - Create Figma designs
+- **figma-implementer** - Convert Figma to code
+
+### Infrastructure Skills
+- **hetzner-provisioner** - Deploy to Hetzner Cloud
+- **cost-optimizer** - Optimize cloud costs
+
+### Brownfield Skills
+- **brownfield-analyzer** - Analyze existing codebases
+- **brownfield-onboarder** - Merge existing documentation
+
+**And many more!** All skills pre-installed in `.claude/skills/` after `specweave init`.
+
+**See**: [Complete skill list](https://spec-weave.com/docs/skills) on spec-weave.com
 
 ---
 
@@ -299,11 +263,10 @@ specweave/
 │   ├── hooks/                   # Claude Code hooks
 │   └── templates/               # Project templates
 │
-├── .claude/                     # Installed components (gitignored)
-│   ├── agents/                  # Installed from src/agents/
-│   ├── skills/                  # Installed from src/skills/
-│   ├── commands/                # Installed from src/commands/
-│   └── hooks/                   # Symlinks to src/hooks/
+├── .claude/                     # Pre-installed components (user projects)
+│   ├── agents/                  # 10 agents (copied during init)
+│   ├── skills/                  # 35+ skills (copied during init)
+│   └── commands/                # 10 slash commands (copied during init)
 │
 ├── tests/                       # Framework tests
 │   ├── unit/
@@ -325,22 +288,30 @@ specweave/
 
 ### For Greenfield Projects
 
+**IMPORTANT**: Use slash commands to activate SpecWeave!
+
 ```bash
 # 1. Create specifications (optional: comprehensive upfront or incremental)
 # Option A: Comprehensive (Enterprise) - 500-600+ pages upfront
 # Option B: Incremental (Startup) - Build as you go
 
-# 2. Create increment
-/create-increment "user authentication"
+# 2. Create increment with slash command
+/pi "user authentication"
+# Short alias for /create-increment
+# SpecWeave orchestrates: PM → Architect → QA agents
+# Creates: spec.md, plan.md, tasks.md, tests.md
 
-# 3. Implement with auto-role routing
-"Implement user authentication"
-# SpecWeave orchestrates: PM → Architect → Backend → QA → Docs
+# 3. Implement with regular conversation (no slash command needed)
+"Implement user authentication based on plan.md"
+# Claude implements based on specifications
 
-# 4. Generate diagrams
+# 4. Generate diagrams (regular conversation)
 "Create C4 context diagram for authentication"
 
-# 5. Sync with tools (optional)
+# 5. Close increment with slash command
+/done 0001
+
+# 6. Sync with tools (optional)
 /sync-github  # Sync to GitHub issues
 ```
 
@@ -390,38 +361,6 @@ SpecWeave implements **4 Levels of Testing**:
 
 ---
 
-## 📊 Context Precision (70%+ Reduction)
-
-SpecWeave uses **context manifests** to load only relevant specifications:
-
-**Without context manifests** (traditional):
-- Load entire spec/ folder
-- 100,000+ tokens
-- Slow, expensive, context pollution
-
-**With context manifests** (SpecWeave):
-- Load only relevant sections
-- 10,000-30,000 tokens
-- **70%+ reduction**
-- Fast, efficient, focused
-
-**Example**:
-```yaml
-# .specweave/increments/0001-auth/context-manifest.yaml
-spec_sections:
-  - .specweave/docs/internal/strategy/auth/authentication-spec.md
-  - .specweave/docs/internal/strategy/auth/authorization-spec.md
-
-documentation:
-  - .specweave/docs/internal/architecture/auth-hld.md
-  - CLAUDE.md#authentication
-
-max_context_tokens: 10000
-```
-
-**See [CLAUDE.md#context-precision](CLAUDE.md#scalable-directory-structure)** for details.
-
----
 
 ## 🎨 Diagram Generation
 
@@ -502,24 +441,22 @@ sync:
 
 ## 📚 Documentation
 
-- **[CLAUDE.md](CLAUDE.md)** - **START HERE** - Complete development guide (source of truth)
-- **[INSTALLATION.md](INSTALLATION.md)** - Detailed installation instructions
-- **[.specweave/docs/README.md](.specweave/docs/README.md)** - Documentation structure
-- **[Diagram Conventions](.specweave/docs/internal/delivery/guides/diagram-conventions.md)** - C4 Model conventions
-- **[Tool Concept Mapping](.specweave/docs/internal/delivery/guides/tool-concept-mapping.md)** - Tool mappings
-- **[.specweave/increments/README.md](.specweave/increments/README.md)** - Increments guide
+- **[spec-weave.com](https://spec-weave.com)** - **START HERE** - Complete documentation website
+- **[npm Package](https://www.npmjs.com/package/specweave)** - Installation and quick start
+- **[GitHub](https://github.com/anton-abyzov/specweave)** - Source code and examples
+- **[CLAUDE.md](CLAUDE.md)** - Complete development guide (created after `specweave init`)
 
 ---
 
 ## 🤝 Contributing
 
-We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+We welcome contributions!
 
 ### Development Setup
 
 ```bash
 # Clone repository
-git clone https://github.com/specweave/specweave.git
+git clone https://github.com/anton-abyzov/specweave.git
 cd specweave
 
 # Install dependencies
@@ -528,19 +465,14 @@ npm install
 # Build TypeScript
 npm run build
 
-# Install components
-npm run install:all
-
 # Run tests
 npm test
-
-# Restart Claude Code
 ```
 
 **To contribute**:
 1. Fork repository
-2. Create feature branch: `git checkout -b features/001-new-feature`
-3. Follow [CLAUDE.md](CLAUDE.md) conventions
+2. Create feature branch: `git checkout -b features/002-new-feature`
+3. Follow SpecWeave conventions (see CLAUDE.md after init)
 4. Add 3+ test cases (MANDATORY)
 5. Create PR to `develop` branch
 
@@ -548,75 +480,72 @@ npm test
 
 ## 🏷️ Project Status
 
-**Version**: 0.1.0-beta.1
+**Version**: 0.1.6
 **Status**: Public Beta
 **License**: MIT
-**Release Date**: 2025-10-27
+**Release Date**: 2025-10-28
+**Website**: [spec-weave.com](https://spec-weave.com)
 
-### ✅ What Works (v0.1.0-beta.1)
+### ✅ What Works (v0.1.6)
 
-- ✅ **19 Agents** fully implemented with test cases
-- ✅ **24 Skills** fully implemented with test cases
-- ✅ **CLI Tool** - `specweave` command (`init`, `install`, `list`)
-- ✅ **Auto-detection** and intelligent routing (>90% accuracy)
-- ✅ **Context manifests** (70%+ token reduction)
+- ✅ **10 Agents** fully implemented and pre-installed
+- ✅ **35+ Skills** fully implemented and pre-installed
+- ✅ **CLI Tool** - `specweave init` with complete component copying
+- ✅ **Ready Out of the Box** - All components installed during init
+- ✅ **Auto-detection** and intelligent routing (fixed in 0.1.6!)
 - ✅ **Diagram generation** (C4 Model with validation)
-- ✅ **Install scripts** (selective installation based on tech stack)
 - ✅ **4-level testing framework** (spec → feature → component → automated)
-- ✅ **JIRA/ADO/GitHub sync** agents
+- ✅ **JIRA/ADO/GitHub sync** integration
 - ✅ **Brownfield analyzer** (retroactive specs, regression prevention)
 - ✅ **Increment lifecycle** (5 stages, WIP limits, leftover transfer)
 - ✅ **Increment validation** (120 rules, auto-validation on save)
 - ✅ **Hooks system** (auto-update docs, validations)
-- ✅ **Documentation** (CHANGELOG.md, INSTALL.md, comprehensive guides)
-
-### ⏳ In Progress (v0.1.0-beta.2)
-
-- ⏳ NPM package publishing (beta.1 installable via GitHub only)
-- ⏳ Additional CLI commands (`audit`, `cleanup`)
-- ⏳ More project templates (currently: saas, api, fullstack)
-- ⏳ GitHub Actions CI/CD integration
-- ⏳ MkDocs documentation site deployment
+- ✅ **Living Documentation** - Auto-updated via Claude Code hooks
+- ✅ **npm Package** - Published and ready to use
 
 ### 📅 Planned (v0.2.0+)
 
-- 📅 Quality gates (inspired by BMAD `@qa *gate`)
-- 📅 Risk scoring (inspired by BMAD `@qa *risk`)
-- 📅 Clarification workflow (inspired by spec-kit `/speckit.clarify`)
-- 📅 Dependency tracking in tasks (inspired by spec-kit)
-- 📅 Agent-agnostic support (Copilot, Cursor, Gemini, etc.)
+- 📅 Quality gates and risk scoring
 - 📅 Web UI for planning phase
 - 📅 VS Code extension
 - 📅 Homebrew formula
-- 📅 Test importer (import existing tests)
+- 📅 Additional project templates
 
 ---
 
-## 📖 Example Projects
+## 📖 Quick Start
 
-### SaaS Application
+### Initialize New Project
 
 ```bash
-git clone https://github.com/specweave/specweave.git my-saas
+# Create new project (all components pre-installed!)
+npx specweave init my-saas
 cd my-saas
-npm install && npm run install:all
 
-# Create features
-/create-increment "user authentication"
-/create-increment "subscription billing"
-/create-increment "admin dashboard"
+# Everything ready:
+# ✅ 10 agents in .claude/agents/
+# ✅ 35+ skills in .claude/skills/
+# ✅ 10 slash commands in .claude/commands/
 
-# Implement
-"Implement all increments"
+# Open Claude Code and start building:
+# "Create user authentication with JWT"
+# "Add subscription billing with Stripe"
+# "Build admin dashboard with analytics"
 ```
 
-### API Service
+### For Existing Projects
 
 ```bash
-# Similar setup, different increments
-/create-increment "REST API with OpenAPI"
-/create-increment "GraphQL endpoint"
-/create-increment "WebSocket real-time features"
+# Add SpecWeave to existing project
+cd my-existing-project
+npx specweave init .
+
+# Analyze existing code
+# "Analyze my authentication module"
+# SpecWeave creates retroactive specifications
+
+# Safe to modify
+# "Add OAuth to authentication"
 ```
 
 ---
@@ -630,7 +559,7 @@ npm install && npm run install:all
 | **Documentation** | Outdated, ignored | Living, auto-updated |
 | **Specifications** | Optional, vague | Source of truth, precise |
 | **Testing** | Manual, incomplete | 4-level, validated |
-| **Context** | Full codebase loaded | 70%+ reduction |
+| **Components** | Manual setup | Pre-installed (10 agents + 35+ skills) |
 | **Regression** | Frequent breaks | Prevention-first |
 | **Onboarding** | Weeks | Hours (specs explain everything) |
 | **Brownfield** | Risky | Safe (document first) |
@@ -638,29 +567,34 @@ npm install && npm run install:all
 ### vs Other Frameworks
 
 **vs spec-kit** (GitHub):
-- ✅ SpecWeave: Auto-role routing, context precision
-- ✅ SpecWeave: Living documentation via hooks
-- ✅ SpecWeave: Brownfield analysis
-- ✅ SpecWeave: 19 agents + 24 skills
+- ✅ SpecWeave: **Pre-installed agents** (10) and skills (35+) - spec-kit requires manual setup
+- ✅ SpecWeave: **Living documentation** via Claude Code hooks - auto-updates on changes
+- ✅ SpecWeave: **Brownfield analysis** - retroactive spec generation for existing code
+- ✅ SpecWeave: **Tool integration** - JIRA, ADO, GitHub bidirectional sync
 
 **vs BMAD-METHOD**:
-- ✅ SpecWeave: Context manifests (70%+ reduction)
-- ✅ SpecWeave: 5-pillar documentation
-- ✅ SpecWeave: Tool integration (JIRA/ADO/GitHub)
-- ✅ SpecWeave: Diagram generation
+- ✅ SpecWeave: **5-pillar documentation** - strategy, architecture, delivery, operations, governance
+- ✅ SpecWeave: **Pre-installed components** - 10 agents + 35+ skills ready immediately
+- ✅ SpecWeave: **Framework agnostic** - TypeScript, Python, Go, Rust, Java, C#
+- ✅ SpecWeave: **Diagram generation** - C4 Model diagrams with validation
+- ✅ SpecWeave: **Tool integration** - JIRA/ADO/GitHub sync built-in
+
+**Both frameworks**:
+- ✅ Specification-first development
+- ✅ Automated testing
+- ✅ Quality gates and validation
 
-**See skills**:
-- `bmad-method-expert` - Dynamic gap analysis vs BMAD
-- `spec-kit-expert` - Dynamic gap analysis vs spec-kit
+**Learn more**: See `bmad-method-expert` and `spec-kit-expert` skills for detailed comparisons
 
 ---
 
 ## 📞 Support & Community
 
-- **GitHub**: [github.com/specweave/specweave](https://github.com/specweave/specweave)
-- **Issues**: [github.com/specweave/specweave/issues](https://github.com/specweave/specweave/issues)
-- **Discussions**: [github.com/specweave/specweave/discussions](https://github.com/specweave/specweave/discussions)
-- **Documentation**: [CLAUDE.md](CLAUDE.md)
+- **Website**: [spec-weave.com](https://spec-weave.com)
+- **npm Package**: [npmjs.com/package/specweave](https://www.npmjs.com/package/specweave)
+- **GitHub**: [github.com/anton-abyzov/specweave](https://github.com/anton-abyzov/specweave)
+- **Issues**: [github.com/anton-abyzov/specweave/issues](https://github.com/anton-abyzov/specweave/issues)
+- **Documentation**: See [CLAUDE.md](CLAUDE.md) after running `specweave init`
 
 ---
 
@@ -682,4 +616,4 @@ SpecWeave is inspired by and learns from:
 
 **SpecWeave** - Replace vibe coding with spec-driven development.
 
-**Get started**: See [INSTALLATION.md](INSTALLATION.md) | [CLAUDE.md](CLAUDE.md)
+**Get started**: [spec-weave.com](https://spec-weave.com) | [npm install](https://www.npmjs.com/package/specweave) | [GitHub](https://github.com/anton-abyzov/specweave)