@su-record/vibe 0.4.2 → 0.4.4

package/.claude/commands/vibe.analyze.md

@@ -1,123 +1,235 @@
 ---
-description: Analyze project (code quality, architecture, dependencies)
-argument-hint: --code or --deps or --arch (optional)
+description: Analyze project or specific feature/module
+argument-hint: "기능명" or --code or --deps or --arch (optional)
 ---
 
 # /vibe.analyze
 
-프로젝트를 분석합니다 (코드 품질, 아키텍처, 의존성).
+프로젝트 또는 특정 기능/모듈을 분석합니다.
 
 ## Usage
 
 ```
-/vibe.analyze
-/vibe.analyze --code
-/vibe.analyze --deps
-/vibe.analyze --arch
+/vibe.analyze                  # 프로젝트 전체 품질 분석
+/vibe.analyze "로그인"          # 로그인 관련 코드 탐색 + 컨텍스트 수집
+/vibe.analyze --code           # 코드 품질 분석만
+/vibe.analyze --deps           # 의존성 분석만
+/vibe.analyze --arch           # 아키텍처 분석만
 ```
 
-## Process
+## ⚠️ 컨텍스트 리셋
 
-### 1. 분석 범위 확인
+**이 명령어가 실행되면 이전 대화 내용은 무시합니다.**
+- 새 세션처럼 처음부터 코드를 탐색하고 분석
+- 오직 이 분석에서 새로 수집한 정보만 기반으로 대화
 
-사용자가 지정한 옵션에 따라 분석 범위를 결정합니다:
+---
+
+## Mode 1: 기능/모듈 분석 (`/vibe.analyze "기능명"`)
+
+### 목표
+
+사용자가 요청한 기능/모듈과 관련된 **모든 소스코드를 탐색**하고 **플로우를 분석**하여:
+1. 현재 구현 상태 파악
+2. 코드 구조와 의존성 이해
+3. 이후 개발/수정 요청에 즉시 대응 가능한 컨텍스트 확보
+
+### Process
+
+#### 1. 요청 분석
+
+사용자 요청에서 핵심 키워드 추출:
+- 기능명 (예: 로그인, 피드, 결제)
+- 동작 (예: 작성, 조회, 수정, 삭제)
+- 범위 (예: 백엔드만, 프론트엔드만, 전체)
+
+#### 2. 프로젝트 구조 파악
+
+`CLAUDE.md`, `package.json`, `pyproject.toml` 등을 읽어 기술 스택 확인:
+
+**백엔드:**
+- FastAPI/Django: `app/api/`, `app/services/`, `app/models/`
+- Express/NestJS: `src/controllers/`, `src/services/`, `src/models/`
+
+**프론트엔드:**
+- React/Next.js: `src/components/`, `src/pages/`, `src/hooks/`
+- Flutter: `lib/screens/`, `lib/services/`, `lib/providers/`
+
+#### 3. 관련 코드 탐색
+
+**탐색 전략:**
+1. **Glob**으로 관련 파일 목록 수집
+2. **Grep**으로 키워드 기반 코드 위치 파악
+3. **Read**로 핵심 파일 상세 분석
+4. 필요시 **Task (Explore)** 에이전트로 병렬 탐색
+
+#### 4. 플로우 분석
+
+**API 플로우:**
+- 엔드포인트 URL 및 HTTP 메서드
+- 요청/응답 스키마
+- 인증/권한 요구사항
+
+**비즈니스 로직:**
+- 핵심 메서드와 역할
+- 유효성 검증 규칙
+- 외부 서비스 연동
+
+**데이터 플로우:**
+- 관련 테이블/모델
+- 관계 (1:N, N:M)
+- 주요 쿼리 패턴
+
+#### 5. 분석 결과 출력
+
+```markdown
+## 📊 [기능명] 분석 결과
+
+### 개요
+- **기능 설명**: [한 줄 요약]
+- **구현 상태**: [완료/진행중/미구현]
+- **관련 파일 수**: N개
+
+### 구조
+
+#### API 엔드포인트
+| 메서드 | 경로 | 설명 | 인증 |
+|--------|------|------|------|
+| POST | /api/v1/auth/login | 로그인 | - |
+
+#### 핵심 서비스
+- `auth_service.py`: 인증 로직
+  - `login()`: 로그인 처리
+  - `verify_token()`: 토큰 검증
+
+#### 데이터 모델
+- `User`: 사용자 테이블
+  - 주요 필드: id, email, password_hash
+  - 관계: Session (1:N)
+
+### 플로우 다이어그램
+[텍스트 기반 플로우 설명]
+
+### 참고 파일 목록
+- src/api/auth/router.py:L10-50
+- src/services/auth_service.py:L1-100
+```
+
+#### 6. 개발 규칙 확인
+
+`.agent/rules/`에서 관련 규칙 로드:
+- `core/quick-start.md` - 5가지 핵심 원칙
+- `standards/complexity-metrics.md` - 복잡도 기준
+- `quality/checklist.md` - 품질 체크리스트
+
+규칙 위반 사항이 있으면 함께 출력.
+
+#### 7. 완료
+
+분석 완료 후:
+1. 분석 결과 요약 출력
+2. "이제 어떤 작업을 도와드릴까요?" 질문
+3. 이후 개발/수정 요청에 수집된 컨텍스트 활용
+
+---
+
+## Mode 2: 프로젝트 품질 분석 (옵션 없음 또는 --code/--deps/--arch)
+
+### 분석 범위
 
 - **기본** (`/vibe.analyze`): 전체 분석 (코드 + 의존성 + 아키텍처)
 - **--code**: 코드 품질 분석만
 - **--deps**: 의존성 분석만
 - **--arch**: 아키텍처 분석만
 
