specweave 0.1.5 → 0.1.7

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
 
 ---