codecruise 0.1.0

package/config/commands/init.md

@@ -0,0 +1,128 @@
+---
+name: init
+description: Initialize or enhance a project with smart detection
+model: sonnet
+tools: Read, Write, Bash, Glob, Grep
+---
+
+# /init — Project Wizard
+
+Initialize new projects or enhance existing ones with smart detection.
+
+## Philosophy
+
+```
+Detect → Guide → Execute → Next Step
+```
+
+## Scenario Detection
+
+| Scenario | Detection | Action |
+|----------|-----------|--------|
+| 1. Full Setup | CLAUDE.md + roadmap + progress | Resume from current TODO |
+| 2. Docs Only | PRD/requirements, no code | Create structure, `/ingest` |
+| 3. Code Only | Code exists, no CLAUDE.md | Analyze, create CLAUDE.md |
+| 4. Empty | Nothing | Full wizard |
+
+## Process
+
+1. **Detect**: Check for CLAUDE.md, progress.yaml, roadmap/, code
+2. **Assess Quality** (if exists): Score 0-100
+3. **Present Findings**: Show what's missing
+4. **Gather Info** (if new): Project name, domain, stack, quality_command
+5. **Create/Enhance**: Apply templates
+6. **Verify Git**: Warn uncommitted changes
+7. **Speed Check**: Measure quality_command, warn if slow
+
+## Quality Scoring
+
+| Element | Points |
+|---------|--------|
+| Has subfeatures | +20 |
+| Has dependencies | +20 |
+| Has file mappings | +20 |
+| Has rich descriptions | +15 |
+| Has status tracking | +15 |
+| Has spec references | +10 |
+
+**70-100**: Strong → Add execution_state only
+**30-69**: Weak → Suggest improvements
+**0-29**: Minimal → Provide full defaults
+
+## Files Created
+
+**New Project**:
+```
+CLAUDE.md                       # Claude Code requirement (root, <100 lines)
+.claude/
+└── settings.json               # Claude Code project settings
+.codecruise/                    # ALL CodeCruise artifacts
+├── progress.yaml               # Execution state
+├── steering/
+│   ├── product.md              # What we're building
+│   ├── tech.md                 # Tech stack & tools
+│   └── structure.md            # Architecture & conventions
+├── canon/                      # Created by /spec-forge
+├── context/                    # Created by /spec-forge
+├── roadmap/
+│   ├── README.md
+│   └── phase-01.yaml
+├── metrics/                    # OODA events (created by /run)
+└── cache/                      # Temp files
+```
+
+**Enhanced Project**: Only adds missing pieces
+
+**Minimal Mode** (`--minimal`): CLAUDE.md + .codecruise/progress.yaml only
+
+## Wizard Chaining
+
+```
+/init → /ingest (if docs) → /plan (if requirements) → /run
+```
+
+User only needs `/init`. System guides from there.
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `--minimal` | Only CLAUDE.md + progress.yaml |
+| `--full` | Include RFC/ADR templates |
+| `--assess` | Show assessment, don't modify |
+| `--upgrade` | Force improvement suggestions |
+| `--upgrade-schema` | Migrate progress.yaml v1 → v2 |
+| `--no-steering` | Skip steering docs (product.md, tech.md, structure.md) |
+
+## Speed Check
+
+After detecting quality_command:
+- < 10s: ✅ Fast feedback loop
+- 10-30s: ⚠️ Consider Biome, oxlint, Bun
+- > 30s: 🐢 Strongly recommend faster tools
+
+## Domain Input
+
+Ask for domain expertise to prime CLAUDE.md:
+
+```
+Domain: fintech engineer
+Expertise: Multi-currency, decimal precision, PCI compliance
+```
+
+## Output
+
+```
+✓ Project initialized: {name}
+
+Created:
+├── CLAUDE.md
+├── progress.yaml
+├── roadmap/
+└── dashboard/
+
+Next:
+1. Edit roadmap/phase-01/phase.yaml
+2. /plan to generate TODOs
+3. /run to start execution
+```

package/config/commands/metrics.md