-### 2. MCP 도구 사용
+### MCP 도구 사용
 
-다음 MCP 도구를 사용합니다 (`@su-record/hi-ai` 기반):
+`@su-record/hi-ai` 기반:
 
 #### 코드 품질 분석 (--code)
-- `mcp__su-record-hi-ai__analyze_complexity`: 복잡도 분석
-- `mcp__su-record-hi-ai__validate_code_quality`: 코드 품질 검증
-- `mcp__su-record-hi-ai__check_coupling_cohesion`: 결합도/응집도 체크
+- `analyze_complexity`: 복잡도 분석
+- `validate_code_quality`: 코드 품질 검증
+- `check_coupling_cohesion`: 결합도/응집도 체크
 
 #### 의존성 분석 (--deps)
 - `package.json` / `pyproject.toml` / `pubspec.yaml` 읽기
 - 버전 충돌, 보안 취약점, 업데이트 필요 패키지 분석
 
 #### 아키텍처 분석 (--arch)
-- `mcp__su-record-hi-ai__find_symbol`: 핵심 모듈 찾기
-- `mcp__su-record-hi-ai__find_references`: 모듈 간 의존성 파악
+- `find_symbol`: 핵심 모듈 찾기
+- `find_references`: 모듈 간 의존성 파악
 - 순환 의존성, 레이어 위반 검출
 
-### 3. 분석 리포트 생성
+### 분석 리포트
 
-`.vibe/reports/analysis-{date}.md` 파일에 분석 결과 저장:
+`.vibe/reports/analysis-{date}.md`:
 
 ```markdown
 # 프로젝트 분석 리포트
 
 ## 개요
-- 분석 일시: 2025-11-17 15:30
-- 분석 범위: 전체 (코드 + 의존성 + 아키텍처)
+- 분석 일시: 2025-01-06 12:00
+- 분석 범위: 전체
 
 ## 코드 품질 (85/100)
 - 평균 복잡도: 8.2 (양호)
 - 높은 복잡도 파일: 3개
-  - src/service.py (CC: 15)
-  - src/utils.py (CC: 12)
 
 ## 의존성 (92/100)
 - 총 패키지: 42개
 - 업데이트 필요: 3개
-  - express: 4.17.1 → 4.18.2
-  - lodash: 4.17.20 → 4.17.21 (보안)
 
 ## 아키텍처 (78/100)
 - 순환 의존성: 2개 발견
-  - A → B → C → A
 - 레이어 위반: 1개
-  - Controller가 직접 DB 접근
 
 ## 개선 제안
-1. service.py 리팩토링 (복잡도 15 → 10 이하)
+1. service.py 리팩토링
 2. lodash 보안 패치 적용
-3. 순환 의존성 제거
 ```
 
-### 4. 개선 제안
-
-분석 결과를 바탕으로 구체적인 개선 방안 제시:
-- 리팩토링이 필요한 파일 목록
-- 의존성 업데이트 명령어
-- 아키텍처 개선 방향
+---
 
 ## Example
 
+### 기능 분석
 ```
-User: /vibe.analyze --code
+User: /vibe.analyze "로그인"
 
-Claude: 코드 품질 분석을 시작합니다...
+Claude: 로그인 관련 코드를 분석합니다...
 
-[MCP 도구 사용]
-- analyze_complexity 실행 중...
-- validate_code_quality 실행 중...
-- check_coupling_cohesion 실행 중...
+[Glob, Grep, Read 도구로 코드 탐색]
 
-✅ 분석 완료!
+📊 로그인 분석 결과
+
+### 개요
+- 기능 설명: JWT 기반 사용자 인증
+- 구현 상태: 완료
+- 관련 파일: 8개
+
+### API 엔드포인트
+| POST | /api/v1/auth/login | 로그인 | - |
+| POST | /api/v1/auth/refresh | 토큰 갱신 | Required |
+
+[분석 계속...]
+
+이제 어떤 작업을 도와드릴까요?
+- 리팩토링
+- 신규 기능 추가
+- 버그 수정
+```
+
+### 품질 분석
+```
+User: /vibe.analyze --code
+
+Claude: 코드 품질 분석을 시작합니다...
 
 📊 코드 품질 점수: 85/100 (B+)
 
 **주요 발견사항:**
 - 높은 복잡도: src/service.py (CC: 15)
-- 낮은 응집도: src/utils.py (응집도: 0.3)
-- 강한 결합: Controller ↔ Service (결합도: 0.8)
 
 **개선 제안:**
 1. src/service.py를 3개 모듈로 분리
-2. src/utils.py의 관련 없는 함수 분리
-3. Dependency Injection 패턴 도입
-
-상세 리포트: .vibe/reports/analysis-2025-11-17.md
 ```
