codecruise 0.1.0

package/config/commands/sync.md

@@ -0,0 +1,131 @@
+---
+name: sync
+description: Rebuild .codecruise/progress.yaml from roadmap source of truth
+model: haiku
+tools: Read, Write, Glob, Grep
+---
+
+# /sync — State Synchronization
+
+Rebuild `.codecruise/progress.yaml` from `.codecruise/roadmap/*.yaml` source of truth.
+
+## When to Use
+
+| Situation | Use /sync? |
+|-----------|------------|
+| Manually edited roadmap files | ✅ Yes |
+| TODOs added/removed outside workflow | ✅ Yes |
+| .codecruise/progress.yaml corrupted | ✅ Yes |
+| Normal execution | ❌ Use /run |
+| Schema migration | ❌ Use /init --upgrade-schema |
+
+## Usage
+
+```bash
+/sync                    # Rebuild queues from roadmap
+/sync --dry-run          # Preview changes without writing
+/sync --reset            # Full reset (clear completed, start fresh)
+/sync --preserve-stats   # Keep session stats, rebuild queues only
+```
+
+## What It Does
+
+1. **Scan Roadmap**: Read all `.codecruise/roadmap/*.yaml` files
+2. **Extract TODOs**: Build complete TODO list with dependencies
+3. **Topological Sort**: Order by dependencies
+4. **Rebuild Queues**:
+   - `pending`: All TODOs not marked done/skipped
+   - `completed`: TODOs with status=done
+   - `skipped`: TODOs with status=skipped
+   - `failed`: Clear (requires fresh attempt)
+5. **Validate**: Check for orphans, circular deps
+6. **Write**: Update .codecruise/progress.yaml
+
+## Preservation Rules
+
+| Field | Default | With --reset |
+|-------|---------|--------------|
+| `queue.completed` | Preserve | Clear |
+| `queue.pending` | Rebuild | Rebuild |
+| `queue.skipped` | Preserve | Clear |
+| `execution_state` | Preserve | Reset to defaults |
+| `ooda` | Preserve | Reset |
+| `guardrails` | Preserve | Preserve |
+| `blockers` | Preserve | Preserve |
+| `notes` | Preserve | Preserve |
+
+## Conflict Resolution
+
+| Conflict | Resolution |
+|----------|------------|
+| TODO in completed but removed from roadmap | Keep in completed (historical) |
+| TODO in pending but removed from roadmap | Remove from pending |
+| TODO in roadmap but not in queues | Add to pending |
+| TODO marked done in roadmap, not in completed | Add to completed |
+| Circular dependency detected | Error, list cycle, abort |
+
+## Output
+
+```
+✓ Sync complete
+
+Roadmap scanned:
+  - Phases: 3
+  - Features: 12
+  - TODOs: 47
+
+Queue changes:
+  - Added to pending: 5 (new in roadmap)
+  - Removed from pending: 2 (deleted from roadmap)
+  - Moved to completed: 1 (status=done in roadmap)
+  - No changes: 39
+
+Validation:
+  ✓ No orphans
+  ✓ No circular dependencies
+  ✓ All depends_on references valid
+
+.codecruise/progress.yaml updated.
+```
+
+## Dry Run Output
+
+```
+🔍 Sync dry run
+
+Would change:
+  + Add to pending: todo-2.1a-003, todo-2.1a-004, ...
+  - Remove from pending: todo-1.2b-007 (deleted from roadmap)
+  → Move to completed: todo-1.1a-005 (status=done)
+
+Validation:
+  ✓ No issues
+
+Run without --dry-run to apply.
+```
+
+## Error Cases
+
+```
+✗ Sync failed
+
+Circular dependency detected:
+  todo-1.2a-001 → todo-1.2a-003 → todo-1.2a-001
+
+Fix: Remove cycle in roadmap/phase-01.yaml, then re-run /sync.
+```
+
+## Integration
+
+| Command | Relationship |
+|---------|--------------|
+| `/doctor` | Run `/doctor` after sync to validate |
+| `/init` | `/init` calls `/sync` internally for new projects |
+| `/run` | `/sync` before `/run` if roadmap changed |
+
+## Quality Bar
+
+- Idempotent: Running twice = same result
+- Non-destructive: Preserves completed work by default
+- Fast: < 2 seconds for typical projects
+- Validates before writing

package/config/commands/task.md

