@su-record/vibe 2.9.2 → 2.9.3

package/vibe/templates/claudemd-template.md

@@ -0,0 +1,74 @@
+# VIBE
+
+> **vibe = Easy vibe coding + Minimum quality guaranteed**
+
+## Constraints
+
+- **Modify only requested scope** — Don't touch unrelated code
+- **Preserve existing style** — Follow project conventions
+- **Edit existing files, never create new ones** — Fix problems at source
+
+### Complexity Limits
+
+| Metric | Limit |
+|--------|-------|
+| Function length | ≤50 lines |
+| Nesting depth | ≤3 levels |
+| Parameters | ≤5 |
+| Cyclomatic complexity | ≤10 |
+
+### Forbidden Patterns
+
+- No `console.log` in commits
+- No hardcoded strings/numbers (use constants)
+- No commented-out code
+- No `any` type — use `unknown` + type guards
+
+## Project Structure
+
+| Folder | Owner | Purpose |
+|--------|-------|---------|
+| `src/` | Human+AI | Business logic |
+| `docs/` | **Human** | Business rules, domain definitions, ADR — **read before starting work** |
+| `tests/` | Human+AI | Test infrastructure |
+| `.dev/` | **AI** | Learnings, troubleshooting logs, scratch files |
+| `.claude/` | AI | Configuration, rules, skills |
+
+## References
+
+- **Rules**: See `.claude/vibe/config.json` → `references.rules[]`
+- **Language standards**: See `.claude/vibe/languages/`
+- **Constitution**: See `.claude/vibe/constitution.md`
+
+## Workflow
+
+| Task Size | Approach |
+|-----------|----------|
+| 1-2 files | Plan Mode |
+| 3+ files | `/vibe.spec` — single entry point, orchestrates everything |
+| Analyze target | `/vibe.analyze` — code, documents, websites, Figma |
+| Check Harness | `/vibe.harness` — diagnose project maturity |
+| Project structure | `/vibe.scaffold` — generate optimized folder structure |
+
+## Magic Keywords
+
+| Keyword | Effect |
+|---------|--------|
+| `ultrawork` / `ulw` | Parallel agents + auto-continue |
+| `ralph` | Iterate until 100% complete |
+| `quick` | Fast mode, minimal verification |
+
+## Quality Gate
+
+Convergence Principle: loop until P1 = 0. Changed files only.
+
+## Context Management
+
+At 70%+ context: `save_memory` → `/new` → `/vibe.utils --continue`
+
+## Git Commit Rules
+
+**Include:** `.claude/vibe/plans/`, `.claude/vibe/specs/`, `.claude/vibe/features/`, `.claude/vibe/config.json`, `CLAUDE.md`
+**Exclude:** `~/.claude/vibe/rules/`, `~/.claude/commands/`, `~/.claude/agents/`, `~/.claude/skills/`, `.claude/settings.local.json`
+
+<!-- VIBE:END -->

package/vibe/templates/constitution-template.md

