@su-record/vibe 2.9.1 → 2.9.3

package/skills/vibe.interview/SKILL.md

@@ -0,0 +1,358 @@
+---
+name: vibe.interview
+tier: core
+description: "Iteratively interview the user to gather ALL required and optional requirements for a new project or feature. Loops until the user explicitly stops. Uses type-specific domain checklists (website, webapp, mobile, api, library, feature) so nothing is missed. Must use this skill when the user says '만들자', '개발하자', '신규 기능', '무엇을 만들', 'let's build', 'new feature', or starts describing a product idea without a plan yet."
+triggers: [만들자, 개발하자, 기획하자, 신규 기능, 새 프로젝트, "무엇을 만들", "무엇을 개발", 아이디어, 인터뷰, interview, requirements, "let's build", "new feature", "new project"]
+priority: 95
+chain-next: [vibe.plan]
+---
+
+# vibe.interview — Domain Requirements Interview
+
+> **Principle**: Uncover all required and optional information in the requirements domain until the user says "stop". Do not wrap up with 10 shallow questions.
+
+## When to Use
+
+- The user is starting development of a new project or feature
+- Going straight to `/vibe.spec` without a plan risks missing requirements
+- Natural language triggers like "let's build", "let's develop", "new", "idea"
+- `/vibe.spec` orchestrator calls this as Phase 1 (interview step)
+
+**Skip when**:
+- Small bug fix on an existing project
+- `.claude/vibe/plans/{feature}.md` already exists (→ only update via `vibe.plan`)
+
+## Core Loop
+
+```
+1. Detect project type (website|webapp|mobile|api|library|feature)
+     ↓
+2. Load type-specific checklist
+     checklists/{type}.md
+     Required items + Optional items
+     ↓
+3. ┌─── Interview loop ───┐
+   │                      │
+   │  One question at a   │
+   │  time                │
+   │       ↓              │
+   │  User answer         │
+   │       ↓              │
+   │  Update checklist    │
+   │       ↓              │
+   │  New domain found →  │
+   │  Expand checklist    │
+   │       ↓              │
+   │  Show progress       │
+   │       ↓              │
+   │  Stop detected? ─────┼─→ Exit
+   │       │              │
+   │       └──── loop ────┘
+   └──────────────────────┘
+     ↓
+4. Save collected results
+   .claude/vibe/interviews/{feature}.md
+     ↓
+5. chain-next: vibe.plan
+```
+
+## Step 0: Git Branch (MANDATORY)
+
+```bash
+git branch --show-current
+```
+
+| Current | Action |
+|---------|--------|
+| `main`/`master` | `git checkout -b interview/{feature-name}` |
+| `interview/*`, `feature/*` | Confirm with user |
+| Other | Confirm with user |
+
+**Naming**: lowercase + hyphens, prefix `interview/`
+
+## Step 1: Detect Project Type
+
+**First pass — keywords**:
+
+| Keyword | Type | Checklist |
+|---------|------|-----------|
+| website, landing, portfolio, 랜딩, 웹사이트, 홍보, 프로모션 | `website` | `checklists/website.md` |
+| webapp, dashboard, SaaS, 대시보드, 관리자, tool | `webapp` | `checklists/webapp.md` |
+| mobile, iOS, Android, 앱, native, Flutter, React Native | `mobile` | `checklists/mobile.md` |
+| api, backend, server, rest, graphql, 서버, 백엔드 | `api` | `checklists/api.md` |
+| library, sdk, cli, package, npm, 라이브러리 | `library` | `checklists/library.md` |
+| feature, 기능, 추가, refactor | `feature` | `checklists/feature.md` |
+
+**If ambiguous, confirm with one question** (provide options):
+
+```
+What kind of project is this?
+
+1. Website (landing / portfolio / promotion)
+2. Web app (dashboard / SaaS / tool)
+3. Mobile app
+4. API / Backend
+5. Library / SDK / CLI
+6. A feature to add to an existing project
+```
+
+## Step 2: Load Checklist
+
+Read the checklist file for the detected type:
+
+```
+Read skills/vibe.interview/checklists/{type}.md
+```
+
+The checklist is divided into a **Required** section and an **Optional** section. Each item has the following structure:
+
+```markdown
+- [ ] ID: question-id
+      question: The question to ask the user
+      type: required | optional
+      hint: Example answers or choices
+      follow-up: Sub-questions to drill into based on the answer
+```
+
+**Keep state in memory**:
+
+```javascript
+const state = {
+  type: 'website',
+  collected: {
+    'purpose': 'New product launch promotion',
+    'target-users': 'Home cafe enthusiasts',
+    // ...
+  },
+  pending: {
+    required: ['success-metric', 'launch-deadline', ...],
+    optional: ['analytics', 'cms', 'i18n', ...]
+  },
+  discovered: [],  // Items newly discovered during conversation
+  stopped: false
+};
+```
+
+## Step 3: Interview Loop
+
+### 3.1 Question Rules
+
+- **One question at a time**. No combined questions.
+- **Multiple choice + free input** in parallel: "1. A  2. B  3. C  or describe freely"
+- **No fixed order**. Prioritize related pending items based on conversation flow.
+- **Keep it short**. One line of context + one line of question.
+
+### 3.2 Processing Answers
+
+- Save answers to `collected`
+- Extract additional information from answers (e.g., "I want dark mode" → auto-record `theme-preference=dark`)
+- **Detect new domains**: If an answer mentions an area not in `pending` → add to `discovered` and generate questions
+  - e.g., "I need payments too" → expand checklist with `payment-provider`, `payment-methods`, `currency`, etc.
+
+### 3.3 Show Progress (every 3–5 questions)
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 Interview Progress
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+✅ Required: 5/8
+⚪ Optional: 2/14
+➕ Discovered: 3 new items
+
+Next topic: {next-topic}
+
+Just answer to continue.
+Say "stop", "enough", or "done" at any time to finish.
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### 3.4 Stop Detection (Stop Control)
+
+**Explicit stop keywords** (if found in user's answer, set `stopped = true`):
+
+```
+그만, 멈춰, 충분해, 됐어, 이제 됐다,
+stop, done, enough, that's it, finish, skip
+```
+
+**Implicit stop**:
+- "I don't know" / "later" on the same topic 3 times in a row → automatically move to next topic
+- Pressing only `Enter` on an Optional item → skip that item
+
+**Warning when Required items are incomplete**:
+
+```
+⚠️ {N} required item(s) remaining: {list}
+
+Do you still want to stop? (y/N)
+Incomplete items will be marked as "TBD" in the plan.
+```
+
+### 3.5 Phase Transitions
+
+- **Required → Optional**: Automatically transition when all Required items are filled
+  ```
+  ✅ Required requirements collected!
+
+  Would you like to go through the optional items?
+  (SEO, analytics, i18n, accessibility, etc. — 1–2 questions each)
+
+  1. Yes, continue
+  2. Key items only (3–5 questions)
+  3. Stop
+  ```
+- **Optional → End**: All Optional items processed or user stopped
+
+## Step 4: Save Collected Results
+
+**Output file**: `.claude/vibe/interviews/{feature-name}.md`
+
+**Structure**:
+
+```markdown
+---
+feature: {feature-name}
+type: website | webapp | mobile | api | library | feature
+status: complete | partial
+startedAt: {ISO-timestamp}
+completedAt: {ISO-timestamp}
+requiredCollected: 8/8
+optionalCollected: 12/14
+stoppedBy: user | auto
+---
+
+# Interview: {feature-name}
+
+## Required Requirements
+
+### purpose
+**Q**: Why are you building this project?
+**A**: A new product launch promotion site. Launching a home cafe coffee bean brand.
+
+### target-users
+**Q**: Who is the primary target audience?
+**A**: Home cafe enthusiasts, people who buy coffee beans 2–3 times a month.
+
+...
+
+## Optional Requirements
+
+### analytics
+**Q**: Do you need analytics tool integration?
+**A**: GA4 + Hotjar
+
+...
+
+## Discovered (found during conversation)
+
+### payment-integration
+**Context**: User mentioned "direct checkout from the buy button"
+**Q**: What payment methods do you want to support?
+**A**: Stripe, Kakao Pay
+
+...
+
+## TBD (not collected)
+
+- [ ] `seo-strategy` — optional, skipped by user
+- [ ] `maintenance-plan` — optional, skipped by user
+```
+
+### Update `.last-feature` pointer
+
+```
+Write ".claude/vibe/.last-feature" ← feature-name (single line)
+
+Run immediately after saving the interview file in Step 4.
+This pointer is used by /vibe.spec (no args) for Smart Resume.
+No-op if the value is already the same.
+```
+
+## Step 5: Chain to vibe.plan
+
+After the interview is complete, the `vibe.plan` skill is automatically activated to refine the results into a structured plan.
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ Interview complete!
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📄 .claude/vibe/interviews/{feature-name}.md
+   Required: 8/8
+   Optional: 12/14
+   Discovered: 3
+
+→ vibe.plan skill is starting plan creation...
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Anti-Patterns
+
+- Bundling multiple questions together at once
+- Prompting the user to stop before Required items are complete
+- Ignoring a user's answer and moving on to the next question
+- Missing areas not in the checklist (use `discovered`)
+- Writing the plan in PTCF/EARS/Phase structure here (that is refined by vibe.plan; the actual spec is written by /vibe.spec)
+- Ending with 10 shallow questions (keep going until the user explicitly stops)
+- Providing only multiple-choice options without allowing free input
+
+## Example Session (abbreviated)
+
+```
+User: I want to make a parallax website
+
+Claude: 🌿 Branch created: interview/parallax-website ✅
+        Type: website detected → loading checklists/website.md
+
+        Let me start with some background.
+        Why are you building this website?
+        (e.g., personal portfolio, product promotion, agency introduction, etc.)
+
+User: New product launch promotion. Coffee bean brand.
+
+Claude: Got it. Who is the primary target audience?
+        1. Coffee beginners
+        2. Home cafe enthusiasts
+        3. Cafe owners / baristas
+        Or describe freely
+
+User: 2
+
+Claude: What emotion or atmosphere should users feel first when they land on this site?
+
+User: Premium. Cinematic.
+
+Claude: Do you have any reference sites or images? (URL or "none")
+
+User: Like the apple.com product page feel
+
+[10–20 questions continue...]
+
+Claude: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+        📊 Interview Progress
+        ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+        ✅ Required: 8/8 complete!
+        ⚪ Optional: 4/14
+
+        Would you like to continue with optional items (SEO, analytics, i18n, etc.)?
+        1. Yes, all of them
+        2. Key items only (3–5)
+        3. Stop
+
+User: 3
+
+Claude: ⚠️ All required items complete. 10 optional items will be marked as TBD.
+
+        ✅ Interview complete!
+        📄 .claude/vibe/interviews/parallax-website.md
+
+        → vibe.plan skill is starting plan creation...
+```
+
+## Related
+
+- **Next**: `vibe.plan` — refine interview results into a structured plan
+- **After plan**: `vibe.spec` (skill) → generates SPEC → then `/vibe.run` (logic) + `/vibe.figma` (UI track) in parallel
+- **Templates**: `~/.claude/vibe/templates/plan-template.md`
+- **Checklists**: `skills/vibe.interview/checklists/{type}.md`

package/skills/vibe.interview/checklists/api.md

@@ -0,0 +1,101 @@
+# Discovery Checklist: API / Backend
+
+> REST, GraphQL, gRPC, 마이크로서비스 등 **UI 없는 백엔드 시스템**.
+
+## Required
+
+### R1. purpose
+**Q**: 이 API/백엔드가 해결하는 문제는 무엇인가요?
+
+### R2. consumers
+**Q**: 누가 이 API를 사용하나요?
+**힌트**: 자사 프론트엔드, 외부 개발자, 모바일 앱, 파트너 시스템, 내부 서비스.
+**follow-up**: "공개 API인가요, 내부용인가요?"
+
+### R3. core-endpoints
+**Q**: 주요 리소스/엔드포인트는?
+**힌트**: 예) Users, Products, Orders. CRUD 수준 대략.
+
+### R4. data-model
+**Q**: 주요 엔티티와 관계는?
+**힌트**: ERD 수준 불필요, 핵심만.
+
+### R5. auth-strategy
+**Q**: 인증/인가 방식은?
+**힌트**: API Key, JWT, OAuth2, mTLS, 인증 없음. Scope/Role 필요?
+
+### R6. protocol
+**Q**: API 프로토콜은?
+**힌트**: REST / GraphQL / gRPC / WebSocket / 혼합.
+
+### R7. tech-stack
+**Q**: 기술 스택은?
+**힌트**: 언어/프레임워크(Node/FastAPI/Go/Rust), DB(Postgres/Mongo/Redis), 호스팅.
+
+### R8. performance-slo
+**Q**: 성능 SLO가 있나요?
+**힌트**: 예) p95 응답 시간 < 200ms, 처리량 1000 req/s.
+
+### R9. success-metric
+**Q**: 성공 기준은?
+**힌트**: Uptime, 응답 시간, 에러율, API 사용량.
+
+## Optional
+
+### O1. versioning-strategy
+**Q**: API 버저닝 전략이 있나요?
+**힌트**: URL(/v1/), 헤더, 없음.
+
+### O2. rate-limiting
+**Q**: Rate limiting이 필요한가요?
+**힌트**: Tier별(free/paid), 전역, IP 기반.
+
+### O3. caching-strategy
+**Q**: 캐싱 전략이 있나요?
+**힌트**: HTTP 캐시, Redis, CDN, Edge.
+
+### O4. async-jobs
+**Q**: 비동기 작업/큐가 필요한가요?
+**힌트**: BullMQ, SQS, Kafka, Temporal.
+
+### O5. webhooks
+**Q**: 웹훅 지원이 필요한가요?
+
+### O6. documentation
+**Q**: API 문서 자동화는?
+**힌트**: OpenAPI/Swagger, GraphQL 스키마, Postman, Scalar.
+
+### O7. sdk-generation
+**Q**: 클라이언트 SDK 생성이 필요한가요?
+**힌트**: 언어별(TS/Python/Go), OpenAPI 기반 생성.
+
+### O8. observability
+**Q**: 관측(logging/metrics/tracing)은?
+**힌트**: OpenTelemetry, Datadog, Honeycomb, Grafana.
+
+### O9. error-handling
+**Q**: 에러 응답 포맷 표준이 있나요?
+**힌트**: RFC 7807 (Problem Details), 자체 포맷.
+
+### O10. data-retention
+**Q**: 데이터 보존/삭제 정책은?
+
+### O11. backup-recovery
+**Q**: 백업/복구 전략은?
+**힌트**: RPO/RTO 목표.
+
+### O12. compliance
+**Q**: 규제 준수 요구가 있나요?
+**힌트**: GDPR, HIPAA, PCI-DSS, SOC2.
+
+### O13. multi-tenant
+**Q**: 멀티테넌트 구조인가요?
+**힌트**: Shared DB / DB-per-tenant / Schema 분리.
+
+### O14. testing-strategy
+**Q**: 테스트 전략은?
+**힌트**: 계약 테스트(Pact), 통합 테스트, 부하 테스트(k6).
+
+### O15. deployment
+**Q**: 배포 방식은?
+**힌트**: Docker, Kubernetes, Serverless, Blue-Green, Canary.

