@su-record/vibe 2.9.21 → 2.9.23

package/skills/vibe-regress/SKILL.md

@@ -1,174 +1,174 @@
----
-name: vibe-regress
-tier: core
-description: "Regression test auto-evolution. Registers bugs (auto from /vibe.verify failures or manual), generates preventive vitest/jest files from bug records, clusters repeated patterns (3+ same root-cause-tag) into shared tests, and imports historical `fix:` commits from git log. Storage: .claude/vibe/regressions/<slug>.md. Must use this skill when user runs /vibe.regress, when /vibe.verify produces a failure, or when the user says 'don't let this happen again' / '이 버그 다시는' / 'regression test' / '회귀 테스트'."
-triggers: [regress, regression, "회귀", "다시는", "반복 버그", "fix commit"]
-priority: 70
-chain-next: []
----
-
-# vibe.regress — Regression Auto-Evolution
-
-**Purpose**: 같은 버그를 두 번 잡지 않는다. 버그를 잡을 때마다 예방 테스트가 자라난다.
-
-## Why this exists
-
-바이브코딩의 고전적 약점: LLM이 같은 클래스의 버그를 매번 새로 만든다. 회귀 테스트는 이를 기계적으로 막는 유일한 장치. 단, 사람이 매번 회귀 테스트를 쓰면 건너뛰게 됨 — 그래서 자동화.
-
-## Storage Contract
-
-```
-.claude/vibe/regressions/
-  <bug-slug>.md       # 하나의 버그 = 하나의 파일
-  _cluster-<tag>.md   # cluster 서브커맨드가 생성한 공통 테스트 설계
-```
-
-### Frontmatter schema (엄격)
-
-```yaml
-slug: string            # kebab-case, 글로벌 유일
-symptom: string         # 1줄, 사용자 관점
-root-cause-tag: enum    # 아래 허용 태그만
-fix-commit: string      # git hash (없으면 "pending")
-test-path: string       # 생성된 테스트 파일 경로 (없으면 "pending")
-status: open | test-generated | resolved
-registered: YYYY-MM-DD
-feature: string         # 연관 feature 이름 (SPEC과 매칭)
-```
-
-### Allowed `root-cause-tag` values
-
-클러스터링의 기반이므로 **미리 정의된 집합만** 사용:
-
-- `timezone` — 시간대/DST/off-by-one
-- `nullability` — null/undefined/empty 처리
-- `concurrency` — race condition, 동시성
-- `boundary` — off-by-one, edge value
-- `encoding` — charset, URL encoding, escape
-- `validation` — 입력 검증 누락
-- `auth` — 인증/권한 로직
-- `state-sync` — 클라이언트/서버 상태 불일치
-- `integration` — 외부 API 호출 실패
-- `type-narrow` — TypeScript 타입 좁히기 실수
-- `other` — 위에 안 맞을 때 (나중에 새 태그 추가)
-
-**규칙**: 새 태그가 필요하면 기존 태그에 억지로 맞추지 말고 `other`로 등록한 뒤, `other`가 3개 이상 쌓이면 사용자에게 태그 추가를 제안.
-
-## Subcommands
-
-### 1. `register "<symptom>"` — 수동 등록
-
-대부분은 자동 호출되므로 수동 사용은 드뭅니다 (verify 실패 밖에서 발견된 버그, 또는 프로덕션 이슈용).
-
-**단계**:
-1. `getCurrentTime`으로 오늘 날짜 확보
-2. `git log -1 --format=%H`으로 현재 커밋 해시 (fix-commit 후보)
-3. Claude가 대화로 다음을 뽑아냄:
-   - Reproduction steps (Given/When/Then)
-   - Root cause 1문단
-   - Fix 설명
-4. `root-cause-tag`는 허용 집합에서 **자동 추론 후 사용자에게 확인**. 애매하면 `other`.
-5. slug 생성: symptom에서 핵심어 → kebab-case, 충돌 시 `-2` 접미사
-6. `.claude/vibe/regressions/<slug>.md` 작성 (status: `open`)
-
-### 2. `generate <slug>` — 예방 테스트 생성
-
-**단계**:
-1. bug 파일 읽기
-2. 테스트 스택 감지:
-   - `package.json`의 `devDependencies`에서 `vitest` > `jest` 순
-   - 둘 다 없으면 **user에게 질문 후 중단**
-3. 테스트 위치 결정:
-   - feature의 구현 파일 옆 `__tests__/` 또는
-   - 프로젝트의 기존 test dir (vitest config.test.include 확인)
-4. 파일명: `<original-file>.regression.test.ts`
-5. 내용: `templates/test-vitest.md` 또는 `templates/test-jest.md` 템플릿에서 치환
-6. bug 파일 frontmatter 업데이트: `test-path`, `status: test-generated`
-7. **생성 후 즉시 테스트 실행** — 실패해야 정상 (아직 수정 안 됨이면) 또는 통과 (수정 완료됨이면). 결과를 frontmatter에 기록.
-
-### 3. `list` — 미해결 목록
-
-```
-/vibe.regress list                 # status != resolved 전부
-/vibe.regress list --feature login # feature별
-/vibe.regress list --tag timezone  # tag별
-```
-
-터미널 표:
-
-```
-SLUG                              FEATURE   TAG         STATUS           AGE
-login-jwt-expiry-off-by-one       login     timezone    test-generated   3d
-cart-stock-race-double-deduct     cart      concurrency open             1d
-```
-
-### 4. `import` — git log 역추적
-
-**단계**:
-1. `git log --grep='^fix:' --format='%H|%s|%ci' --since=<last-import-date>`
-   - `last-import-date`는 `.claude/vibe/regressions/.import-cursor` 파일에서 읽음 (없으면 90일 전)
-2. 각 커밋에 대해:
-   - 이미 같은 `fix-commit`을 가진 bug 파일이 있으면 **스킵**
-   - 없으면 커밋 메시지/diff에서 symptom + root-cause-tag 추론 (LLM 호출)
-   - 신규 bug.md 작성 (status: `resolved` — 이미 고쳐졌으므로)
-3. 완료 후 `.import-cursor` 갱신
-4. 새로 import된 항목에 대해 사용자에게 `generate` 제안
-
-**주의**: `fix:` 커밋이 아닌 일반 커밋은 **무시**. Conventional Commits 규약을 사용하지 않는 프로젝트는 `--grep-pattern` 옵션으로 오버라이드.
-
-### 5. `cluster` — 반복 패턴 승격
-
-**단계**:
-1. 모든 bug 파일의 `root-cause-tag` 집계
-2. **같은 태그가 3개 이상**이면 cluster 후보
-3. 각 후보에 대해:
-   - 3개 bug의 reproduction을 LLM에게 주고 "공통 원인과 공통 테스트 케이스"를 추출
-   - `_cluster-<tag>.md` 파일 생성 (기존 bug 파일들의 slug를 링크)
-   - 공통 테스트 skeleton을 `<project-test-dir>/_cluster-<tag>.regression.test.ts`로 제안 (사용자 승인 후 생성)
-4. 클러스터 생성 시 원본 bug 파일은 **삭제하지 않음** — 이력 보존
-
-**중요**: cluster는 자동 실행 안 됨. 사용자가 명시적으로 호출해야 함 (과도한 추상화 방지).
-
-## Integration with /vibe.verify
-
-`/vibe.verify` 실패 시 verify가 다음을 호출:
-
-```
-Load skill `vibe-regress` with: register --from-verify
-  <feature>: {feature-name}
-  <scenario>: {failed-scenario}
-  <error>: {error-message}
-  <location>: {file:line}
-```
-
-`--from-verify` 플래그 동작:
-- symptom = scenario name + error summary
-- feature = 전달된 feature name
-- root-cause-tag = error pattern에서 자동 추론 (애매하면 `other`)
-- status = `open`
-- **사용자 확인 없이 등록** (verify 실패 상황은 이미 주의 집중 중이라 마찰 최소화가 중요)
-
-## Integration with /vibe.run
-
-`/vibe.run "<feature>"` 시작 시:
-
-1. `ls .claude/vibe/regressions/*.md`에서 `feature: <feature-name>` + `status != resolved` 필터
-2. 미해결 있으면 경고:
-   ```
-   ⚠️  Open regressions for this feature:
-     - login-jwt-expiry-off-by-one (timezone, 3d old)
-     - login-session-leak (auth, 1w old)
-   
-   Fix these before adding new behavior? [y/N]
-   ```
-3. `y` → `/vibe.regress generate`로 체인 (미생성 항목)
-4. `N` → 계속 진행 (ultrawork 모드는 자동 `N` + TODO 기록)
-
-## Done Criteria
-
-- [ ] 서브커맨드가 지정 없이 호출되면 usage 표시
-- [ ] frontmatter 스키마 엄격 준수 (누락 필드 있으면 거부)
-- [ ] `root-cause-tag`가 허용 집합 외 값이면 경고 + `other`로 강제
-- [ ] `generate` 후 테스트를 **실제로 실행**하여 결과 검증
-- [ ] `import`는 중복 스킵 (fix-commit 해시 기준)
-- [ ] `cluster`는 3개 미만이면 아무것도 안 함 (false positive 방지)
+---
+name: vibe-regress
+tier: core
+description: "Regression test auto-evolution. Registers bugs (auto from /vibe.verify failures or manual), generates preventive vitest/jest files from bug records, clusters repeated patterns (3+ same root-cause-tag) into shared tests, and imports historical `fix:` commits from git log. Storage: .claude/vibe/regressions/<slug>.md. Must use this skill when user runs /vibe.regress, when /vibe.verify produces a failure, or when the user says 'don't let this happen again' / 'regression test' / '회귀 테스트'."
+triggers: [regress, regression, "회귀", "다시는", "반복 버그", "fix commit"]
+priority: 70
+chain-next: []
+---
+
+# vibe.regress — Regression Auto-Evolution
+
+**Purpose**: never fix the same bug twice. Each fix grows a preventive test.
+
+## Why this exists
+
+A classic vibe-coding weakness: LLMs reintroduce bugs of the same class. Regression tests are the only mechanical defense. But if the human has to write the test every time, it gets skipped — so automate.
+
+## Storage Contract
+
+```
+.claude/vibe/regressions/
+  <bug-slug>.md       # one file per bug
+  _cluster-<tag>.md   # shared-test design produced by `cluster`
+```
+
+### Frontmatter schema (strict)
+
+```yaml
+slug: string            # kebab-case, globally unique
+symptom: string         # one line, user-facing
+root-cause-tag: enum    # only the allowed tags below
+fix-commit: string      # git hash (or "pending")
+test-path: string       # generated test file path (or "pending")
+status: open | test-generated | resolved
+registered: YYYY-MM-DD
+feature: string         # related feature name (matches SPEC)
+```
+
+### Allowed `root-cause-tag` values
+
+Clustering depends on this, so use **only the predefined set**:
+
+- `timezone` — timezone / DST / off-by-one in time
+- `nullability` — null / undefined / empty handling
+- `concurrency` — race conditions
+- `boundary` — off-by-one, edge values
+- `encoding` — charset, URL encoding, escaping
+- `validation` — missing input validation
+- `auth` — authn/authz logic
+- `state-sync` — client/server state mismatch
+- `integration` — external API call failure
+- `type-narrow` — TypeScript type narrowing mistake
+- `other` — when nothing fits (add new tags later)
+
+**Rule**: if a new tag is needed, do not force-fit into an existing one — register as `other`. Once `other` reaches 3 entries, propose adding a new tag.
+
+## Subcommands
+
+### 1. `register "<symptom>"` — manual registration
+
+Most calls are automatic; manual use is rare (bugs found outside `/vibe.verify`, or production incidents).
+
+**Steps**:
+1. `getCurrentTime` for today's date
+2. `git log -1 --format=%H` for current commit hash (fix-commit candidate)
+3. Conversation extracts:
+   - Reproduction steps (Given/When/Then)
+   - Root-cause paragraph
+   - Fix description
+4. `root-cause-tag` is **inferred from the allowed set, then confirmed with the user**. If unclear → `other`.
+5. Generate slug: kebab-case keywords from the symptom; on collision append `-2`
+6. Write `.claude/vibe/regressions/<slug>.md` (status: `open`)
+
+### 2. `generate <slug>` — generate preventive test
+
+**Steps**:
+1. Read bug file
+2. Detect test stack:
+   - From `package.json` `devDependencies`: prefer `vitest` over `jest`
+   - If neither → **ask user, then stop**
+3. Decide test location:
+   - Sibling `__tests__/` next to the implementation file, OR
+   - The project's existing test dir (vitest config `test.include`)
+4. File name: `<original-file>.regression.test.ts`
+5. Body: render `templates/test-vitest.md` or `templates/test-jest.md`
+6. Update bug frontmatter: `test-path`, `status: test-generated`
+7. **Run the test immediately** — should fail (if not yet fixed) or pass (if fixed). Record outcome in frontmatter.
+
+### 3. `list` — open items
+
+```
+/vibe.regress list                 # status != resolved
+/vibe.regress list --feature login # filter by feature
+/vibe.regress list --tag timezone  # filter by tag
+```
+
+Terminal table:
+
+```
+SLUG                              FEATURE   TAG         STATUS           AGE
+login-jwt-expiry-off-by-one       login     timezone    test-generated   3d
+cart-stock-race-double-deduct     cart      concurrency open             1d
+```
+
+### 4. `import` — backfill from git log
+
+**Steps**:
+1. `git log --grep='^fix:' --format='%H|%s|%ci' --since=<last-import-date>`
+   - `last-import-date` lives in `.claude/vibe/regressions/.import-cursor` (defaults to 90 days ago)
+2. For each commit:
+   - If a bug file with the same `fix-commit` already exists → **skip**
+   - Otherwise infer symptom + root-cause-tag from message/diff (LLM call)
+   - Write a new bug file (status: `resolved` — already fixed)
+3. Update `.import-cursor`
+4. Suggest `generate` for newly imported entries
+
+**Note**: only `fix:` commits are considered. Projects not using Conventional Commits can override with `--grep-pattern`.
+
+### 5. `cluster` — promote recurring patterns
+
+**Steps**:
+1. Aggregate `root-cause-tag` across all bug files
+2. **A tag with ≥3 entries** becomes a cluster candidate
+3. For each candidate:
+   - Feed the 3 reproductions to an LLM to extract the common cause and shared test cases
+   - Write `_cluster-<tag>.md` (links to the original bug slugs)
+   - Propose a shared test skeleton at `<project-test-dir>/_cluster-<tag>.regression.test.ts` (create only with user approval)
+4. Original bug files are **not deleted** — history preserved
+
+**Important**: `cluster` is never automatic. Users invoke it explicitly to avoid premature abstraction.
+
+## Integration with /vibe.verify
+
+When `/vibe.verify` fails it calls:
+
+```
+Load skill `vibe-regress` with: register --from-verify
+  <feature>: {feature-name}
+  <scenario>: {failed-scenario}
+  <error>: {error-message}
+  <location>: {file:line}
+```
+
+`--from-verify` behavior:
+- symptom = scenario name + error summary
+- feature = forwarded feature name
+- root-cause-tag = inferred from error pattern (default `other` if unclear)
+- status = `open`
+- **Skip user confirmation** — the user is already attentive in a verify-failure context, and friction must be minimized
+
+## Integration with /vibe.run
+
+At the start of `/vibe.run "<feature>"`:
+
+1. Filter `.claude/vibe/regressions/*.md` for `feature: <feature-name>` + `status != resolved`
+2. If any open items:
+   ```
+   ⚠️  Open regressions for this feature:
+     - login-jwt-expiry-off-by-one (timezone, 3d old)
+     - login-session-leak (auth, 1w old)
+
+   Fix these before adding new behavior? [y/N]
+   ```
+3. `y` → chain to `/vibe.regress generate` for items not yet test-generated
+4. `N` → continue (ultrawork mode auto-`N`, records TODO)
+
+## Done Criteria
+
+- [ ] Subcommand-less invocation prints usage
+- [ ] Frontmatter schema strictly enforced (missing fields rejected)
+- [ ] `root-cause-tag` outside the allowed set → warn + force `other`
+- [ ] After `generate`, the test is **actually run** to verify
+- [ ] `import` deduplicates by `fix-commit` hash
+- [ ] `cluster` does nothing under 3 entries (false-positive guard)