@@ -0,0 +1,87 @@
+---
+name: metrics
+description: View execution metrics and success rates
+model: haiku
+tools: Read, Bash
+---
+
+# /metrics — View Execution Metrics
+
+## Goal
+
+Display collected metrics about codecruise execution: success rates, activity counts, and trends.
+
+## Usage
+
+```bash
+/metrics              # Show summary
+/metrics --detailed   # Show detailed event log
+/metrics --reset      # Clear metrics and start fresh
+```
+
+## Behavior
+
+### 1. Read Metrics Summary
+
+Read `.codecruise/metrics/summary.json` and display:
+
+```
+╔════════════════════════════════════════════════════════════╗
+║                    CODECRUISE METRICS                       ║
+╠════════════════════════════════════════════════════════════╣
+║                                                              ║
+║  Tests                                                       ║
+║    Passes: 42    Fails: 3    Success Rate: 93.33%           ║
+║                                                              ║
+║  Lint                                                        ║
+║    Passes: 45    Fails: 0    Success Rate: 100%             ║
+║                                                              ║
+║  Activity                                                    ║
+║    Commits: 12   Tests Written: 15   Code Written: 28       ║
+║                                                              ║
+║  Last Updated: 2026-02-20T10:30:00Z                         ║
+║                                                              ║
+╚════════════════════════════════════════════════════════════╝
+```
+
+### 2. Detailed View (--detailed)
+
+Show recent events from `.codecruise/metrics/events.jsonl`:
+
+```
+Recent Events (last 20):
+────────────────────────────────────────────────
+10:30:15  test_pass     pnpm test
+10:29:45  code_written  src/auth/login.ts
+10:29:30  test_written  src/auth/login.test.ts
+10:28:00  lint_pass     pnpm lint
+10:27:30  commit        feat(auth): add login
+...
+```
+
+### 3. Reset (--reset)
+
+Clear all metrics:
+
+```bash
+rm -rf .codecruise/metrics/
+echo "Metrics cleared. Fresh start."
+```
+
+## No Metrics Found
+
+If `.codecruise/metrics/` doesn't exist:
+
+```
+No metrics collected yet.
+
+Metrics are collected automatically during /run execution.
+Start with: /run <scope>
+```
+
+## Implementation
+
+1. Check if metrics directory exists
+2. Read summary.json if present
+3. Format and display based on flags
+4. For --detailed, tail the events.jsonl file

package/config/commands/parallel.md