-
-## Notes
-
-- MCP 서버(`@su-record/hi-ai`)가 설치되어 있어야 합니다
-- 대규모 프로젝트는 분석에 시간이 걸릴 수 있습니다 (1-5분)
-- 분석 결과는 `.vibe/reports/` 폴더에 저장됩니다

package/.claude/settings.local.json

@@ -37,7 +37,10 @@
       "Bash(node:*)",
       "Bash(xargs basename:*)",
       "Bash(git restore:*)",
-      "Bash(npm version:*)"
+      "Bash(npm version:*)",
+      "Bash(npx @su-record/vibe@latest update)",
+      "Bash(gh release:*)",
+      "Bash(npx @su-record/vibe@latest init:*)"
     ],
     "deny": [],
     "ask": []

package/bin/vibe

@@ -208,6 +208,7 @@ function showHelp() {
 
 Commands:
   vibe init [project]     Initialize vibe in current/new project
+  vibe update             Update vibe settings (commands, rules, hooks)
   vibe help               Show this message
   vibe version            Show version
 
@@ -231,6 +232,82 @@ Workflow:
   `);
 }
 
+// 프로젝트 업데이트
+async function update() {
+  try {
+    const projectRoot = process.cwd();
+    const vibeDir = path.join(projectRoot, '.vibe');
+    const claudeDir = path.join(projectRoot, '.claude');
+
+    if (!fs.existsSync(vibeDir)) {
+      console.log('❌ vibe 프로젝트가 아닙니다. 먼저 vibe init을 실행하세요.');
+      return;
+    }
+
+    console.log('🔄 vibe 업데이트 중...\n');
+
+    // .claude/commands 업데이트
+    const commandsDir = path.join(claudeDir, 'commands');
+    ensureDir(commandsDir);
+    const sourceDir = path.join(__dirname, '../.claude/commands');
+    copyDirContents(sourceDir, commandsDir);
+    console.log('   ✅ 슬래시 커맨드 업데이트 완료 (7개)\n');
+
+    // .agent/rules/ 업데이트
+    const rulesSource = path.join(__dirname, '../.agent/rules');
+    const rulesTarget = path.join(projectRoot, '.agent/rules');
+    copyDirRecursive(rulesSource, rulesTarget);
+    console.log('   ✅ 코딩 규칙 업데이트 완료 (.agent/rules/)\n');
+
+    // .claude/agents/ 업데이트
+    const agentsDir = path.join(claudeDir, 'agents');
+    ensureDir(agentsDir);
+    const agentsSourceDir = path.join(__dirname, '../.claude/agents');
+    copyDirContents(agentsSourceDir, agentsDir);
+    console.log('   ✅ 서브에이전트 업데이트 완료 (.claude/agents/)\n');
+
+    // settings.local.json에 hooks 병합
+    const settingsPath = path.join(claudeDir, 'settings.local.json');
+    const hooksTemplate = path.join(__dirname, '../templates/hooks-template.json');
+
+    if (fs.existsSync(hooksTemplate)) {
+      const vibeHooks = JSON.parse(fs.readFileSync(hooksTemplate, 'utf-8'));
+
+      if (fs.existsSync(settingsPath)) {
+        // 기존 설정에 hooks 병합
+        const existingSettings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+
+        if (!existingSettings.hooks) {
+          existingSettings.hooks = vibeHooks.hooks;
+          fs.writeFileSync(settingsPath, JSON.stringify(existingSettings, null, 2));
+          console.log('   ✅ Hooks 설정 추가 완료\n');
+        } else {
+          console.log('   ℹ️  Hooks 설정 이미 존재\n');
+        }
+      } else {
+        // 새로 생성
+        fs.copyFileSync(hooksTemplate, settingsPath);
+        console.log('   ✅ Hooks 설정 생성 완료\n');
+      }
+    }
+
+    const packageJson = require('../package.json');
+    console.log(`
+✅ vibe 업데이트 완료! (v${packageJson.version})
+
+업데이트된 항목:
+  - 슬래시 커맨드 (7개)
+  - 코딩 규칙 (.agent/rules/)
+  - 서브에이전트 (.claude/agents/)
+  - Hooks 설정
+    `);
+
+  } catch (error) {
+    console.error('❌ 업데이트 실패:', error.message);
+    process.exit(1);
+  }
+}
+
 // 버전 정보
 function showVersion() {
   const packageJson = require('../package.json');
@@ -243,6 +320,10 @@ switch (command) {
     init(args[1]);
     break;
 
+  case 'update':
+    update();
+    break;
+
   case 'version':
   case '-v':
   case '--version':
@@ -262,6 +343,7 @@ switch (command) {
 
 사용 가능한 명령어:
   vibe init       프로젝트 초기화
+  vibe update     설정 업데이트
   vibe help       도움말
   vibe version    버전 정보
 

package/package.json

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