package/skills/vibe-regress/templates/bug.md

@@ -1,44 +1,44 @@
----
-slug: {{SLUG}}
-symptom: "{{SYMPTOM}}"
-root-cause-tag: {{ROOT_CAUSE_TAG}}
-fix-commit: {{FIX_COMMIT}}
-test-path: {{TEST_PATH}}
-status: {{STATUS}}
-registered: {{DATE}}
-feature: {{FEATURE}}
----
-
-# {{SLUG}}
-
-## Symptom
-
-{{SYMPTOM_DETAIL}}
-
-## Reproduction
-
-**Given**: {{GIVEN}}
-
-**When**: {{WHEN}}
-
-**Then** (broken behavior): {{THEN_BROKEN}}
-
-**Expected**: {{THEN_EXPECTED}}
-
-## Root cause
-
-{{ROOT_CAUSE_EXPLANATION}}
-
-## Fix
-
-{{FIX_EXPLANATION}}
-
-## Related
-
-- Feature: [.claude/vibe/features/{{FEATURE}}.feature](../../features/{{FEATURE}}.feature)
-- Fix commit: `{{FIX_COMMIT}}`
-- Regression test: `{{TEST_PATH}}`
-
-## Notes
-
-{{NOTES}}
+---
+slug: {{SLUG}}
+symptom: "{{SYMPTOM}}"
+root-cause-tag: {{ROOT_CAUSE_TAG}}
+fix-commit: {{FIX_COMMIT}}
+test-path: {{TEST_PATH}}
+status: {{STATUS}}
+registered: {{DATE}}
+feature: {{FEATURE}}
+---
+
+# {{SLUG}}
+
+## Symptom
+
+{{SYMPTOM_DETAIL}}
+
+## Reproduction
+
+**Given**: {{GIVEN}}
+
+**When**: {{WHEN}}
+
+**Then** (broken behavior): {{THEN_BROKEN}}
+
+**Expected**: {{THEN_EXPECTED}}
+
+## Root cause
+
+{{ROOT_CAUSE_EXPLANATION}}
+
+## Fix
+
+{{FIX_EXPLANATION}}
+
+## Related
+
+- Feature: [.claude/vibe/features/{{FEATURE}}.feature](../../features/{{FEATURE}}.feature)
+- Fix commit: `{{FIX_COMMIT}}`
+- Regression test: `{{TEST_PATH}}`
+
+## Notes
+
+{{NOTES}}

