@su-record/vibe 2.8.52 → 2.9.1

package/skills/exec-plan/templates/plan.md

@@ -1,147 +1,147 @@
-# ExecPlan: {{FEATURE_NAME}}
-
-## Meta
-
-| Field | Value |
-|-------|-------|
-| SPEC | `.claude/vibe/specs/{{FEATURE_NAME}}.md` |
-| Feature | `.claude/vibe/features/{{FEATURE_NAME}}.feature` |
-| Generated | {{GENERATED_DATE}} |
-| Phases | {{PHASE_COUNT}} |
-| Scenarios | {{SCENARIO_COUNT}} |
-| Estimated effort | {{EFFORT_ESTIMATE}} |
-
----
-
-## Pre-flight Checks
-
-Run these before starting any phase. All must pass.
-
-- [ ] `npm run build` — clean build
-- [ ] `npx vitest run` — baseline tests pass ({{BASELINE_TEST_COUNT}} tests)
-- [ ] Required files exist:
-  - `{{REQUIRED_FILE_1}}`
-  - `{{REQUIRED_FILE_2}}`
-- [ ] Dependencies installed: `{{DEPENDENCY_CHECK_COMMAND}}`
-
----
-
-## Phase 1: {{PHASE_1_NAME}}
-
-### Environment
-
-| Item | Detail |
-|------|--------|
-| Files to modify | `{{PHASE_1_MODIFY_FILES}}` |
-| Files to create | `{{PHASE_1_CREATE_FILES}}` |
-| Dependencies | `{{PHASE_1_DEPENDENCIES}}` |
-| Pattern to follow | See inline snippet below |
-
-**Pattern (copy from codebase, do not paraphrase):**
-
-```typescript
-{{PHASE_1_PATTERN_SNIPPET}}
-```
-
-### Scenario 1.1: {{SCENARIO_1_1_NAME}}
-
-**REQ**: {{REQ_ID}}
-
-**Given**: {{GIVEN_CONDITION}}
-→ Setup:
-```typescript
-{{SETUP_CODE}}
-```
-
-**When**: {{ACTION}}
-→ Implement in `{{TARGET_FILE}}`, after line containing `{{ANCHOR_TEXT}}`:
-```typescript
-{{IMPLEMENTATION_SNIPPET}}
-```
-Imports needed: `{{IMPORTS_LIST}}`
-
-**Then**: {{EXPECTED_RESULT}}
-→ Verify:
-```bash
-{{VERIFY_COMMAND}}
-```
-Expected output: `{{EXPECTED_OUTPUT}}`
-Fallback if fails: {{FALLBACK_INSTRUCTION}}
-
----
-
-### Scenario 1.2: {{SCENARIO_1_2_NAME}}
-
-**Given**: {{GIVEN_CONDITION}}
-→ Setup: {{SETUP_INSTRUCTION}}
-
-**When**: {{ACTION}}
-→ Implement: {{IMPLEMENTATION_INSTRUCTION}}
-
-**Then**: {{EXPECTED_RESULT}}
-→ Verify: `{{VERIFY_COMMAND}}`
-
----
-
-### Phase 1 Gate
-
-- [ ] `npm run build` — no type errors
-- [ ] `npx vitest run {{PHASE_1_TEST_FILES}}` — all pass
-- [ ] `npx tsc --noEmit` — clean
-
----
-
-## Phase 2: {{PHASE_2_NAME}}
-
-### Environment
-
-| Item | Detail |
-|------|--------|
-| Files to modify | `{{PHASE_2_MODIFY_FILES}}` |
-| Files to create | `{{PHASE_2_CREATE_FILES}}` |
-| Dependencies | `{{PHASE_2_DEPENDENCIES}}` |
-
-### Scenario 2.1: {{SCENARIO_2_1_NAME}}
-
-**Given**: {{GIVEN_CONDITION}}
-→ Setup: {{SETUP_INSTRUCTION}}
-
-**When**: {{ACTION}}
-→ Implement: {{IMPLEMENTATION_INSTRUCTION}}
-
-**Then**: {{EXPECTED_RESULT}}
-→ Verify: `{{VERIFY_COMMAND}}`
-
----
-
-### Phase 2 Gate
-
-- [ ] `npm run build`
-- [ ] `npx vitest run {{PHASE_2_TEST_FILES}}`
-- [ ] `npx tsc --noEmit`
-
----
-
-## Completion Criteria
-
-- [ ] All scenarios passing
-- [ ] Coverage: ≥ {{COVERAGE_THRESHOLD}}%
-- [ ] No regressions in existing tests
-- [ ] `npm run build` exits 0
-- [ ] RTM generated: `generateTraceabilityMatrix("{{FEATURE_NAME}}")`
-
----
-
-## Handoff (if incomplete)
-
-Save state before ending session:
-
-```
-save_memory("execplan-{{FEATURE_NAME}}", {
-  "last_completed": "Phase X, Scenario Y.Z",
-  "next_step": "{{NEXT_STEP_DESCRIPTION}}",
-  "blockers": "{{BLOCKERS_IF_ANY}}"
-})
-```
-
-Resume: `/vibe.utils --continue` → load this file.
+# ExecPlan: {{FEATURE_NAME}}
+
+## Meta
+
+| Field | Value |
+|-------|-------|
+| SPEC | `.claude/vibe/specs/{{FEATURE_NAME}}.md` |
+| Feature | `.claude/vibe/features/{{FEATURE_NAME}}.feature` |
+| Generated | {{GENERATED_DATE}} |
+| Phases | {{PHASE_COUNT}} |
+| Scenarios | {{SCENARIO_COUNT}} |
+| Estimated effort | {{EFFORT_ESTIMATE}} |
+
+---
+
+## Pre-flight Checks
+
+Run these before starting any phase. All must pass.
+
+- [ ] `npm run build` — clean build
+- [ ] `npx vitest run` — baseline tests pass ({{BASELINE_TEST_COUNT}} tests)
+- [ ] Required files exist:
+  - `{{REQUIRED_FILE_1}}`
+  - `{{REQUIRED_FILE_2}}`
+- [ ] Dependencies installed: `{{DEPENDENCY_CHECK_COMMAND}}`
+
+---
+
+## Phase 1: {{PHASE_1_NAME}}
+
+### Environment
+
+| Item | Detail |
+|------|--------|
+| Files to modify | `{{PHASE_1_MODIFY_FILES}}` |
+| Files to create | `{{PHASE_1_CREATE_FILES}}` |
+| Dependencies | `{{PHASE_1_DEPENDENCIES}}` |
+| Pattern to follow | See inline snippet below |
+
+**Pattern (copy from codebase, do not paraphrase):**
+
+```typescript
+{{PHASE_1_PATTERN_SNIPPET}}
+```
+
+### Scenario 1.1: {{SCENARIO_1_1_NAME}}
+
+**REQ**: {{REQ_ID}}
+
+**Given**: {{GIVEN_CONDITION}}
+→ Setup:
+```typescript
+{{SETUP_CODE}}
+```
+
+**When**: {{ACTION}}
+→ Implement in `{{TARGET_FILE}}`, after line containing `{{ANCHOR_TEXT}}`:
+```typescript
+{{IMPLEMENTATION_SNIPPET}}
+```
+Imports needed: `{{IMPORTS_LIST}}`
+
+**Then**: {{EXPECTED_RESULT}}
+→ Verify:
+```bash
+{{VERIFY_COMMAND}}
+```
+Expected output: `{{EXPECTED_OUTPUT}}`
+Fallback if fails: {{FALLBACK_INSTRUCTION}}
+
+---
+
+### Scenario 1.2: {{SCENARIO_1_2_NAME}}
+
+**Given**: {{GIVEN_CONDITION}}
+→ Setup: {{SETUP_INSTRUCTION}}
+
+**When**: {{ACTION}}
+→ Implement: {{IMPLEMENTATION_INSTRUCTION}}
+
+**Then**: {{EXPECTED_RESULT}}
+→ Verify: `{{VERIFY_COMMAND}}`
+
+---
+
+### Phase 1 Gate
+
+- [ ] `npm run build` — no type errors
+- [ ] `npx vitest run {{PHASE_1_TEST_FILES}}` — all pass
+- [ ] `npx tsc --noEmit` — clean
+
+---
+
+## Phase 2: {{PHASE_2_NAME}}
+
+### Environment
+
+| Item | Detail |
+|------|--------|
+| Files to modify | `{{PHASE_2_MODIFY_FILES}}` |
+| Files to create | `{{PHASE_2_CREATE_FILES}}` |
+| Dependencies | `{{PHASE_2_DEPENDENCIES}}` |
+
+### Scenario 2.1: {{SCENARIO_2_1_NAME}}
+
+**Given**: {{GIVEN_CONDITION}}
+→ Setup: {{SETUP_INSTRUCTION}}
+
+**When**: {{ACTION}}
+→ Implement: {{IMPLEMENTATION_INSTRUCTION}}
+
+**Then**: {{EXPECTED_RESULT}}
+→ Verify: `{{VERIFY_COMMAND}}`
+
+---
+
+### Phase 2 Gate
+
+- [ ] `npm run build`
+- [ ] `npx vitest run {{PHASE_2_TEST_FILES}}`
+- [ ] `npx tsc --noEmit`
+
+---
+
+## Completion Criteria
+
+- [ ] All scenarios passing
+- [ ] Coverage: ≥ {{COVERAGE_THRESHOLD}}%
+- [ ] No regressions in existing tests
+- [ ] `npm run build` exits 0
+- [ ] RTM generated: `generateTraceabilityMatrix("{{FEATURE_NAME}}")`
+
+---
+
+## Handoff (if incomplete)
+
+Save state before ending session:
+
+```
+save_memory("execplan-{{FEATURE_NAME}}", {
+  "last_completed": "Phase X, Scenario Y.Z",
+  "next_step": "{{NEXT_STEP_DESCRIPTION}}",
+  "blockers": "{{BLOCKERS_IF_ANY}}"
+})
+```
+
+Resume: `/vibe.utils --continue` → load this file.

