specweave 0.1.4 → 0.1.6

package/src/commands/init.md

@@ -0,0 +1,123 @@
+---
+description: 🔥 Shorthand for /create-project - Initialize SpecWeave project (Alias)
+---
+
+# Initialize Project (Short Alias)
+
+**⚡ Quick Alias**: This is a shorthand command for `/create-project`.
+
+Use this when you want to quickly initialize a new SpecWeave project without typing the full command name.
+
+---
+
+## Full Command
+
+For complete documentation, see `/create-project`.
+
+This alias provides the exact same functionality as the full command.
+
+---
+
+## Usage
+
+```bash
+/init [project-name] [--type=<stack>]
+```
+
+**Examples**:
+```bash
+/init                           # Interactive prompts
+/init my-saas                   # Auto-detect tech stack
+/init my-api --type=python      # Specify Python
+/init my-app --type=nextjs      # Specify Next.js
+```
+
+---
+
+## What This Does
+
+1. **Creates directory structure**:
+   ```
+   my-project/
+   ├── .specweave/
+   │   ├── config.yaml
+   │   ├── docs/
+   │   ├── increments/
+   │   └── tests/
+   ├── .claude/
+   │   ├── commands/
+   │   ├── skills/      # Auto-install on demand
+   │   └── agents/      # Auto-install on demand
+   ├── CLAUDE.md
+   └── README.md
+   ```
+
+2. **Detects tech stack** (or uses `--type` flag):
+   - TypeScript/JavaScript → Next.js, Node.js, React
+   - Python → FastAPI, Django, Flask
+   - Go → Gin, Echo, standard library
+   - .NET → ASP.NET Core
+   - Java → Spring Boot
+
+3. **Auto-installs components** based on your first request:
+   ```
+   User: "Create Next.js authentication"
+
+   📦 Installing required components...
+      ✅ nextjs skill
+      ✅ nodejs-backend skill
+      ✅ security agent
+      ✅ pm agent
+   ```
+
+4. **Initializes git** (if git available)
+
+5. **Shows next steps**
+
+---
+
+## Tech Stack Detection
+
+**Auto-detected from**:
+- `package.json` (JavaScript/TypeScript)
+- `requirements.txt`, `pyproject.toml` (Python)
+- `go.mod` (Go)
+- `*.csproj` (.NET)
+- `pom.xml`, `build.gradle` (Java)
+
+**Manual specification**:
+```bash
+/init --type=nextjs      # Next.js + TypeScript
+/init --type=python      # Python (FastAPI default)
+/init --type=django      # Django specifically
+/init --type=dotnet      # ASP.NET Core
+```
+
+---
+
+## After Initialization
+
+**Start building immediately**:
+```bash
+cd my-project
+/ci "User authentication"    # Create first increment
+```
+
+SpecWeave will:
+1. Detect you need auth components
+2. Auto-install: `security` agent, `nodejs-backend` skill
+3. Generate specs, plan, tasks
+4. Ready to implement!
+
+---
+
+## Other Useful Aliases
+
+- `/ci` - Create increment (shorthand for `/create-increment`)
+- `/si` - Start increment (shorthand for `/start-increment`)
+- `/vi` - Validate increment (shorthand for `/validate-increment`)
+- `/ls` - List increments (shorthand for `/list-increments`)
+
+---
+
+**💡 Tip**: No need to pre-install components - they install on-demand!

package/src/commands/ls.md

@@ -0,0 +1,100 @@
+---
+description: 🔥 Shorthand for /list-increments - List all increments (Alias)
+---
+
+# List Increments (Short Alias)
+
+**⚡ Quick Alias**: This is a shorthand command for `/list-increments`.
+
+Use this when you want to quickly list increments without typing the full command name.
+
+---
+
+## Full Command
+
+For complete documentation, see `/list-increments`.
+
+This alias provides the exact same functionality as the full command.
+
+---
+
+## Usage
+
+```bash
+/ls [--status=<status>] [--format=<format>]
+```
+
+**Examples**:
+```bash
+/ls                          # All increments
+/ls --status=in-progress     # Only in-progress
+/ls --status=planned         # Only planned
+/ls --format=detailed        # Detailed view
+```
+
+---
+
+## What This Shows
+
+**Default View** (Summary):
+```
+📋 SpecWeave Increments
+
+Status: in-progress (2) | planned (3) | completed (5) | closed (4)
+
+In Progress:
+  0012-user-authentication     [████████░░] 80% (8/10 tasks)
+  0013-payment-integration     [███░░░░░░░] 30% (3/10 tasks)
+
+Planned:
+  0014-admin-dashboard         [░░░░░░░░░░]  0% (0/15 tasks)
+  0015-analytics-module        [░░░░░░░░░░]  0% (0/12 tasks)
+```
+
+**Detailed View** (`--format=detailed`):
+Shows full spec summary, architecture approach, test coverage, etc.
+
+---
+
+## Status Filters
+
+| Status | Description | Alias |
+|--------|-------------|-------|
+| `backlog` | Not yet planned | Ideas, proposals |
+| `planned` | Spec created, not started | Ready to work |
+| `in-progress` | Active work | Currently implementing |
+| `completed` | Tasks done, ready to close | Awaiting review/merge |
+| `closed` | Finished and archived | Done |
+
+---
+
+## Typical Usage
+
+**Quick check**:
+```bash
+/ls --status=in-progress     # What am I working on?
+```
+
+**Planning**:
+```bash
+/ls --status=planned         # What's next?
+```
+
+**Review**:
+```bash
+/ls --format=detailed        # Full increment overview
+```
+
+---
+
+## 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`)
+- `/at` - Add tasks (shorthand for `/add-tasks`)
+
+---
+
+**💡 Tip**: Use `/ls` daily to track progress across all increments.