package/skills/vibe-regress/templates/test-jest.md

@@ -1,29 +1,29 @@
-/**
- * Regression test — {{SLUG}}
- *
- * Symptom: {{SYMPTOM}}
- * Root cause tag: {{ROOT_CAUSE_TAG}}
- * Fix commit: {{FIX_COMMIT}}
- * Source record: .claude/vibe/regressions/{{SLUG}}.md
- *
- * DO NOT delete this test when the bug is fixed — it exists to prevent the
- * same bug from being reintroduced. Update only if the reproduction steps
- * in the source record change.
- */
-
-{{IMPORTS_FROM_SUT}}
-
-describe('regression: {{SYMPTOM_SHORT}}', () => {
-  it('{{TEST_NAME}}', {{ASYNC}}() => {
-    // Given: {{GIVEN}}
-    {{GIVEN_CODE}}
-
-    // When: {{WHEN}}
-    {{WHEN_CODE}}
-
-    // Then: {{THEN}}
-    {{THEN_ASSERTIONS}}
-  });
-
-  {{EXTRA_IT_BLOCKS}}
-});
+/**
+ * Regression test — {{SLUG}}
+ *
+ * Symptom: {{SYMPTOM}}
+ * Root cause tag: {{ROOT_CAUSE_TAG}}
+ * Fix commit: {{FIX_COMMIT}}
+ * Source record: .claude/vibe/regressions/{{SLUG}}.md
+ *
+ * DO NOT delete this test when the bug is fixed — it exists to prevent the
+ * same bug from being reintroduced. Update only if the reproduction steps
+ * in the source record change.
+ */
+
+{{IMPORTS_FROM_SUT}}
+
+describe('regression: {{SYMPTOM_SHORT}}', () => {
+  it('{{TEST_NAME}}', {{ASYNC}}() => {
+    // Given: {{GIVEN}}
+    {{GIVEN_CODE}}
+
+    // When: {{WHEN}}
+    {{WHEN_CODE}}
+
+    // Then: {{THEN}}
+    {{THEN_ASSERTIONS}}
+  });
+
+  {{EXTRA_IT_BLOCKS}}
+});

