specweave 0.1.6 → 0.1.8

package/src/templates/CLAUDE.md.template

@@ -6,17 +6,24 @@ This project uses **SpecWeave** - a specification-first AI development framework
 
 ---
 
-## 🔷 SpecWeave Auto-Routing
+## 🔷 Using SpecWeave with Slash Commands
 
-**MANDATORY**: This project has SpecWeave installed (`.specweave/` directory exists).
+**CRITICAL**: This project uses SpecWeave - **USE SLASH COMMANDS to activate the framework!**
 
-**Behavior**:
-1. ✅ All development requests route through `specweave-detector` skill
-2. ✅ Agents activate automatically based on task (PM, Architect, DevOps, etc.)
-3. ✅ Context loaded selectively via manifests (70%+ token reduction)
-4. ✅ Tech stack detected automatically
+SpecWeave uses **EXPLICIT SLASH COMMANDS** - no auto-activation, no proactive detection.
 
-**Rule**: When in doubt, route through SpecWeave.
+**How to use**:
+1. ✅ **Use `/pi "feature description"`** to create a new increment (Plan Product Increment)
+2. ✅ **Use `/si 0001`** to start working on an increment
+3. ✅ **Use `/done 0001`** to close an increment
+4. ✅ **Regular conversation** for implementation after planning
+
+**Why slash commands?**
+- Auto-activation doesn't work reliably in Claude Code
+- Explicit commands ensure SpecWeave ALWAYS activates when you want it
+- Short aliases (`/pi`, `/si`, `/done`) save keystrokes
+
+**See**: Full command list below in "Quick Commands" section
 
 ---
 
@@ -153,13 +160,23 @@ project-root/
 
 ---
 
-## Quick Commands
+## Quick Commands (SLASH COMMANDS - Use These!)
+
+**IMPORTANT**: SpecWeave uses **EXPLICIT SLASH COMMANDS**. Type these commands to activate the framework.
 
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `/create-increment` | Create new feature | `/create-increment "user auth"` |
-| `/review-docs` | Review docs vs code | `/review-docs --increment=003` |
-| `/sync-github` | Sync to GitHub issues | `/sync-github` |
+| Command | Alias | Purpose | Example |
+|---------|-------|---------|---------|
+| `/create-increment` | `/pi` | **Plan Product Increment** (create new feature) | `/pi "user auth"` |
+| `/start-increment` | `/si` | Start working on increment | `/si 0001` |
+| `/add-tasks` | `/at` | Add tasks to increment | `/at 0001 "add tests"` |
+| `/validate-increment` | `/vi` | Validate increment quality | `/vi 0001 --quality` |
+| `/close-increment` | `/done` | Close increment | `/done 0001` |
+| `/list-increments` | `/ls` | List all increments | `/ls` |
+| `/review-docs` | - | Review docs vs code | `/review-docs --increment=003` |
+| `/sync-github` | - | Sync to GitHub issues | `/sync-github` |
+
+**💡 Pro Tip**: Use short aliases (`/pi`, `/si`, `/done`) for speed!
+- **PI** = Product Increment (standard Agile terminology)
 
 **All commands adapt to your tech stack automatically**
 
@@ -167,9 +184,15 @@ project-root/
 
 ## Working with Increments
 
-### Create New Feature
+### Create New Feature (ALWAYS use slash command!)
+
+**CRITICAL**: Use `/pi` (or `/create-increment`) to create new features:
 
 ```bash
+# Short form (recommended)
+/pi "feature description"
+
+# Full form
 /create-increment "feature description"
 ```
 
@@ -181,6 +204,10 @@ project-root/
 - tests.md (Test strategy - QA Lead agent)
 - context-manifest.yaml (Selective loading)
 
+**Workflow**:
+1. Use `/pi "feature"` to plan → SpecWeave creates specs
+2. Then regular conversation to implement → Claude implements code
+
 ### Status Progression
 
 ```
@@ -223,8 +250,8 @@ backlog → planned → in-progress → completed → closed
 
 | Skill | Purpose | Activates When |
 |-------|---------|----------------|
-| `specweave-detector` | Auto-detect SpecWeave | Any request |
-| `increment-planner` | Plan increments/features | Creating increments/features |
+| `specweave-detector` | Slash command documentation | User asks about SpecWeave commands |
+| `increment-planner` | Plan increments/features | `/pi` or `/create-increment` command |
 | `context-loader` | Load context selectively | Working on increments |
 | `skill-router` | Route to appropriate skill | Ambiguous requests |
 
@@ -372,14 +399,27 @@ max_context_tokens: 10000
 
 ## Quick Start
 
+**CRITICAL**: SpecWeave uses **EXPLICIT SLASH COMMANDS** - type `/pi` to activate!
+
 **Create your first feature**:
 ```bash