package/skills/git-worktree/SKILL.md

@@ -1,73 +1,73 @@
----
-name: git-worktree
-tier: optional
-description: "Git Worktree for parallel branch work. Auto-activates for PR review, hotfix, parallel testing, or working on multiple branches simultaneously."
-triggers: [worktree, PR review, hotfix, parallel branch, multiple branches]
-priority: 50
----
-
-# Git Worktree
-
-## Pre-check (K1)
-
-> Do you need to work on another branch without losing current work? If you can just `git stash` and switch, worktree may be overkill.
-
-## Core Commands
-
-```bash
-# Create worktree for PR review
-git worktree add ../review-{pr_number} origin/pr/{pr_number}
-
-# Create worktree with new branch (hotfix)
-git worktree add -b hotfix/urgent ../hotfix main
-
-# List all worktrees
-git worktree list
-
-# Remove when done
-git worktree remove ../review-{pr_number}
-
-# Clean up stale entries
-git worktree prune
-```
-
-## PR Review Workflow
-
-```
-1. git worktree add ../review-123 origin/pr/123
-2. cd ../review-123
-3. npm install && npm test
-4. Run review agents
-5. cd - && git worktree remove ../review-123
-```
-
-## Hotfix Workflow
-
-```
-1. git worktree add -b hotfix/critical ../hotfix main
-2. cd ../hotfix
-3. Fix bug → commit → push
-4. cd - && git worktree remove ../hotfix
-```
-
-## Naming Convention
-
-```bash
-../review-{pr_number}         # PR review
-../hotfix-{issue_number}      # Hotfix
-../experiment-{feature_name}  # Experiment
-```
-
-## Troubleshooting
-
-| Error | Fix |
-|-------|-----|
-| "already checked out" | Branch is in another worktree — `git worktree list`, then remove |
-| Locked worktree | `git worktree unlock <path>` |
-| Stale worktree | `git worktree prune` |
-
-## Done Criteria (K4)
-
-- [ ] Worktree created and work completed in isolation
-- [ ] Worktree removed after work is done
-- [ ] No stale worktrees left (`git worktree list` clean)
+---
+name: git-worktree
+tier: optional
+description: "Git Worktree for parallel branch work. Auto-activates for PR review, hotfix, parallel testing, or working on multiple branches simultaneously."
+triggers: [worktree, PR review, hotfix, parallel branch, multiple branches]
+priority: 50
+---
+
+# Git Worktree
+
+## Pre-check (K1)
+
+> Do you need to work on another branch without losing current work? If you can just `git stash` and switch, worktree may be overkill.
+
+## Core Commands
+
+```bash
+# Create worktree for PR review
+git worktree add ../review-{pr_number} origin/pr/{pr_number}
+
+# Create worktree with new branch (hotfix)
+git worktree add -b hotfix/urgent ../hotfix main
+
+# List all worktrees
+git worktree list
+
+# Remove when done
+git worktree remove ../review-{pr_number}
+
+# Clean up stale entries
+git worktree prune
+```
+
+## PR Review Workflow
+
+```
+1. git worktree add ../review-123 origin/pr/123
+2. cd ../review-123
+3. npm install && npm test
+4. Run review agents
+5. cd - && git worktree remove ../review-123
+```
+
+## Hotfix Workflow
+
+```
+1. git worktree add -b hotfix/critical ../hotfix main
+2. cd ../hotfix
+3. Fix bug → commit → push
+4. cd - && git worktree remove ../hotfix
+```
+
+## Naming Convention
+
+```bash
+../review-{pr_number}         # PR review
+../hotfix-{issue_number}      # Hotfix
+../experiment-{feature_name}  # Experiment
+```
+
+## Troubleshooting
+
+| Error | Fix |
+|-------|-----|
+| "already checked out" | Branch is in another worktree — `git worktree list`, then remove |
+| Locked worktree | `git worktree unlock <path>` |
+| Stale worktree | `git worktree prune` |
+
+## Done Criteria (K4)
+
+- [ ] Worktree created and work completed in isolation
+- [ ] Worktree removed after work is done
+- [ ] No stale worktrees left (`git worktree list` clean)