package/skills/vibe.interview/checklists/feature.md

@@ -0,0 +1,88 @@
+# Discovery Checklist: Feature (기존 프로젝트에 추가)
+
+> 이미 존재하는 프로젝트에 **새 기능 추가**하거나 **기존 기능 확장**.
+> 체크리스트는 타입(website/webapp/mobile/api/library)과 겹치는 부분이 많으므로, 이 문서는 **"기존 프로젝트 컨텍스트 파악"**에 집중.
+
+## Required
+
+### R1. feature-purpose
+**Q**: 어떤 기능을 추가하려 하시나요? 왜 필요한가요?
+**힌트**: 사용자 관점에서 "무엇을 할 수 있게 되는지".
+
+### R2. existing-project-context
+**Q**: 기존 프로젝트의 기술 스택을 확인했나요?
+**힌트**: CLAUDE.md, package.json, .claude/vibe/config.json 읽어서 자동 파악.
+**follow-up**: 파악 결과를 사용자에게 요약해 확인 받기.
+
+### R3. affected-areas
+**Q**: 이 기능이 영향을 주는 영역은 어디인가요?
+**힌트**: 예) UI만, API만, DB 스키마 변경, 인증 시스템, 다수 모듈.
+**follow-up**: "기존 코드 중 건드려야 할 파일/모듈을 대략 알려주시면 좋아요."
+
+### R4. user-flow
+**Q**: 사용자가 이 기능을 쓰는 흐름은 어떻게 되나요?
+**힌트**: 1단계씩. "사용자가 X 화면에서 Y 버튼을 누르면 → Z가 일어난다."
+
+### R5. data-change
+**Q**: 새 데이터 모델이 필요한가요? 기존 모델을 변경하나요?
+**힌트**: 새 테이블/컬럼, 마이그레이션 필요 여부.
+
+### R6. integration-with-existing
+**Q**: 기존 기능과 어떻게 통합되나요?
+**힌트**: 새 기능이 기존 X 기능을 확장/대체/보완.
+
+### R7. success-metric
+**Q**: 이 기능이 "성공했다"고 판단할 기준은?
+**힌트**: 사용자 채택률, 특정 액션 수, 에러율 감소.
+
+## Optional
+
+### O1. backwards-compatibility
+**Q**: 하위 호환성을 지켜야 하나요?
+**힌트**: 기존 사용자 데이터/설정이 깨지면 안 되는 수준.
+
+### O2. feature-flag
+**Q**: 기능 플래그로 점진 출시할 건가요?
+**힌트**: 전체 / 베타 사용자만 / A/B 테스트 / 하드 스위치.
+
+### O3. migration-path
+**Q**: 기존 사용자를 위한 마이그레이션 경로가 필요한가요?
+**힌트**: 데이터 변환, 설정 이전, 공지 기간.
+
+### O4. rollback-plan
+**Q**: 롤백 계획이 있나요?
+**힌트**: DB 마이그레이션 가역성, 이전 버전 유지.
+
+### O5. existing-tests
+**Q**: 기존 테스트를 깨뜨리지 않고 추가할 수 있나요?
+**힌트**: 영향받는 테스트 파일, 새로 추가할 테스트.
+
+### O6. performance-impact
+**Q**: 성능 영향을 예상하나요?
+**힌트**: 빌드 크기, 런타임 속도, DB 쿼리 추가.
+
+### O7. security-impact
+**Q**: 보안 관점 검토가 필요한가요?
+**힌트**: 새 권한, 인증 플로우 변경, 외부 데이터 노출.
+
+### O8. documentation-update
+**Q**: 기존 문서를 업데이트해야 하나요?
+**힌트**: README, API docs, 사용자 가이드.
+
+### O9. ui-consistency
+**Q**: 기존 디자인 시스템과 일관되어야 하나요? (UI 기능)
+**힌트**: 예) 기존 컴포넌트 재사용, 새 컴포넌트 최소화.
+
+### O10. dependency-change
+**Q**: 새 의존성이 추가되나요?
+**힌트**: 번들 크기, 라이선스 호환, 유지보수 가능성.
+
+### O11. observability
+**Q**: 새 메트릭/로그가 필요한가요?
+
+### O12. notification-to-users
+**Q**: 기존 사용자에게 공지가 필요한가요?
+**힌트**: 릴리즈 노트, 인앱 배너, 이메일.
+
+### O13. training-docs
+**Q**: 팀/고객 교육 자료가 필요한가요?