+# Use short alias (recommended)
+/pi "your feature description"
+
+# Or full command
 /create-increment "your feature description"
 ```
 
-**Need help?**: Ask Claude to load the relevant guide, or ask about specific workflows.
+**Typical Workflow**:
+1. `/pi "feature"` → SpecWeave creates specs (spec.md, plan.md, tasks.md)
+2. Regular conversation → Claude implements the code
+3. `/done 0001` → Close increment when complete
+
+**Remember**: Type `/pi` first, THEN implement! Otherwise you lose all SpecWeave benefits.
+
+**Need help?**: Type `/pi` to see examples, or ask about specific workflows.
 
-**SpecWeave Documentation**: https://specweave.dev
+**SpecWeave Documentation**: https://spec-weave.com
 
 ---
 

package/src/commands/add-tasks.md

@@ -1,176 +0,0 @@
-# /add-tasks - Add Tasks to Existing Increment
-
-**Command**: `/add-tasks <increment-id> <description> [options]`
-
-**Purpose**: Add new tasks to an existing increment during implementation
-
-**Framework**: Framework-agnostic (works with all tech stacks)
-
----
-
-## Usage
-
-```bash
-/add-tasks 001 "Fix error handling in context-loader"
-/add-tasks 001 --priority P2 "Add caching to skill-router"
-/add-tasks 001 "Multiple task lines..." --estimate "3 days"
-```
-
-## Arguments
-
-- `<increment-id>` (required): Increment number (e.g., `001`, `002`)
-- `<description>` (required): Task description
-- `--priority` (optional): P1/P2/P3 (default: P2)
-- `--estimate` (optional): Time estimate (default: detected from description)
-
----
-
-## When to Use
-
-**Add as task** ✅ when:
-- Duration: Hours-Days
-- Components affected: 1 agent/skill
-- Discovered during implementation
-- Examples: Bug fixes, small enhancements, error handling
-
-**Create new increment** ❌ when:
-- Duration: Weeks+
-- Components affected: 2+ agents/skills
-- Major new feature
-- Use `/create-increment` instead
-
----
-
-## Workflow
-
-### Step 1: Validate Increment
-
-```
-Validating increment 001-core-framework...
-
-→ Status: in-progress ✅ (can add tasks)
-→ Current tasks: 50
-→ Completed: 44 (88%)
-```
-
-**If increment not valid**:
-```
-❌ Cannot add tasks
-
-Reason: Increment 001 status is "closed"
-
-Options:
-A) Create new increment (recommended)
-B) Reopen 001 (if justified)
-```
-
-### Step 2: Auto-Increment Task ID
-
-```
-→ Scanning tasks.md for highest task ID...
-→ Found: T050
-→ New task ID: T051
-```
-
-### Step 3: Add to tasks.md
-
-```markdown
-## Additional Tasks (Added During Implementation)
-
-### T051: Fix error handling in context-loader
-**Added**: 2025-10-26
-**Discovered**: During integration testing
-**Priority**: P1
-**Estimated**: 2 hours
-**Status**: [ ] Pending
-
-**Implementation**:
-- Check if manifest file exists before parsing
-- Return helpful error message with file path
-- Log warning to .specweave/increments/0001-core-framework/logs/errors.log
-
-**Acceptance Criteria**:
-- [ ] Handles missing manifest gracefully
-- [ ] Error message includes file path
-- [ ] No crash when manifest not found
-```
-
-### Step 4: Update Frontmatter
-
-Update `spec.md`:
-
-```yaml
----
-updated: 2025-10-26      # ← Current date
-total_tasks: 51          # ← Incremented
-completed_tasks: 44      # ← Unchanged
-completion_rate: 86      # ← Recalculated (44/51)
----
-```
-
-### Step 5: Confirm
-
-```
-✅ Task added successfully
-
-Summary:
-→ Task ID: T051
-→ Description: Fix error handling in context-loader
-→ Priority: P1
-→ Increment: 001-core-framework
-→ Total tasks: 51 (was 50)
-→ Completion rate: 86% (was 88%)
-
-File: .specweave/increments/0001-core-framework/tasks.md
-```
-
----
-
-## Examples
-
-### Example 1: Bug Fix
-
-```bash
-/add-tasks 001 "Fix null pointer in skill-router when no skills installed"
-
-# Result:
-→ Task T052: Fix null pointer in skill-router
-→ Priority: P1 (critical bug)
-→ Estimated: 1 hour
-```
-
-### Example 2: Enhancement
-
-```bash
-/add-tasks 001 --priority P2 "Add caching to context-loader for better performance"
-
-# Result:
-→ Task T053: Add caching to context-loader
-→ Priority: P2 (enhancement)
-→ Estimated: 1 day
-```
-
-### Example 3: Multiple Tasks
-
-```bash
-/add-tasks 001 "Add error handling, logging, and validation to hetzner-provisioner"
-
-# Result:
-→ Task T054: Add error handling to hetzner-provisioner
-→ Task T055: Add logging to hetzner-provisioner
-→ Task T056: Add validation to hetzner-provisioner
-→ Priority: P2 (improvements)
-```
-
----
-
-## Related Documentation
-
-- [CLAUDE.md](../../CLAUDE.md#adding-tasks-to-current-increment) - Task addition guide
-- [INCREMENT-LIFECYCLE-DESIGN.md](../../.specweave/increments/0001-core-framework/reports/INCREMENT-LIFECYCLE-DESIGN.md) - Lifecycle design
-
----
-
-**Command Type**: Task management
-**Framework Support**: All
-**Impact**: Adds tasks to existing increment, updates completion rate

package/src/commands/at.md

@@ -1,114 +0,0 @@
----
-description: 🔥 Shorthand for /add-tasks - Add tasks to increment (Alias)
----
-
-# Add Tasks (Short Alias)
-
-**⚡ Quick Alias**: This is a shorthand command for `/add-tasks`.
-
-Use this when you want to quickly add tasks to an increment without typing the full command name.
-
----
-
-## Full Command
-
-For complete documentation, see `/add-tasks`.
-
-This alias provides the exact same functionality as the full command.
-
----
-
-## Usage
-
-```bash
-/at <increment-id> <task-description>
-```
-
-**Examples**:
-```bash
-/at 0001 "Implement login endpoint"
-/at 0001 "Add password validation"
-/at 0001 "Write E2E tests for auth flow"
-```
-
----
-
-## What This Does
-
-1. **Analyzes task** against spec/plan
-2. **Determines priority** (P1, P2, P3)
-3. **Estimates effort** (based on complexity)
-4. **Identifies dependencies** (from existing tasks)
-5. **Adds to tasks.md** with proper formatting
-6. **Updates progress** percentage
-
----
-
-## Task Format
-
-Tasks are added with:
-- ✅ **Task ID** (auto-numbered: T001, T002, ...)
-- ✅ **Description** (clear, actionable)
-- ✅ **Priority** (P1/P2/P3)
-- ✅ **Estimated time** (based on analysis)
-- ✅ **Dependencies** (if any)
-- ✅ **Status** (Pending by default)
-
-**Example Output**:
-```markdown
-### T012: Implement login endpoint
-**Priority**: P1
-**Estimated**: 2 hours
-**Depends on**: T008
-**Status**: [ ] Pending
-
-**Implementation**:
-- Create POST /api/auth/login endpoint
-- Validate email and password
-- Return JWT token on success
-- Handle rate limiting
-```
-
----
-
-## Bulk Add
-
-You can add multiple tasks by calling the command multiple times or providing a list:
-
-```bash
-/at 0001 "Task 1"
-/at 0001 "Task 2"
-/at 0001 "Task 3"
-```
-
----
-
-## When to Add Tasks
-
-**During planning**:
-- Breaking down large features
-- After spec/plan review
-
-**During implementation**:
-- Discovered new requirements
-- Technical debt identified
-- Bug fixes needed
-
-**After review**:
-- Feedback from code review
-- QA findings
-- Security audit results
-
----
-
-## Other Useful Aliases
-
-- `/ci` - Create increment (shorthand for `/create-increment`)
-- `/si` - Start increment (shorthand for `/start-increment`)
-- `/vi` - Validate increment (shorthand for `/validate-increment`)
-- `/done` - Close increment (shorthand for `/close-increment`)
-- `/ls` - List increments (shorthand for `/list-increments`)
-
----
-
-**💡 Tip**: Add tasks as you discover them - don't wait until sprint planning!

package/src/commands/ci.md

@@ -1,63 +0,0 @@
----
-description: 🔥 Shorthand for /create-increment - Create new increment (Alias)
----
-
-# Create Increment (Short Alias)
-
-**⚡ Quick Alias**: This is a shorthand command for `/create-increment`.
-
-Use this when you want to quickly create a new SpecWeave increment without typing the full command name.
-
----
-
-## Full Command
-
-For complete documentation, see `/create-increment`.
-
-This alias provides the exact same functionality as the full command.
-
----
-
-## Usage
-
-```bash
-/ci "Feature name"
-```
-
-**Example**:
-```bash
-/ci "User authentication"
-/ci "Payment processing"
-/ci "Admin dashboard"
-```
-
----
-
-## What This Does
-
-1. **Auto-numbers** the increment (e.g., 0001, 0002, 0003...)
-2. **Creates folder** at `.specweave/increments/XXXX-feature-name/`
-3. **Generates files**:
-   - `spec.md` - WHAT & WHY (user stories, acceptance criteria)
-   - `plan.md` - HOW (architecture, implementation strategy)
-   - `tasks.md` - Implementation checklist
-   - `tests.md` - Test strategy and coverage matrix
-   - `context-manifest.yaml` - Context loading configuration
-4. **Invokes agents**:
-   - PM agent (requirements analysis)
-   - Architect agent (technical design)
-   - QA Lead agent (test strategy)
-
----
-
-## Other Useful Aliases
-
-- `/si` - Start increment (shorthand for `/start-increment`)
-- `/vi` - Validate increment (shorthand for `/validate-increment`)
-- `/done` - Close increment (shorthand for `/close-increment`)
-- `/ls` - List increments (shorthand for `/list-increments`)
-- `/at` - Add tasks (shorthand for `/add-tasks`)
-
----
-
-**💡 Tip**: Use `/ci` for speed, `/create-increment` for clarity in scripts.