@su-record/vibe 1.2.1 → 1.2.3

package/.claude/settings.local.json

@@ -30,7 +30,9 @@
       "Bash(fi)",
       "Bash(done)",
       "Bash(/Users/grove/workspace/vibe/bin/vibe update:*)",
-      "Bash(npm show:*)"
+      "Bash(npm show:*)",
+      "Bash(npm init:*)",
+      "Bash(git check-ignore:*)"
     ],
     "deny": [],
     "ask": []

package/CLAUDE.md

@@ -67,6 +67,36 @@ SPEC 문서는 AI가 바로 실행 가능한 프롬프트 형태:
 | `mcp__vibe__auto_save_context` | 현재 상태 저장 |
 | `mcp__vibe__save_memory` | 중요 결정사항 저장 |
 
+## 컨텍스트 관리 전략
+
+### 모델 선택
+- **탐색/검색**: Haiku (서브에이전트 기본값)
+- **구현/디버깅**: Sonnet
+- **아키텍처/복잡한 로직**: Opus
+
+### 문제 발생 시
+- `/compact` - 컨텍스트 압축
+- `/rewind` - 이전 시점으로 되돌리기
+- `/new` - 새 세션 시작
+- `/context` - 현재 사용량 확인
+
+### context7 활용
+최신 라이브러리 문서가 필요할 때 context7 MCP 사용:
+```
+"React 19 use() 훅을 context7으로 검색해줘"
+```
+
+## Git Commit 규칙
+
+**반드시 포함:**
+- `.claude/` 폴더 전체 (commands, agents, settings.json)
+- `.vibe/rules/`, `.vibe/specs/`, `.vibe/features/`
+- `CLAUDE.md`
+
+**제외:**
+- `.claude/settings.local.json` (개인 설정, 자동 제외)
+- `.vibe/mcp/` (node_modules, 자동 제외)
+
 ## Getting Started
 
 ```bash

package/README.md

@@ -182,25 +182,24 @@ Phase 1 → Phase 2 → Phase 3 → ... → Phase N
 
 ```
 project/
-├── CLAUDE.md                 # 프로젝트 컨텍스트
-├── .claude/
+├── CLAUDE.md                 # 프로젝트 컨텍스트        ← git 공유
+├── .claude/                  # ⚠️ 반드시 git에 커밋    ← git 공유
 │   ├── commands/             # 슬래시 커맨드 (7개)
-│   ├── agents/               # 서브에이전트 (simplifier)
-│   └── settings.json         # Hooks 설정
+│   ├── agents/               # 서브에이전트
+│   ├── settings.json         # Hooks 설정
+│   └── settings.local.json   # 개인 설정               ← git 제외 (자동)
 └── .vibe/
-    ├── config.json           # 프로젝트 설정
-    ├── constitution.md       # 프로젝트 원칙
-    ├── mcp/                   # hi-ai MCP (로컬 설치, .gitignore)
-    ├── rules/                 # 코딩 규칙
-    │   ├── core/              # 핵심 원칙
-    │   ├── quality/           # 품질 체크리스트
-    │   ├── standards/         # 복잡도, 네이밍
-    │   ├── languages/         # 언어별 규칙
-    │   └── tools/             # MCP 가이드
-    ├── specs/                 # SPEC 문서들
-    └── features/              # BDD Feature 파일들
+    ├── config.json           # 프로젝트 설정           ← git 공유
+    ├── constitution.md       # 프로젝트 원칙           ← git 공유
+    ├── mcp/                   # hi-ai MCP              ← git 제외 (node_modules)
+    ├── rules/                 # 코딩 규칙              ← git 공유
+    ├── specs/                 # SPEC 문서들            ← git 공유
+    └── features/              # BDD Feature 파일들     ← git 공유
 ```
 
+> **⚠️ 중요**: `.claude/` 폴더는 팀과 공유해야 합니다. 커밋 시 제외하지 마세요.
+> `settings.local.json`만 개인 설정이므로 자동으로 git에서 제외됩니다.
+
 ---
 
 ## SPEC Document (PTCF Structure)
@@ -323,6 +322,46 @@ AI의 역할과 전문성 정의
 - **메모리**: `save_memory`, `recall_memory`, `auto_save_context`
 - **UI**: `preview_ui_ascii`
 
+### context7 사용법
+
+최신 라이브러리 문서가 필요할 때:
+
+```
+"React 19의 use() 훅 사용법을 context7으로 검색해줘"
+"Next.js 15 App Router 문서를 확인해줘"
+```
+
+---
+
+## 컨텍스트 관리 팁
+
+### 모델 선택 전략
+
+| 작업 유형 | 권장 모델 | 이유 |
+|----------|----------|------|
+| 탐색/검색 | Haiku | 빠르고 저비용 |
+| 구현/디버깅 | Sonnet | 균형잡힌 성능 |
+| 아키텍처/복잡한 로직 | Opus | 최고 성능 |
+
+> vibe의 서브에이전트는 기본적으로 Haiku를 사용합니다. 고비용 모델이 필요 없는 탐색 작업을 저비용 모델에게 위임하는 전략입니다.
+
+### Claude Code 기본 명령어
+
+| 명령어 | 용도 |
+|--------|------|
+| `/compact` | 컨텍스트 압축 (70%+ 시 권장) |
+| `/context` | 현재 컨텍스트 사용량 확인 |
+| `/rewind` | 이전 시점으로 되돌리기 |
+| `/new` | 새 세션 시작 |
+| `Shift + Tab` | 플랜 모드 진입 |
+
+### 가치 밀도 높은 컨텍스트 유지
+
+1. **계획 먼저** - `/vibe.spec`으로 명확한 계획 수립
+2. **필요한 정보만** - 서브에이전트가 탐색하고 요약만 전달
+3. **자동 압축** - ULTRAWORK 모드에서 70%+ 시 자동 저장
+4. **Just-in-Time** - context7로 필요할 때만 문서 검색
+
 ---
 
 ## Example

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@su-record/vibe",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Vibe - Claude Code exclusive SPEC-driven AI coding framework",
   "bin": {
     "vibe": "./bin/vibe"