package/skills/git-worktree/rubrics/when-to-use.md

@@ -1,55 +1,55 @@
-# Git Worktree: When to Use Decision Guide
-
-## Decision Tree
-
-```
-Need to work on a different branch?
-    │
-    ├─ How long? < 5 minutes
-    │       └─ Use git stash + switch
-    │
-    ├─ Will you need to run tests/build?
-    │       └─ No → git stash is fine
-    │           Yes → Consider worktree
-    │
-    └─ Can you commit current work?
-            └─ Yes → commit + switch (simplest)
-                No → worktree or stash
-```
-
-## Use Worktree When
-
-| Scenario | Reason |
-|----------|--------|
-| Reviewing a PR that needs running | Avoids dirty working tree; test in isolation |
-| Critical hotfix while mid-feature | Keep feature branch untouched |
-| A/B testing two implementations | Both runnable simultaneously |
-| Long-running parallel experiment | Work on both without context switching |
-
-## Skip Worktree When
-
-| Scenario | Better Alternative |
-|----------|--------------------|
-| Quick config change on another branch | `git stash && git switch` |
-| Just reading code on another branch | `git show branch:file` |
-| Already committed current work | `git switch` directly |
-| Change touches same files | Merging will conflict regardless |
-| Repo uses large node_modules | Each worktree needs separate install — expensive |
-
-## Cost/Benefit
-
-| Factor | Worktree Cost |
-|--------|--------------|
-| Disk space | Full working copy per worktree |
-| `npm install` / `pnpm install` | Required in each worktree |
-| Mental overhead | Tracking multiple worktree paths |
-| Cleanup discipline | Must `git worktree remove` when done |
-
-**Rule of thumb**: If the task is under 15 minutes, `git stash` is almost always faster than setting up a worktree.
-
-## Gotchas
-
-- A branch can only be checked out in **one** worktree at a time
-- Worktrees share `.git` — commits in any worktree are immediately visible in all
-- Forgetting to remove worktrees leaves stale locks — run `git worktree prune` periodically
-- CI/CD hooks may not run correctly outside the main worktree path
+# Git Worktree: When to Use Decision Guide
+
+## Decision Tree
+
+```
+Need to work on a different branch?
+    │
+    ├─ How long? < 5 minutes
+    │       └─ Use git stash + switch
+    │
+    ├─ Will you need to run tests/build?
+    │       └─ No → git stash is fine
+    │           Yes → Consider worktree
+    │
+    └─ Can you commit current work?
+            └─ Yes → commit + switch (simplest)
+                No → worktree or stash
+```
+
+## Use Worktree When
+
+| Scenario | Reason |
+|----------|--------|
+| Reviewing a PR that needs running | Avoids dirty working tree; test in isolation |
+| Critical hotfix while mid-feature | Keep feature branch untouched |
+| A/B testing two implementations | Both runnable simultaneously |
+| Long-running parallel experiment | Work on both without context switching |
+
+## Skip Worktree When
+
+| Scenario | Better Alternative |
+|----------|--------------------|
+| Quick config change on another branch | `git stash && git switch` |
+| Just reading code on another branch | `git show branch:file` |
+| Already committed current work | `git switch` directly |
+| Change touches same files | Merging will conflict regardless |
+| Repo uses large node_modules | Each worktree needs separate install — expensive |
+
+## Cost/Benefit
+
+| Factor | Worktree Cost |
+|--------|--------------|
+| Disk space | Full working copy per worktree |
+| `npm install` / `pnpm install` | Required in each worktree |
+| Mental overhead | Tracking multiple worktree paths |
+| Cleanup discipline | Must `git worktree remove` when done |
+
+**Rule of thumb**: If the task is under 15 minutes, `git stash` is almost always faster than setting up a worktree.
+
+## Gotchas
+
+- A branch can only be checked out in **one** worktree at a time
+- Worktrees share `.git` — commits in any worktree are immediately visible in all
+- Forgetting to remove worktrees leaves stale locks — run `git worktree prune` periodically
+- CI/CD hooks may not run correctly outside the main worktree path