package/src/commands/si.md

@@ -0,0 +1,83 @@
+---
+description: 🔥 Shorthand for /start-increment - Start working on increment (Alias)
+---
+
+# Start Increment (Short Alias)
+
+**⚡ Quick Alias**: This is a shorthand command for `/start-increment`.
+
+Use this when you want to quickly start working on an increment without typing the full command name.
+
+---
+
+## Full Command
+
+For complete documentation, see `/start-increment`.
+
+This alias provides the exact same functionality as the full command.
+
+---
+
+## Usage
+
+```bash
+/si <increment-id>
+```
+
+**Examples**:
+```bash
+/si 0001
+/si 0042
+/si 0123
+```
+
+---
+
+## What This Does
+
+1. **Updates status** to `in-progress` in `tasks.md`
+2. **Loads context** via context-manifest.yaml
+3. **Creates feature branch** (if git workflow enabled)
+4. **Shows increment summary**:
+   - Spec highlights (user stories, goals)
+   - Architecture approach
+   - Task breakdown
+   - Test strategy
+
+---
+
+## Typical Workflow
+
+```bash
+# 1. Create increment
+/ci "User authentication"
+
+# 2. Review generated specs
+# ... check spec.md, plan.md, tasks.md ...
+
+# 3. Start working
+/si 0001
+
+# 4. Implement tasks
+# ... write code, tests, docs ...
+
+# 5. Validate quality
+/vi 0001 --quality
+
+# 6. Close when done
+/done 0001
+```
+
+---
+
+## Other Useful Aliases
+
+- `/ci` - Create increment (shorthand for `/create-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**: Always validate (`/vi`) before starting to catch spec issues early.

package/src/commands/vi.md

@@ -0,0 +1,89 @@
+---
+description: 🔥 Shorthand for /validate-increment - Validate increment quality (Alias)
+---
+
+# Validate Increment (Short Alias)
+
+**⚡ Quick Alias**: This is a shorthand command for `/validate-increment`.
+
+Use this when you want to quickly validate an increment without typing the full command name.
+
+---
+
+## Full Command
+
+For complete documentation, see `/validate-increment`.
+
+This alias provides the exact same functionality as the full command.
+
+---
+
+## Usage
+
+```bash
+/vi [increment-id] [--quality]
+```
+
+**Examples**:
+```bash
+/vi 0001                    # Rule-based validation only
+/vi 0001 --quality          # Rule-based + LLM quality assessment
+/vi                         # Validate current increment
+```
+
+---
+
+## What This Does
+
+**Rule-Based Validation** (Always runs):
+- ✅ 120 validation rules across 4 categories
+- ✅ Consistency checks (Spec ↔ Plan ↔ Tasks alignment)
+- ✅ Completeness checks (All required sections present)
+- ✅ Quality checks (Technology-agnostic, testable criteria)
+- ✅ Traceability checks (TC-0001 → tests.md coverage)
+
+**LLM Quality Assessment** (With `--quality` flag):
+- ✅ 6-dimension scoring (Clarity, Testability, Completeness, etc.)
+- ✅ Actionable suggestions with examples
+- ✅ Overall quality score (0-100)
+- ✅ Issue severity ranking (major, minor)
+
+---
+
+## Validation Results
+
+**Rule-Based Output**:
+```
+✅ Validation Results: 118/120 rules passed (98%)
+
+Issues Found:
+⚠️ [CONSISTENCY-012] Missing test case coverage for US-B003
+⚠️ [QUALITY-008] Acceptance criteria not testable in spec.md:45
+```
+
+**Quality Assessment Output** (with `--quality`):
+```
+🔍 Quality Score: 87/100 (GOOD)
+
+Dimension Scores:
+  • Clarity:         92/100 ✓✓
+  • Testability:     78/100 ✓  (Needs improvement)
+  • Completeness:    90/100 ✓✓
+  • Feasibility:     88/100 ✓✓
+
+Issues: 2 major, 1 minor
+Suggestions: 3 high priority improvements
+```
+
+---
+
+## Other Useful Aliases
+
+- `/ci` - Create increment (shorthand for `/create-increment`)
+- `/si` - Start increment (shorthand for `/start-increment`)
+- `/done` - Close increment (shorthand for `/close-increment`)
+- `/ls` - List increments (shorthand for `/list-increments`)
+
+---
+
+**💡 Tip**: Use `/vi` for quick checks, `/vi --quality` before implementation.