@@ -0,0 +1,138 @@
+---
+name: task
+description: Execute current TODO using strict TDD (repo-safe)
+disable-model-invocation: true
+tools: Bash, Read, Write, Edit, Glob, Grep
+model: sonnet
+---
+
+# /task Command
+
+Execute the current TODO using strict TDD and the workflow rules.
+
+## Read First
+
+1. `~/.claude/rules/workflow.md`
+2. `~/.claude/rules/standards.md`
+3. Project `CLAUDE.md` (quality_command + stack guidance)
+4. Relevant skills from `~/.claude/skills/` (only if needed)
+
+## Process
+
+### 1. Load Current Task
+
+Read `progress.yaml` to identify:
+
+- `current_todo`
+- `current_feature`
+- `current_phase`
+
+If no current TODO:
+
+- Find next pending TODO from roadmap
+- Update `progress.yaml` with new current
+
+### 2. Read TODO Spec (YAML source of truth)
+
+From the relevant phase/feature YAML, extract:
+
+- id, description, owner, status
+- owned files list (scope boundary)
+- acceptance criteria
+- required tests (if listed)
+
+Rule: If required changes exceed owned files → STOP and ask human.
+
+### 3. Switch Branch
+
+Use the correct feature/subfeature branch per workflow rules:
+
+- checkout existing, or create from the correct parent branch
+- if branch mismatch with progress.yaml → STOP and report
+
+### 4. TDD Cycle
+
+#### RED Phase
+
+- Write failing test(s) covering acceptance criteria
+- Run tests → MUST fail for the right reason
+- If it passes → fix the test (it is wrong)
+- Commit: `test(scope): add tests for {todo}`
+
+#### GREEN Phase
+
+- Implement minimal code to pass
+- Run tests → MUST pass
+
+#### REFACTOR Phase (optional)
+
+- Small cleanup only after green
+- Run tests again → MUST still pass
+- Commit: `feat(scope): implement {todo}`
+
+### 5. Verify Quality
+
+- Read CLAUDE.md → find quality_command
+- Run it via Bash
+- Must pass (tests/lint/typecheck as applicable)
+- If failing: attempt fix (max 3 tries), else STOP
+
+### 6. Update State (YAML only)
+
+- Update TODO status in phase/feature YAML: `done` (or `blocked` with reason)
+- Update `progress.yaml`:
+  - mark completion
+  - set next current_todo (or null)
+  - update last_updated timestamp
+
+Note: Pre-commit hook runs quality checks automatically.
+
+Tip: Run `/dashboard` after completing TODO to update progress visuals.
+
+### 7. Commit Changes
+
+- Ensure all changes committed (no WIP)
+- Commit implementation: `feat(scope): implement {todo}`
+- Commit state update: `chore(progress): complete {todo_id}`
+
+## Output Format
+
+```
+✓ TODO complete: {todo_id}
+
+Branch: {branch_name}
+
+Files modified:
+- {file1}
+- {file2}
+
+Tests added:
+- {test1}
+- {test2}
+
+Quality: ✓ PASS
+
+Commits:
+- test(auth): add login validation tests
+- feat(auth): implement login validation
+
+Next: {next_todo_id} or "Phase complete!"
+```
+
+## On Failure
+
+If tests fail or quality check fails:
+
+1. Report the failure clearly
+2. Show relevant error output
+3. Attempt fix (max 3 tries)
+4. If still failing, stop and ask for help
+
+## Stop Conditions
+
+Immediately stop and ask human if:
+
+- Files outside TODO scope need changes
+- Security concern identified
+- Architectural decision needed
+- Stuck after 3 attempts

package/config/commands/verify.md

@@ -0,0 +1,124 @@
+---
+name: verify
+description: Run project quality checks (tests, lint, typecheck)
+disable-model-invocation: true
+tools: Read, Write, Bash, Glob
+model: haiku
+---
+
+# /verify Command
+
+Run the project's quality checks.
+
+## Read First
+
+1. `~/.claude/rules/workflow.md`
+2. Project `CLAUDE.md`
+
+## Process
+
+### 1. Find Quality Command
+
+Look for `quality_command` in project `CLAUDE.md`:
+
+```markdown
+## Commands
+quality_command: npm run test && npm run lint && npm run typecheck
+```
+
+### 2. If Not Found
+
+Ask user:
+
+```
+No quality_command found in project CLAUDE.md.
+
+What command runs your tests, lint, and type checks?
+Example: npm run test && npm run lint
+
+I'll save this to your project CLAUDE.md for future use.
+```
+
+Save response to project `CLAUDE.md`.
+
+### 3. Capture Baseline
+
+On first run in a session, capture baseline metrics:
+
+```yaml
+baseline_debt:
+  lint_errors: {count}
+  test_failures: {count}
+  type_errors: {count}
+```
+
+Store in `progress.yaml`.
+
+### 4. Run Quality Command
+
+```bash
+{quality_command}
+```
+
+Capture output for each step.
+
+### 5. Compare to Baseline
+
+- No new errors introduced? ✓ PASS
+- New errors introduced? ✗ FAIL (list new issues)
+- Errors fixed? ✓ IMPROVEMENT
+
+### 6. Report Results
+
+#### On Pass
+```
+✓ Quality Check PASS
+
+Tests: 45 passed
+Lint: 0 errors
+Types: 0 errors
+
+No new issues introduced.
+```
+
+#### On Fail
+```
+✗ Quality Check FAIL
+
+New issues introduced:
+
+Lint (2 new):
+- src/auth/login.ts:15 - 'user' is defined but never used
+- src/auth/login.ts:23 - Missing return type
+
+Tests (1 failing):
+- auth/login.test.ts > should validate email format
+
+Fix these issues before committing.
+```
+
+#### On Improvement
+```
+✓ Quality Check PASS (with improvements!)
+
+Tests: 47 passed (+2)
+Lint: 0 errors (-3 fixed)
+Types: 0 errors
+
+Baseline updated.
+```
+
+## Quick Verify
+
+For rapid iteration, support:
+
+```
+/verify --quick
+```
+
+Runs only tests related to changed files (if framework supports it).
+
+## Integration
+
+This command is automatically called by `/task` after implementation.
+Can also be run standalone to check current state.