@@ -0,0 +1,320 @@
+---
+name: parallel
+description: Manage parallel execution with git worktrees
+model: sonnet
+tools: Read, Write, Bash, Glob
+---
+
+# /parallel — Parallel Execution Manager
+
+Manage parallel feature execution using git worktrees. Run multiple features simultaneously without file conflicts.
+
+## Why Worktrees?
+
+Git worktrees create separate working directories from the same repository:
+- Each worktree has its own branch
+- No file conflicts between parallel work
+- Independent Claude sessions per worktree
+- Easy merge when features complete
+
+## Usage
+
+```bash
+# Simple syntax (recommended)
+/parallel auth              # Create worktree for auth feature
+/parallel payments          # Create another worktree
+/parallel                   # Show status of all worktrees
+/parallel merge auth        # Merge auth back to main
+/parallel cleanup           # Remove finished worktrees
+
+# Also supports feature IDs
+/parallel 1.1               # Create worktree for feature-1.1
+/parallel merge 1.1         # Merge feature-1.1
+
+# Sync state (after merges)
+/parallel sync              # Pull main changes into worktrees
+```
+
+## Commands
+
+### `/parallel <feature>` (Create Worktree)
+
+Create a worktree for a single feature. Simple and focused.
+
+```bash
+/parallel auth              # Create worktree for 'auth'
+/parallel 1.1               # Create worktree for feature-1.1
+/parallel user-dashboard    # Create worktree for 'user-dashboard'
+```
+
+**Process:**
+
+1. **Resolve Feature**
+   - Find feature by name or ID in roadmap
+   - Get `file_scope` from feature definition
+
+2. **Check for Conflicts**
+   - If other worktrees exist, check for file scope overlap
+   - FAIL if patterns conflict with existing worktrees
+
+3. **Create Worktree**
+   ```bash
+   git worktree add ../project-auth -b feature/auth
+   ```
+
+4. **Setup Isolation**
+   - Copy `progress.yaml` with scope filtered to this feature
+   - Create `.claude/file_scope.txt` with owned patterns
+
+5. **Output**
+   ```
+   ╔══════════════════════════════════════════════════════════════╗
+   ║ ✓ Worktree created: auth                                      ║
+   ╠══════════════════════════════════════════════════════════════╣
+   ║                                                               ║
+   ║ Path: ../project-auth                                         ║
+   ║ Branch: feature/auth                                          ║
+   ║ Scope: src/auth/**, tests/auth/**                            ║
+   ║ TODOs: 12                                                     ║
+   ║                                                               ║
+   ║ To start:                                                     ║
+   ║   cd ../project-auth && claude "/run"                        ║
+   ║                                                               ║
+   ╚══════════════════════════════════════════════════════════════╝
+   ```
+
+### `/parallel <f1> <f2> <f3>` (Multiple Worktrees)
+
+Create multiple worktrees at once.
+
+```bash
+/parallel auth payments dashboard
+```
+
+**Output:**
+```
+✓ Created 3 worktrees:
+  ../project-auth       → cd ../project-auth && claude "/run"
+  ../project-payments   → cd ../project-payments && claude "/run"
+  ../project-dashboard  → cd ../project-dashboard && claude "/run"
+```
+
+### `/parallel` (Status)
+
+Show status of all parallel worktrees. Called without arguments.
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║ PARALLEL EXECUTION STATUS                                     ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                               ║
+║ Feature 1.1: Auth              Feature 1.2: Payments          ║
+║ ════════════════               ═══════════════════            ║
+║ Branch: feature/auth           Branch: feature/payments       ║
+║ Status: 🟢 Running             Status: 🟢 Running             ║
+║ Progress: ████████░░ 80%       Progress: ██████░░░░ 60%       ║
+║ TODOs: 10/12                   TODOs: 5/8                     ║
+║ Last commit: 5m ago            Last commit: 12m ago           ║
+║                                                               ║
+║ Feature 1.3: Dashboard                                        ║
+║ ═════════════════════                                         ║
+║ Status: 🟡 Blocked                                            ║
+║ Blocker: "Needs auth API types from feature-1.1"             ║
+║                                                               ║
+╠══════════════════════════════════════════════════════════════╣
+║ MERGE QUEUE                                                   ║
+║ ○ feature/auth (ready when 100%)                             ║
+║ ○ feature/payments (ready when 100%)                         ║
+║ ○ feature/dashboard (blocked by feature/auth)                ║
+╚══════════════════════════════════════════════════════════════╝
+```
+
+### `/parallel merge <feature>`
+
+Merge completed feature back to main branch.
+
+```bash
+/parallel merge auth        # Merge auth feature
+/parallel merge 1.1         # Merge by feature ID
+```
+
+**Process:**
+
+1. Check feature is 100% complete
+2. Run quality checks in worktree
+3. Create PR from worktree branch
+4. Merge PR
+5. Pull changes to main worktree
+6. Option to remove worktree
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║ MERGE: feature/auth                                           ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                               ║
+║ ✓ All TODOs complete (12/12)                                 ║
+║ ✓ Quality checks passing                                     ║
+║ ✓ No conflicts with main                                     ║
+║                                                               ║
+║ Ready to merge.                                               ║
+║                                                               ║
+║ [m] Merge to main                                            ║
+║ [p] Create PR only                                           ║
+║ [c] Cancel                                                   ║
+║                                                               ║
+╚══════════════════════════════════════════════════════════════╝
+```
+
+### `/parallel cleanup [feature]`
+
+Remove worktrees for completed/merged features.
+
+```bash
+/parallel cleanup           # Interactive - asks for each
+/parallel cleanup auth      # Remove specific worktree
+/parallel cleanup --all     # Remove all worktrees (careful!)
+```
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║ CLEANUP WORKTREES                                             ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                               ║
+║ ../project-auth                                               ║
+║   Status: Merged ✓                                           ║
+║   [r] Remove   [k] Keep                                      ║
+║                                                               ║
+║ ../project-payments                                           ║
+║   Status: In progress (60%)                                  ║
+║   [r] Remove   [k] Keep (recommended)                        ║
+║                                                               ║
+╚══════════════════════════════════════════════════════════════╝
+```
+
+### `/parallel sync`
+
+Sync state files across worktrees.
+
+```bash
+/parallel sync              # Sync progress.yaml updates
+/parallel sync --from main  # Pull main changes into worktrees
+```
+
+Useful when:
+- Dependencies between features resolved
+- Need to unblock waiting features
+- Main branch updated with fixes
+
+## File Scope
+
+Each worktree gets a `.claude/file_scope.txt`:
+
+```
+# This session can only edit files matching these patterns
+src/auth/**/*
+tests/auth/**/*
+packages/shared/auth/**/*
+```
+
+The `enforce-file-scope.sh` hook blocks edits outside this scope.
+
+### Defining Scope in Roadmap
+
+Features should define their file scope:
+
+```yaml
+# roadmap/phase-01/feature-1.1.yaml
+id: feature-1.1
+name: User Authentication
+file_scope:
+  - src/auth/**/*
+  - tests/auth/**/*
+  - packages/shared/auth/**/*
+subfeatures:
+  # ...
+```
+
+### Conflict Detection
+
+Before creating worktrees, `/parallel start` checks for overlaps:
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║ ❌ FILE SCOPE CONFLICT                                        ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                               ║
+║ Cannot run features in parallel - file scope overlap:        ║
+║                                                               ║
+║ Feature 1.1 (auth) and Feature 1.2 (api):                    ║
+║   Both claim: src/shared/types.ts                            ║
+║                                                               ║
+║ Options:                                                      ║
+║ 1. Run features sequentially                                 ║
+║ 2. Update file_scope in roadmap to remove overlap            ║
+║ 3. Create shared types as separate feature first             ║
+║                                                               ║
+╚══════════════════════════════════════════════════════════════╝
+```
+
+## State Management
+
+### Main Worktree State
+
+```yaml
+# progress.yaml (main worktree)
+parallel_execution:
+  active: true
+  started_at: 2026-02-19T10:00:00Z
+  worktrees:
+    - path: ../project-auth
+      branch: feature/auth
+      feature: feature-1.1
+      status: running
+      progress: 80
+    - path: ../project-payments
+      branch: feature/payments
+      feature: feature-1.2
+      status: running
+      progress: 60
+    - path: ../project-dashboard
+      branch: feature/dashboard
+      feature: feature-1.3
+      status: blocked
+      blocked_by: feature-1.1
+```
+
+### Feature Worktree State
+
+```yaml
+# progress.yaml (../project-auth)
+execution_state:
+  scope: feature-1.1
+  is_parallel_worktree: true
+  main_worktree: /path/to/main
+  file_scope:
+    - src/auth/**/*
+    - tests/auth/**/*
+```
+
+## Integration
+
+| Command | Integration |
+|---------|-------------|
+| `/status` | Shows parallel execution overview if active |
+| `/dashboard` | Shows parallel feature progress |
+| `/run` | Executes within worktree scope |
+| `/compact` | Works per-worktree |
+
+## Requirements
+
+- Git 2.17+ (worktree support)
+- Sufficient disk space for multiple worktrees
+- `file_scope` defined in feature YAML
+
+## Best Practices
+
+1. **Define scope early** - Add `file_scope` when planning features
+2. **No shared files** - If files must be shared, create them as separate feature first
+3. **Sync regularly** - Use `/parallel sync` to keep worktrees updated
+4. **Merge promptly** - Merge completed features to unblock dependencies
+5. **Clean up** - Remove merged worktrees to save disk space

