@su-record/vibe 2.6.34 → 2.6.41

package/vibe/config.json

@@ -1,30 +1,30 @@
-{
-  "models": {
-    "gpt": {
-      "enabled": false,
-      "authType": "oauth",
-      "role": "architecture",
-      "description": "Architecture/Debugging (GPT 5.2)"
-    },
-    "gemini": {
-      "enabled": false,
-      "authType": "oauth",
-      "role": "exploration",
-      "description": "Gemini 3 Flash/Pro (Exploration, UI/UX)"
-    }
-  },
-  "stacks": [
-    {
-      "type": "typescript-node",
-      "path": ""
-    }
-  ],
-  "details": {
-    "databases": [
-      "SQLite"
-    ],
-    "stateManagement": [],
-    "hosting": [],
-    "cicd": []
-  }
+{
+  "models": {
+    "gpt": {
+      "enabled": false,
+      "authType": "oauth",
+      "role": "architecture",
+      "description": "Architecture/Debugging (GPT 5.2)"
+    },
+    "gemini": {
+      "enabled": false,
+      "authType": "oauth",
+      "role": "exploration",
+      "description": "Gemini 3 Flash/Pro (Exploration, UI/UX)"
+    }
+  },
+  "stacks": [
+    {
+      "type": "typescript-node",
+      "path": ""
+    }
+  ],
+  "details": {
+    "databases": [
+      "SQLite"
+    ],
+    "stateManagement": [],
+    "hosting": [],
+    "cicd": []
+  }
 }

package/vibe/constitution.md

@@ -29,9 +29,9 @@ All reference documents are stored globally and specified in `.claude/vibe/confi
 {
   "references": {
     "rules": [
-      "~/.claude/vibe/rules/core/quick-start.md",
-      "~/.claude/vibe/rules/core/development-philosophy.md",
-      "~/.claude/vibe/rules/core/communication-guide.md",
+      "~/.claude/vibe/rules/principles/quick-start.md",
+      "~/.claude/vibe/rules/principles/development-philosophy.md",
+      "~/.claude/vibe/rules/principles/communication-guide.md",
       "~/.claude/vibe/rules/quality/checklist.md",
       "~/.claude/vibe/rules/quality/bdd-contract-testing.md",
       "~/.claude/vibe/rules/quality/testing-strategy.md",

package/vibe/rules/quality/bdd-contract-testing.md

@@ -214,33 +214,33 @@ def test_login_contract():
 
 ---
 
-## 4. Vibe Commands
+## 4. Core Commands
 
 ### Generate Feature File
 
 ```bash
-vibe feature "user login"
+core feature "user login"
 # → Creates .claude/vibe/features/user-login.feature
 ```
 
 ### Generate Contract Test
 
 ```bash
-vibe contract "user login"
+core contract "user login"
 # → Creates tests/contract/test_user_login_contract.py
 ```
 
 ### Run Tests
 
 ```bash
-vibe test "user login"
+core test "user login"
 # → Runs BDD + Contract tests
 ```
 
 ### Verify
 
 ```bash
-vibe verify "user login"
+core verify "user login"
 # → Confirms 100% SPEC Acceptance Criteria met
 ```
 
@@ -387,7 +387,7 @@ BDD + Contract Testing enables **AI agents to accurately implement SPECs and aut
 **Usage in Vibe**:
 
 ```bash
-vibe spec "feature" → vibe feature "feature" → vibe contract "feature" → vibe run
+core spec "feature" → core feature "feature" → core contract "feature" → core run
 ```
 
 **Test-First → AI Implementation → Verify → Done** 🎉

package/vibe/rules/quality/performance.md

@@ -0,0 +1,236 @@
+# Performance Standards
+
+> 성능은 사후 최적화가 아니라 설계 단계부터 고려해야 한다.
+
+## 1. 프론트엔드 최적화
+
+### React 메모이제이션 기준
+
+| Hook/API | 사용 기준 | 사용하지 않을 때 |
+|----------|----------|----------------|
+| `React.memo` | props가 자주 같은 값으로 전달되는 컴포넌트 | 항상 다른 props를 받는 컴포넌트 |
+| `useMemo` | 계산 비용이 높은 파생 데이터 | 단순 참조나 원시값 |
+| `useCallback` | 자식 컴포넌트에 전달되는 콜백 함수 | 인라인으로만 사용되는 핸들러 |
+
+```typescript
+// ❌ Bad: 불필요한 메모이제이션
+const name = useMemo(() => user.name, [user.name]); // 단순 참조
+
+// ✅ Good: 비용이 높은 계산에만 적용
+const sortedItems = useMemo(
+  () => items.sort((a, b) => a.price - b.price),
+  [items]
+);
+
+// ❌ Bad: 매 렌더마다 새 객체 생성 → 자식 리렌더
+<ChildComponent style={{ color: "red" }} />
+
+// ✅ Good: 스타일 객체 메모이제이션 또는 외부 선언
+const style = useMemo(() => ({ color: "red" }), []);
+<ChildComponent style={style} />
+```
+
+### 번들 크기 최적화
+
+- 목표: Production gzip 기준 initial JS **200KB 이하** (next build output 또는 bundle analyzer로 측정)
+- 코드 스플리팅: `React.lazy` + `Suspense`로 경로별 분할
+- 트리 쉐이킹: barrel import 회피, 개별 모듈 직접 import
+
+```typescript
+// ❌ Bad: barrel import → 전체 번들 포함
+import { Button, Icon, Modal } from "@/components";
+
+// ✅ Good: 직접 import → 트리 쉐이킹 가능
+import { Button } from "@/components/Button";
+import { Icon } from "@/components/Icon";
+
+// ❌ Bad: 동적 로딩 없이 무거운 컴포넌트 직접 import
+import HeavyChart from "@/components/HeavyChart";
+
+// ✅ Good: 동적 import로 코드 스플리팅
+const HeavyChart = lazy(() => import("@/components/HeavyChart"));
+```
+
+### 이미지 최적화
+
+- WebP/AVIF 포맷 우선 사용
+- `loading="lazy"` 속성으로 뷰포트 밖 이미지 지연 로딩
+- Next.js의 `next/image` 컴포넌트 활용 (자동 최적화)
+- 적절한 `width`/`height` 속성으로 CLS 방지
+
+```typescript
+// ❌ Bad: 최적화 없는 이미지
+<img src="/photo.jpg" />
+
+// ✅ Good: 최적화된 이미지
+import Image from "next/image";
+<Image src="/photo.jpg" alt="설명" width={800} height={600} loading="lazy" />
+```
+
+## 2. 백엔드 최적화
+
+### DB 인덱스 설계 원칙
+
+1. **WHERE/JOIN 대상 컬럼**에 인덱스 생성
+2. **복합 인덱스** 순서: 선택도(cardinality)가 높은 컬럼을 앞에 배치
+3. **커버링 인덱스**: SELECT 컬럼까지 인덱스에 포함하면 테이블 스캔 회피
+
+```sql
+-- ❌ Bad: 인덱스 없이 빈번한 조회
+SELECT * FROM orders WHERE user_id = ? AND status = 'pending';
+
+-- ✅ Good: 복합 인덱스 생성
+CREATE INDEX idx_orders_user_status ON orders (user_id, status);
+```
+
+### N+1 쿼리 방지
+
+```typescript
+// ❌ Bad: N+1 쿼리 (users 수만큼 추가 쿼리)
+const users = await db.users.findAll();
+for (const user of users) {
+  user.orders = await db.orders.findByUserId(user.id);
+}
+
+// ✅ Good: Eager Loading (JOIN 또는 IN 쿼리)
+const users = await db.users.findAll({
+  include: [{ model: db.orders }],
+});
+
+// ✅ Good: 배치 쿼리
+const users = await db.users.findAll();
+const userIds = users.map((u) => u.id);
+const orders = await db.orders.findAll({ where: { userId: userIds } });
+```
+
+### 캐싱 전략
+
+| 데이터 유형 | TTL 기준 | 캐시 레벨 |
+|------------|---------|----------|
+| 정적 설정 | 1시간~24시간 | 메모리(LRU) |
+| 사용자 세션 | 30분~2시간 | Redis/메모리 |
+| API 응답 | 1분~10분 | HTTP 캐시 헤더 |
+| DB 쿼리 결과 | 5분~30분 | 애플리케이션 레벨 |
+
+```typescript
+// ❌ Bad: 매 요청마다 DB 조회
+app.get("/api/config", async (req, res) => {
+  const config = await db.config.findAll();
+  res.json(config);
+});
+
+// ✅ Good: 캐시 적용
+const cache = new Map<string, { data: unknown; expiry: number }>();
+
+app.get("/api/config", async (req, res) => {
+  const cached = cache.get("config");
+  if (cached && cached.expiry > Date.now()) {
+    return res.json(cached.data);
+  }
+  const config = await db.config.findAll();
+  cache.set("config", { data: config, expiry: Date.now() + 3600000 });
+  res.json(config);
+});
+```
+
+### API 최적화
+
+- 응답 압축 (gzip/brotli) 활성화
+- 적절한 캐시 헤더 (`Cache-Control`, `ETag`)
+- 페이지네이션 필수 (기본 limit 20~50)
+- 불필요한 필드 제외 (SELECT * 지양)
+
+## 3. 알고리즘 복잡도
+
+### 경고 기준
+
+| 복잡도 | 판정 | 대응 |
+|--------|------|------|
+| O(1), O(log n) | 양호 | - |
+| O(n) | 양호 | 데이터 크기 주의 |
+| O(n log n) | 주의 | 정렬 등 불가피한 경우만 |
+| O(n²) 이상 | **경고** | 반드시 대안 검토 |
+
+```typescript
+// ❌ Bad: O(n²) 중첩 루프
+function findDuplicates(arr: string[]): string[] {
+  const result: string[] = [];
+  for (let i = 0; i < arr.length; i++) {
+    for (let j = i + 1; j < arr.length; j++) {
+      if (arr[i] === arr[j]) result.push(arr[i]);
+    }
+  }
+  return result;
+}
+
+// ✅ Good: O(n) Set 활용
+function findDuplicates(arr: string[]): string[] {
+  const seen = new Set<string>();
+  const dupes = new Set<string>();
+  for (const item of arr) {
+    if (seen.has(item)) dupes.add(item);
+    seen.add(item);
+  }
+  return [...dupes];
+}
+```
+
+- 배열 탐색 → `Set`/`Map` 사용 (O(1) lookup)
+- 정렬 후 이진 탐색 → O(n log n + log n) vs O(n) 비교
+- 중첩 루프 → `Map` 기반 인덱싱으로 평탄화
+
+## 4. Web Vitals 기준
+
+> 출처: Google Web.dev — Lighthouse 모바일 프리셋 측정 기준
+
+| 지표 | 기준 (Good) | 의미 |
+|------|------------|------|
+| LCP (Largest Contentful Paint) | < 2.5s | 주요 콘텐츠 렌더링 시간 |
+| INP (Interaction to Next Paint) | < 200ms | 사용자 인터랙션 반응 시간 |
+| CLS (Cumulative Layout Shift) | < 0.1 | 레이아웃 흔들림 정도 |
+
+### LCP 최적화
+
+- 주요 이미지에 `priority` 속성 또는 `fetchpriority="high"` 적용
+- 폰트 `preload` 설정
+- 서버 응답 시간 최소화 (TTFB < 800ms)
+
+### INP 최적화
+
+- 무거운 이벤트 핸들러는 `requestIdleCallback` 또는 Web Worker로 분리
+- `startTransition`으로 비긴급 UI 업데이트 지연
+
+### CLS 최적화
+
+- 이미지/비디오에 `width`/`height` 명시
+- 동적 콘텐츠 삽입 시 공간 사전 확보
+- 폰트 로딩 전략: `font-display: swap` + `size-adjust`
+
+## 5. 성능 체크리스트
+
+### 프론트엔드
+
+- [ ] O(n²) 이상 알고리즘 검토
+- [ ] 불필요한 리렌더링 제거
+- [ ] `React.memo`/`useMemo`/`useCallback` 적절 적용
+- [ ] 번들 사이즈 200KB 이하 (initial JS, gzip)
+- [ ] 이미지 lazy loading 적용
+- [ ] 코드 스플리팅 적용
+- [ ] Web Vitals 기준 충족 (LCP < 2.5s, INP < 200ms, CLS < 0.1)
+
+### 백엔드
+
+- [ ] DB 쿼리에 적절한 인덱스 존재
+- [ ] N+1 쿼리 없음
+- [ ] 캐싱 전략 적용
+- [ ] 페이지네이션 구현
+- [ ] 응답 압축 활성화
+- [ ] 불필요한 SELECT * 제거
+
+### 공통
+
+- [ ] 알고리즘 복잡도 O(n²) 이상 항목 없음 또는 대안 문서화
+- [ ] 대량 데이터 처리 시 스트리밍/청크 처리 적용
+- [ ] 메모리 누수 점검 (이벤트 리스너 해제, 타이머 정리)
+
+> **vibe 도구 연계**: `core_analyze_complexity`로 함수 복잡도 측정, `/vibe.review`의 performance-reviewer 에이전트로 자동 성능 리뷰

package/vibe/rules/standards/git-workflow.md

@@ -0,0 +1,237 @@
+# Git Workflow Standards
+
+> 일관된 Git 워크플로우는 협업 효율과 코드 품질의 기반이다.
+
+## 1. 브랜치 전략
+
+```
+main (또는 master)
+  └── develop
+       ├── feature/기능명     ← 새 기능
+       ├── fix/버그명          ← 버그 수정
+       ├── refactor/대상      ← 리팩토링
+       ├── docs/문서명         ← 문서 작업
+       ├── test/테스트대상     ← 테스트 추가
+       └── chore/작업명        ← 빌드/설정
+```
+
+### 브랜치 네이밍 규칙
+
+| 유형 | 패턴 | 예시 |
+|------|------|------|
+| 기능 | `feature/기능명` | `feature/login-form` |
+| 버그 | `fix/버그명` | `fix/null-pointer-error` |
+| 리팩토링 | `refactor/대상` | `refactor/auth-module` |
+| 문서 | `docs/문서명` | `docs/api-guide` |
+| 테스트 | `test/대상` | `test/payment-flow` |
+| 설정 | `chore/작업명` | `chore/eslint-config` |
+
+## 2. Conventional Commits (한국어 형식)
+
+### 커밋 메시지 구조
+
+```
+[타입] 제목 (50자 이내)
+
+본문 (선택, 72자 줄바꿈)
+- 무엇을 변경했는지
+- 왜 변경했는지
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+```
+
+### 커밋 타입
+
+| 타입 | 설명 | 예시 |
+|------|------|------|
+| `feat` | 새 기능 추가 | `[feat] 로그인 폼 구현` |
+| `fix` | 버그 수정 | `[fix] 이메일 유효성 검증 오류 수정` |
+| `docs` | 문서 변경 | `[docs] API 사용 가이드 추가` |
+| `style` | 포맷팅 (코드 변경 없음) | `[style] ESLint 규칙 적용` |
+| `refactor` | 리팩토링 | `[refactor] 인증 모듈 구조 개선` |
+| `test` | 테스트 추가/수정 | `[test] 결제 플로우 E2E 테스트 추가` |
+| `chore` | 빌드, 설정 변경 | `[chore] CI 파이프라인 설정` |
+| `perf` | 성능 개선 | `[perf] 목록 렌더링 최적화` |
+
+### 커밋 메시지 예시
+
+```bash
+# ✅ Good: 명확한 의도와 이유
+[feat] 소셜 로그인 (Google OAuth) 추가
+
+- Google OAuth 2.0 인증 플로우 구현
+- 기존 이메일 계정과 자동 연결 지원
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+```
+
+```bash
+# ✅ Good: 간결하지만 충분한 정보
+[fix] 비밀번호 재설정 토큰 만료 검증 누락 수정
+```
+
+```bash
+# ❌ Bad: 모호한 메시지
+[fix] 버그 수정
+```
+
+```bash
+# ❌ Bad: 영어 + 의미 불명확
+Updated stuff
+```
+
+```bash
+# ❌ Bad: 너무 긴 제목 (50자 초과)
+[feat] 사용자 프로필 페이지에서 아바타 업로드 기능 추가하고 이미지 리사이징 및 크롭 처리
+```
+
+### Co-Authored-By 규칙
+
+- AI가 생성/수정한 코드에는 반드시 `Co-Authored-By` 추가
+- Claude 사용 시: `Co-Authored-By: Claude <noreply@anthropic.com>`
+- 여러 기여자가 있는 경우 각각 별도 줄로 추가
+
+## 3. PR 체크리스트
+
+PR 생성 시 반드시 확인:
+
+### 필수 항목
+
+- [ ] 테스트 통과 (unit + integration)
+- [ ] 린트 통과 (ESLint/Prettier)
+- [ ] 타입 체크 통과 (tsc --noEmit)
+- [ ] 빌드 성공
+- [ ] 리뷰어 최소 1명 지정
+- [ ] 관련 이슈 연결 (`Closes #123`)
+
+### 권장 항목
+
+- [ ] CI 파이프라인 전체 통과
+- [ ] 코드 커버리지 감소 없음
+- [ ] 변경 사항 스크린샷/GIF 첨부 (UI 변경 시)
+- [ ] 마이그레이션 필요 시 마이그레이션 스크립트 포함
+- [ ] 환경 변수 추가 시 `.env.example` 업데이트
+- [ ] Breaking change 시 명시적 안내
+
+### PR 제목 형식
+
+```bash
+# ✅ Good
+[feat] 소셜 로그인 기능 추가 (#123)
+
+# ✅ Good
+[fix] 결제 프로세스 타임아웃 오류 수정
+
+# ❌ Bad
+Update code
+
+# ❌ Bad
+fix
+```
+
+### PR 본문 템플릿
+
+```markdown
+## 변경 사항
+- [주요 변경 내용 목록]
+
+## 관련 이슈
+- Closes #123
+
+## 테스트
+- [테스트 방법 및 결과]
+
+## 스크린샷
+(UI 변경 시)
+```
+
+## 4. 금지사항
+
+### 절대 금지
+
+| 금지 항목 | 이유 |
+|----------|------|
+| main/master에 직접 push | 리뷰 없이 프로덕션 코드 변경 위험 |
+| `--force` push (특별한 경우 제외) | 다른 개발자의 변경사항 유실 위험 |
+| `.env` 파일 커밋 | 시크릿 노출 위험 |
+| `credentials.json` 커밋 | 인증 정보 노출 위험 |
+| 대용량 바이너리 커밋 | 저장소 크기 증가, 클론 속도 저하 |
+| `node_modules/` 커밋 | 불필요한 의존성 추적 |
+
+### 주의 항목
+
+| 주의 항목 | 가이드 |
+|----------|--------|
+| rebase | 공유 브랜치에서는 사용 금지, 로컬 브랜치에서만 사용 |
+| cherry-pick | 커밋 이력 일관성 고려, 필요 시 기록 남기기 |
+| squash merge | PR 단위 이력 관리가 필요할 때 사용 |
+
+```bash
+# ❌ Bad: force push
+git push --force origin main
+
+# ✅ Good: force-with-lease (안전한 대안)
+git push --force-with-lease origin feature/my-branch
+```
+
+## 5. `.gitignore` 필수 항목
+
+```gitignore
+# 환경 변수
+.env
+.env.local
+.env.*.local
+
+# 의존성
+node_modules/
+
+# 빌드 산출물
+dist/
+build/
+.next/
+
+# IDE 설정
+.vscode/settings.json
+.idea/
+
+# OS 파일
+.DS_Store
+Thumbs.db
+
+# 인증/시크릿
+*.pem
+credentials.json
+service-account.json
+```
+
+## 6. Git Hooks 권장 설정
+
+```json
+// package.json (husky + lint-staged)
+{
+  "lint-staged": {
+    "*.{ts,tsx}": ["eslint --fix", "prettier --write"],
+    "*.{json,md}": ["prettier --write"]
+  }
+}
+```
+
+- **pre-commit**: 린트 + 포맷팅 자동 적용
+- **commit-msg**: 커밋 메시지 형식 검증
+- **pre-push**: 테스트 실행
+
+## 7. 릴리스 태깅
+
+```bash
+# 시맨틱 버저닝 (SemVer)
+git tag -a v1.2.3 -m "[release] v1.2.3 — 소셜 로그인 기능"
+git push origin v1.2.3
+```
+
+| 버전 | 변경 유형 |
+|------|----------|
+| Major (1.x.x) | Breaking changes |
+| Minor (x.1.x) | 새 기능 (하위 호환) |
+| Patch (x.x.1) | 버그 수정 |
+
+> **vibe 도구 연계**: `/vibe.review`의 git-history 에이전트가 커밋 이력과 워크플로우 규칙 준수를 자동 검증한다