specweave 0.1.7 → 0.1.9

package/README.md

@@ -3,7 +3,7 @@
 > **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.6-blue.svg)](https://github.com/anton-abyzov/specweave/releases/tag/v0.1.6)
+[![Version](https://img.shields.io/badge/version-0.1.9-blue.svg)](https://github.com/anton-abyzov/specweave/releases/tag/v0.1.9)
 [![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)
 
@@ -115,17 +115,18 @@ cd my-app
 
 # Open Claude Code and use slash commands:
 
-User: /pi "Next.js authentication with email and OAuth"
+User: /inc "Next.js authentication with email and OAuth"
     ↓
-SpecWeave: 🔷 SpecWeave Active (/create-increment)
+SpecWeave: 🔷 SpecWeave Active (/increment)
 
            🚀 Creating increment 0001-user-authentication...
            📝 Using nextjs skill (already installed!)
            🤖 PM agent creating requirements...
            🏗️  Architect agent designing system...
+           📋 Auto-generating tasks from plan...
 
 ✅ Increment created: .specweave/increments/0001-user-authentication/
-✅ Files: spec.md, plan.md, tasks.md, tests.md
+✅ Files: spec.md, plan.md, tasks.md (auto-generated!), tests.md
 
 User: "Create C4 context diagram for authentication"  # Regular conversation for implementation
     ↓
@@ -146,14 +147,21 @@ User: /done 0001  # Close increment with slash command
 ✅ Increment 0001 closed successfully
 ```
 
-**How it works**:
+**How it works** (smart append-only workflow: 0001 → 0002 → 0003):
 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.
+2. **Use `/inc "feature"`** → PM creates specs + plan + auto-generates tasks
+   - **Smart**: Auto-closes previous increment if PM gates pass
+3. **Use `/build` or `/build 0001`** → Execute implementation (hooks after EVERY task)
+   - **Smart**: Auto-resumes from next incomplete task
+4. **Use `/progress`** → Check status, task completion %, next action
+5. **Use `/validate 0001`** → Optional quality check (LLM-as-judge)
+6. Repeat: `/inc "next feature"` → Auto-closes if ready, creates next increment
+
+**Why smart workflow?**
+- ✅ No manual `/done` needed (auto-closes on next `/inc`)
+- ✅ No task tracking needed (`/build` auto-resumes)
+- ✅ `/progress` shows exactly where you are
+- ✅ Natural flow: finish → start next
 
 ---
 
@@ -184,7 +192,7 @@ 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
+- **increment-planner** - Plan features via `/inc` or `/increment` command
 - **skill-router** - Route requests to appropriate skills
 - **context-loader** - Load relevant specifications
 - **role-orchestrator** - Coordinate multiple agents
@@ -295,23 +303,33 @@ specweave/
 # Option A: Comprehensive (Enterprise) - 500-600+ pages upfront
 # Option B: Incremental (Startup) - Build as you go
 
-# 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 regular conversation (no slash command needed)
-"Implement user authentication based on plan.md"
-# Claude implements based on specifications
-
-# 4. Generate diagrams (regular conversation)
-"Create C4 context diagram for authentication"
-
-# 5. Close increment with slash command
-/done 0001
-
-# 6. Sync with tools (optional)
+# 2. Plan increment (PM-led, auto-closes previous if ready)
+/inc "user authentication"
+# Alias for /increment
+# PM-led: Market research → spec.md → plan.md → auto-generate tasks.md
+# Smart: Auto-closes previous increment if PM gates pass
+
+# 3. Build it (smart resume, hooks after EVERY task)
+/build
+# Or: /build 0001
+# Smart: Auto-resumes from next incomplete task
+# Hooks automatically update CLAUDE.md, README.md, CHANGELOG.md
+
+# 4. Check progress anytime
+/progress
+# Shows: task completion %, PM gates status, next action
+# No increment ID needed - finds active increment automatically
+
+# 5. Validate quality (optional)
+/validate 0001 --quality
+# LLM-as-judge quality assessment
+
+# 6. Start next feature (auto-closes previous)
+/inc "payment processing"
+# Auto-closes 0001 if gates pass, creates 0002
+# No manual /done needed!
+
+# 7. Sync with tools (optional)
 /sync-github  # Sync to GitHub issues
 ```
 
@@ -480,19 +498,19 @@ npm test
 
 ## 🏷️ Project Status
 
-**Version**: 0.1.6
+**Version**: 0.1.8
 **Status**: Public Beta
 **License**: MIT
 **Release Date**: 2025-10-28
 **Website**: [spec-weave.com](https://spec-weave.com)
 
-### ✅ What Works (v0.1.6)
+### ✅ What Works (v0.1.8)
 
 - ✅ **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!)
+- ✅ **Command simplification** - 4-command workflow (0.1.8)
 - ✅ **Diagram generation** (C4 Model with validation)
 - ✅ **4-level testing framework** (spec → feature → component → automated)
 - ✅ **JIRA/ADO/GitHub sync** integration

package/SPECWEAVE.md

@@ -21,50 +21,83 @@ This file contains quick reference for developing with SpecWeave:
 
 SpecWeave follows the **spec-kit approach**: You MUST use slash commands explicitly.
 
-**To use SpecWeave**: Type a slash command (e.g., `/pi "Feature description"`)
+**To use SpecWeave**: Type a slash command (e.g., `/inc "Feature description"`)
 
 ### Quick Command Reference
 
+**Core Workflow** (Smart Commands):
+
 | Alias | Full Command | Purpose | Example |
 |-------|--------------|---------|---------|
-| `/init` | `/create-project` | Initialize SpecWeave project | `/init my-saas` |
-| `/pi` | `/create-increment` | **Plan Product Increment** | `/pi "User auth"` |
-| `/si` | `/start-increment` | Start working on increment | `/si 0001` |
-| `/at` | `/add-tasks` | Add tasks to increment | `/at 0001 "Add tests"` |
-| `/vi` | `/validate-increment` | Validate increment quality | `/vi 0001 --quality` |
-| `/done` | `/close-increment` | Close increment | `/done 0001` |
-| `/ls` | `/list-increments` | List all increments | `/ls` |
-
-**Why Slash Commands?**
-- ✅ **100% reliable** - Always works, no guessing
-- ✅ **Clear intent** - You know exactly when SpecWeave is active
-- ✅ **Fast** - Short aliases like `/pi` save keystrokes
-- ✅ **Memorable** - Domain-specific names (PI = Product Increment from Agile/SAFe)
-
-### Typical Workflow
+| `/inc` | `/increment` | **Plan Increment** (PM-led, auto-closes previous) | `/inc "User auth"` |
+| - | `/build` | Execute (smart resume, hooks after every task) | `/build` or `/build 0001` |
+| - | `/progress` | **Show status** (task %, PM gates, next action) | `/progress` |
+| - | `/validate` | Validate quality (optional LLM judge) | `/validate 0001 --quality` |
+| `/done` | `/done` | Close explicitly (optional, /inc auto-closes) | `/done 0001` |
+
+**Supporting Commands**:
+- `/create-project` - Initialize SpecWeave project
+- `/list-increments` - List all increments
+- `/review-docs` - Review docs vs code
+- `/generate-docs` - Generate doc site
+- `/sync-github` - Sync to GitHub
+
+**Smart Workflow Features**:
+- ✅ `/inc` suggests options if previous incomplete (never forces closure)
+- ✅ `/inc` auto-closes previous only if PM gates pass (seamless happy path)
+- ✅ `/build` auto-resumes from next incomplete task
+- ✅ `/progress` shows exactly where you are
+- ✅ `/done` is optional (use when explicit closure needed)
+- ✅ Natural flow: finish → start next (with user control)
+
+### Typical Workflow (Smart & Natural)
 
 ```bash
 # 1. Initialize project
 npx specweave init my-saas
 
-# 2. Plan your first increment (use slash command!)
-/pi "User authentication with JWT and RBAC"
+# 2. Plan your first increment
+/inc "User authentication with JWT and RBAC"
+# PM-led: market research → spec → plan → auto-generate tasks
+
+# 3. Review generated docs
+#    spec.md, plan.md, tasks.md (auto-generated!), tests.md
+
+# 4. Build it (smart resume, hooks after EVERY task)
+/build
+# Auto-resumes from next incomplete task
+# No need to track which task you're on!
+
+# 5. Check progress anytime
+/progress
+# Shows: 5/12 tasks (42%), next: T006, PM gates status
+
+# 6. Continue building
+/build
+# Picks up where you left off
 
-# 3. Validate
-/vi 0001 --quality
+# 7. Validate quality (optional)
+/validate 0001 --quality
 
-# 4. Start working
-/si 0001
+# 8. Start next feature (auto-closes previous!)
+/inc "Payment processing"
+# Smart: Auto-closes 0001 if PM gates pass
+# No manual /done needed!
 
-# 5. Implement (regular conversation, no slash commands needed here)
-User: "Let's implement the backend API"
-Claude: [implements based on plan.md and tasks.md]
+# 9. Keep building
+/build
+# Auto-finds active increment 0002
 
-# 6. Close when done
-/done 0001
+# Repeat: /inc → /build → /progress → /inc (auto-closes) → /build...
 ```
 
-**Remember**: Type `/pi` first, THEN implement! Otherwise you lose all SpecWeave benefits (specs, architecture, test strategy).
+**Key Insight**: Natural flow without administrative overhead!
+- No manual tracking (`/build` auto-resumes)
+- No manual closure (`/inc` auto-closes if ready)
+- Check progress anytime (`/progress`)
+- Focus on building, not project management
+
+**Remember**: Type `/inc` first, THEN build! Otherwise you lose all SpecWeave benefits (specs, architecture, auto-generated tasks, test strategy).
 
 ---
 
@@ -193,25 +226,30 @@ npx specweave list --installed      # See what's installed
 
 **CRITICAL**: SpecWeave uses **EXPLICIT SLASH COMMANDS** - type them to activate the framework!
 
+### Core Workflow (Smart Commands)
+
 | Command | Alias | Purpose | Example |
 |---------|-------|---------|---------|
-| `/create-project` | `/init` | Bootstrap new SpecWeave project | `/init my-saas --type python` |
-| `/create-increment` | `/pi` | **Plan Product Increment** (create new feature) | `/pi "user authentication"` |
-| `/start-increment` | `/si` | Start working on an increment | `/si 0001` |
-| `/add-tasks` | `/at` | Add tasks to existing increment | `/at 0001 "implement login"` |
-| `/validate-increment` | `/vi` | Validate with rule-based + optional AI quality | `/vi 0001 --quality` |
-| `/close-increment` | `/done` | Close increment with leftover transfer | `/done 0001` |
-| `/list-increments` | `/ls` | List all increments with status | `/ls --status=in-progress` |
-| `/review-docs` | - | Review strategic docs vs code | `/review-docs --increment=0003` |
-| `/generate-docs` | - | Generate documentation site | `/generate-docs` |
-| `/sync-github` | - | Sync increment to GitHub issues | `/sync-github` |
-
+| `/increment` | `/inc` | Plan Increment (PM-led, auto-closes previous if ready) | `/inc "user authentication"` |
+| `/build` | - | Execute (smart resume from next incomplete task) | `/build` or `/build 0001` |
+| `/progress` | - | Show status (task %, PM gates, next action) | `/progress` |
+| `/validate` | - | Validate quality (optional LLM judge) | `/validate 0001 --quality` |
+| `/done` | - | Close explicitly (optional, /inc auto-closes) | `/done 0001` |
+
+**Smart Features**:
+- `/inc` suggests options if previous incomplete, auto-closes if PM gates pass
+- `/build` auto-resumes from next incomplete task (no task ID needed)
+- `/progress` auto-finds active increment (no ID needed)
+- `/done` optional in happy path (use for explicit closure only)
+
+### Supporting Commands
+
+| Command | Purpose | Example |
+|---------|---------|---------|
+| `/create-project` | Bootstrap new SpecWeave project | `/create-project --type python` |
+| `/list-increments` | List all increments with status | `/list-increments` |
 **All commands are framework-agnostic** (adapt to detected tech stack)
 
-**💡 Pro Tip**: Use short aliases (`/pi`, `/vi`, `/si`, `/done`, `/ls`, `/at`, `/init`) for speed during active development!
-- **PI** = Product Increment (standard Agile terminology)
-- **Why explicit?** Auto-activation doesn't work reliably - slash commands ensure SpecWeave ALWAYS activates
-
 **See**: [Command Reference](.claude/commands/) for all available commands
 
 ---
@@ -246,7 +284,7 @@ npx specweave list --installed      # See what's installed
 | Skill | Purpose | Activates When |
 |-------|---------|----------------|
 | `specweave-detector` | Slash command documentation | User asks about SpecWeave commands |
-| `increment-planner` | Plan features with context | `/pi` or `/create-increment` command |
+| `increment-planner` | Plan features with context | `/inc` or `/increment` command |
 | `skill-router` | Route to appropriate skills | Ambiguous requests |
 | `context-loader` | Load context selectively | Working on increments |
 | `diagrams-generator` | Coordinate diagram creation | "create diagram", "draw diagram", C4, sequence, ER |
@@ -302,17 +340,12 @@ backlog → planned → in-progress → completed → closed
 
 **Naming Convention**: 4-digit format (0001-9999), e.g., `0001-feature-name`, `0042-user-auth`, `0123-payment-flow`
 
-**Commands** (MUST USE SLASH COMMANDS!):
+**Commands**:
 ```bash
-# Use short aliases (recommended)
-/pi "feature name"                    # Create new increment (auto-numbered, e.g., 0003-feature-name)
-/at 0001 "task description"           # Add tasks to existing
-/done 0001                             # Close with leftover transfer
-
-# Or full commands
-/create-increment "feature name"      # Same as /pi
-/add-tasks 0001 "task description"    # Same as /at
-/close-increment 0001                 # Same as /done
+/inc "feature name"                    # Plan increment (PM-led, auto-generates tasks)
+/build 0001                            # Execute implementation (hooks after EVERY task)
+/validate 0001 --quality               # Validate quality (optional)
+/done 0001                             # Close increment (PM validates 3 gates)
 ```
 
 **See**: [Increment Lifecycle Guide](.specweave/docs/internal/delivery/guides/increment-lifecycle.md) for complete lifecycle management
@@ -685,24 +718,25 @@ Attempt 2/3: Refining with feedback...
 
 **Quick Start**:
 
-**CRITICAL**: SpecWeave uses **EXPLICIT SLASH COMMANDS** - type `/pi` to activate!
+**CRITICAL**: SpecWeave uses **EXPLICIT SLASH COMMANDS** - type `/inc` to activate!
 
 ```bash
 # Initialize project
 npx specweave init my-project
 
-# Create your first feature (use slash command!)
-/pi "feature description"
+# Plan your first increment (use slash command!)
+/inc "feature description"
 
-# Typical workflow
-1. /pi "feature" → SpecWeave creates specs
-2. Regular conversation → Claude implements code
-3. /done 0001 → Close increment
+# Typical workflow (append-only increments: 0001 → 0002 → 0003)
+1. /inc "feature" → PM creates specs + plan + auto-generates tasks
+2. /build 0001 → Execute implementation (hooks after EVERY task)
+3. /validate 0001 --quality → Optional quality check
+4. /done 0001 → PM validates 3 gates (tasks ✅ + tests ✅ + docs ✅)
 ```
 
-**Remember**: Type `/pi` first, THEN implement! Otherwise you lose all SpecWeave benefits (specs, architecture, test strategy).
+**Remember**: Type `/inc` first to plan, THEN `/build` to implement! Otherwise you lose all SpecWeave benefits (specs, architecture, test strategy).
 
-**Need help?**: Type `/pi` to see examples, or ask about specific workflows.
+**Need help?**: Type `/inc` to see examples, or ask about specific workflows.
 
 **SpecWeave Documentation**: https://spec-weave.com
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "specweave",
-  "version": "0.1.7",
-  "description": "Spec-Driven Development framework with AI-powered autonomous agents for building SaaS applications",
+  "version": "0.1.9",
+  "description": "Replace vibe coding with spec-driven development. Smart workflow: /inc auto-closes previous, /build auto-resumes, /progress shows status. PM-led planning, 10 agents, 35+ skills. spec-weave.com",
   "main": "dist/index.js",
   "bin": {
     "specweave": "./bin/specweave.js"