package/config/commands/pause.md

@@ -0,0 +1,55 @@
+---
+name: pause
+description: Pause OODA loop at safe checkpoint
+model: haiku
+tools: Read, Write
+---
+
+# /pause
+
+Gracefully exit the OODA loop, preserving state for `/resume`.
+
+## Usage
+
+```bash
+/pause                    # After current TODO completes
+/pause --immediate        # Pause now (may leave TODO incomplete)
+/pause --reason "msg"     # Record reason for pause
+```
+
+## Behavior
+
+| Flag | When Pauses | TODO State |
+|------|-------------|------------|
+| (default) | After ACT completes | Done, clean |
+| `--immediate` | Immediately | In-progress, needs /retry |
+
+## State Saved
+
+Updates `progress.yaml`:
+```yaml
+execution_state:
+  status: paused
+  paused_at: {timestamp}
+  pause_reason: "{reason}"
+```
+
+## Output
+
+```
+⏸ PAUSED at todo-1.1b-004
+
+  Progress: 10/14 TODOs (71%)
+
+  Resume: /resume
+  Skip:   /skip
+```
+
+## OODA Integration
+
+See `/run` command for:
+- Full OODA loop documentation
+- State transitions
+- Checkpoint behavior
+
+Pause saves OODA state (confidence, patterns) for seamless resume.