package/skills/vibe-regress/templates/test-vitest.md

@@ -1,30 +1,30 @@
-/**
- * Regression test — {{SLUG}}
- *
- * Symptom: {{SYMPTOM}}
- * Root cause tag: {{ROOT_CAUSE_TAG}}
- * Fix commit: {{FIX_COMMIT}}
- * Source record: .claude/vibe/regressions/{{SLUG}}.md
- *
- * DO NOT delete this test when the bug is fixed — it exists to prevent the
- * same bug from being reintroduced. Update only if the reproduction steps
- * in the source record change.
- */
-
-import { describe, it, expect{{EXTRA_IMPORTS}} } from 'vitest';
-{{IMPORTS_FROM_SUT}}
-
-describe('regression: {{SYMPTOM_SHORT}}', () => {
-  it('{{TEST_NAME}}', {{ASYNC}}() => {
-    // Given: {{GIVEN}}
-    {{GIVEN_CODE}}
-
-    // When: {{WHEN}}
-    {{WHEN_CODE}}
-
-    // Then: {{THEN}}
-    {{THEN_ASSERTIONS}}
-  });
-
-  {{EXTRA_IT_BLOCKS}}
-});
+/**
+ * Regression test — {{SLUG}}
+ *
+ * Symptom: {{SYMPTOM}}
+ * Root cause tag: {{ROOT_CAUSE_TAG}}
+ * Fix commit: {{FIX_COMMIT}}
+ * Source record: .claude/vibe/regressions/{{SLUG}}.md
+ *
+ * DO NOT delete this test when the bug is fixed — it exists to prevent the
+ * same bug from being reintroduced. Update only if the reproduction steps
+ * in the source record change.
+ */
+
+import { describe, it, expect{{EXTRA_IMPORTS}} } from 'vitest';
+{{IMPORTS_FROM_SUT}}
+
+describe('regression: {{SYMPTOM_SHORT}}', () => {
+  it('{{TEST_NAME}}', {{ASYNC}}() => {
+    // Given: {{GIVEN}}
+    {{GIVEN_CODE}}
+
+    // When: {{WHEN}}
+    {{WHEN_CODE}}
+
+    // Then: {{THEN}}
+    {{THEN_ASSERTIONS}}
+  });
+
+  {{EXTRA_IT_BLOCKS}}
+});