package/skills/vibe.interview/checklists/library.md

@@ -0,0 +1,95 @@
+# Discovery Checklist: Library / SDK / CLI
+
+> npm 패키지, Python 라이브러리, CLI 도구, SDK 등 **재사용 가능한 코드 단위**.
+
+## Required
+
+### R1. purpose
+**Q**: 이 라이브러리/SDK/CLI가 해결하는 문제는?
+**힌트**: 한 문장으로. "X 없이 Y 하기 어려웠는데, 이게 해결."
+
+### R2. target-users
+**Q**: 누가 사용하나요?
+**힌트**: 예) 프론트엔드 개발자, Python 데이터 분석가, DevOps 엔지니어.
+**follow-up**: "사용자의 기술 수준은?"
+
+### R3. core-api
+**Q**: 핵심 API 표면은 어떻게 생겼나요?
+**힌트**: 예) `import { foo } from 'lib'; foo(x).then(...)`. 1-2줄 사용 예시.
+
+### R4. language-platform
+**Q**: 어느 언어/플랫폼 대상인가요?
+**힌트**: JS/TS (Node/Browser/Deno/Bun), Python, Go, Rust, 범용 CLI.
+
+### R5. distribution
+**Q**: 어떻게 배포하나요?
+**힌트**: npm, PyPI, crates.io, Homebrew, 직접 다운로드.
+
+### R6. license
+**Q**: 라이선스는?
+**힌트**: MIT, Apache 2.0, GPL, 독점.
+
+### R7. success-metric
+**Q**: 성공 기준은?
+**힌트**: 다운로드 수, GitHub stars, 사용자 피드백, 특정 프로젝트 적용.
+
+## Optional
+
+### O1. dependency-policy
+**Q**: 의존성 정책이 있나요?
+**힌트**: zero-dep / minimal / 자유롭게.
+
+### O2. bundle-size
+**Q**: 번들 크기 목표가 있나요? (JS 라이브러리)
+**힌트**: 예) < 10KB gzipped.
+
+### O3. tree-shaking
+**Q**: Tree-shaking 지원이 필요한가요?
+**힌트**: Named exports, ESM-first.
+
+### O4. typescript-support
+**Q**: TypeScript 타입 정의가 필요한가요?
+**힌트**: 내장, @types 패키지, 없음.
+
+### O5. ssr-browser-support
+**Q**: SSR/Browser 양쪽 지원이 필요한가요? (JS)
+
+### O6. api-stability
+**Q**: API 안정성 약속은?
+**힌트**: SemVer 엄격 준수, 실험적, pre-1.0.
+
+### O7. testing-coverage
+**Q**: 테스트 커버리지 목표는?
+**힌트**: 예) 90%+, unit only, integration 포함.
+
+### O8. documentation-style
+**Q**: 문서 스타일은?
+**힌트**: README 위주, 별도 docs site, JSDoc/TSDoc, Storybook.
+
+### O9. examples
+**Q**: 예제/템플릿을 얼마나 제공할 것인가요?
+**힌트**: Quickstart, Recipes, Playground, CodeSandbox 링크.
+
+### O10. versioning-policy
+**Q**: 버저닝 정책은?
+**힌트**: SemVer, CalVer, 수동.
+
+### O11. changelog
+**Q**: Changelog 관리 방식은?
+**힌트**: 수동, Changesets, semantic-release, Keep a Changelog.
+
+### O12. contributing
+**Q**: 외부 기여를 받을 계획인가요?
+**힌트**: 오픈 / CONTRIBUTING.md / CLA 필요 / 내부 전용.
+
+### O13. ci-tests
+**Q**: CI에서 어떤 검증을 돌리나요?
+**힌트**: 다중 Node 버전, 다중 OS, 다중 패키지 매니저.
+
+### O14. deprecation-policy
+**Q**: 기능 제거 정책이 있나요?
+**힌트**: N버전 warning 후 제거, 즉시 제거 금지.
+
+### O15. telemetry
+**Q**: 텔레메트리/사용 통계를 수집하나요?
+**힌트**: opt-in, opt-out, 없음. 프라이버시 고지 필요.