@@ -60,6 +60,21 @@ All reference documents are stored globally and specified in `.claude/vibe/confi
 
 ---
 
+## Project Structure
+
+### Human vs AI Document Separation
+
+| Folder | Owner | Purpose |
+|--------|-------|---------|
+| `docs/` | **Human** | Business rules, domain definitions, ADR, API specs |
+| `.dev/` | **AI** | Learnings, troubleshooting logs, scratch/experiments |
+
+- **Before starting work**: Always check `docs/` for business context
+- **After solving issues**: Record learnings in `.dev/learnings/`
+- **Experiments**: Use `.dev/scratch/` (gitignored)
+
+---
+
 ## 1. Project Principles
 
 ### Values

package/vibe/templates/plan-template.md

@@ -0,0 +1,194 @@
+# PLAN: {Project or Feature Name}
+
+## Metadata
+
+- **Created**: {YYYY-MM-DD}
+- **Author**: {Name}
+- **Status**: DRAFT
+- **Type**: {website | webapp | mobile | api | feature | library}
+- **Language**: {ko | en}
+- **Downstream**: {spec | figma | both}
+
+---
+
+## 1. 개요 (Overview)
+
+> 한 줄 요약 — "무엇"인지 비전공자도 이해할 수 있게.
+
+{One-line summary}
+
+---
+
+## 2. 배경 (Why)
+
+**왜 만드는가?**
+
+{Motivation, problem being solved}
+
+**왜 지금인가?**
+
+{Trigger — what changed, new opportunity, user pain}
+
+---
+
+## 3. 타깃 사용자 (Who)
+
+**주요 사용자**
+
+- {Persona 1}: {상황, 니즈}
+- {Persona 2}: {상황, 니즈}
+
+**사용 맥락**
+
+- 언제: {when}
+- 어디서: {where}
+- 어떤 디바이스로: {device}
+
+---
+
+## 4. 목표 & 성공 기준 (Goals)
+
+**달성하려는 것**
+
+- {Goal 1}
+- {Goal 2}
+
+**성공 지표 (측정 가능)**
+
+| 지표 | 현재 | 목표 | 측정 방법 |
+|-----|-----|-----|---------|
+| {Metric 1} | {baseline} | {target} | {how} |
+
+---
+
+## 5. 핵심 기능/섹션 (What)
+
+**기능/섹션 리스트 (우선순위)**
+
+| 우선순위 | 항목 | 설명 |
+|--------|-----|-----|
+| Must | {Item 1} | {description} |
+| Must | {Item 2} | {description} |
+| Should | {Item 3} | {description} |
+| Could | {Item 4} | {description} |
+
+---
+
+## 6. 범위 (Scope)
+
+**이번 버전 포함**
+
+- {In-scope item 1}
+- {In-scope item 2}
+
+**제외 (Non-goals)**
+
+- {Out-of-scope item 1}
+- {Out-of-scope item 2}
+
+---
+
+## 7. Look & Feel
+
+> **UI 프로젝트에서만 작성.** API/라이브러리면 이 섹션 생략.
+
+**분위기/톤**
+
+- {e.g., "미니멀·시네마틱", "친근·유쾌"}
+
+**컬러 방향**
+
+- {e.g., "다크 + 네온 액센트", "파스텔 따뜻한 톤"}
+
+**타이포그래피**
+
+- {e.g., "Serif 헤드라인 + Sans 본문"}
+
+**레퍼런스**
+
+- {URL or 이미지 경로 1}: {무엇을 참고}
+- {URL or 이미지 경로 2}: {무엇을 참고}
+
+**애니메이션/인터랙션**
+
+- {e.g., "스크롤 기반 패럴랙스", "호버 시 부드러운 스케일"}
+
+---
+
+## 8. 레이아웃/섹션 구성
+
+> **UI 프로젝트에서만 작성.**
+
+| 순서 | 섹션 | 목적 | 핵심 콘텐츠 |
+|-----|-----|-----|-----------|
+| 1 | Hero | 첫인상, 브랜드 임팩트 | 타이틀, 서브카피, CTA |
+| 2 | {Section} | {purpose} | {content} |
+| 3 | {Section} | {purpose} | {content} |
+
+---
+
+## 9. 반응형 전략
+
+> **UI 프로젝트에서만 작성.**
+
+**디바이스 우선순위**
+
+- {e.g., "Desktop first — 주 사용자는 PC", "Mobile first — SNS 유입"}
+
+**브레이크포인트**
+
+- Mobile: {width}
+- Tablet: {width}
+- Desktop: {width}
+
+---
+
+## 10. 기술 스택 & 제약
+
+**선호 스택**
+
+- Frontend: {framework}
+- Backend: {framework}
+- DB: {database}
+- Hosting: {platform}
+
+**제약사항**
+
+- 성능: {e.g., "LCP < 2.5s"}
+- 브라우저: {e.g., "최신 2버전"}
+- 접근성: {e.g., "WCAG AA"}
+- 예산: {e.g., "월 $0 (free tier)"}
+
+---
+
+## 11. 가정 & 리스크
+
+**가정한 것**
+
+| # | 가정 | 검증 방법 | 틀렸을 때 리스크 |
+|---|-----|---------|--------------|
+| 1 | {assumption} | {how to validate} | {risk} |
+
+**알려진 리스크**
+
+- {Risk 1}: {mitigation}
+- {Risk 2}: {mitigation}
+
+---
+
+## 12. 다음 단계 (Handoff)
+
+이 기획서로 아래 워크플로를 시작할 수 있습니다:
+
+| 커맨드 | 결과물 |
+|-------|------|
+| `/vibe.spec "{feature}"` | AI 구현용 코드 명세 → `/vibe.run`으로 기능 구현 |
+| `/vibe.figma` | Figma 디자인 → 프로덕션 UI 코드 |
+| 두 가지 병렬 실행 | 기능 + 디자인 → 웹사이트 프로토타입 |
+
+**권장 순서**
+
+1. `/vibe.spec "{feature}"` → 기능 구조 + API + 데이터 모델 확정
+2. `/vibe.figma` (스토리보드 Phase에서 이 기획서를 참고) → 비주얼 디자인
+3. `/vibe.run "{feature}"` → 구현
+4. 통합 검증 → 프로토타입 완성