@su-record/vibe 0.4.3 → 0.4.5

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

@@ -11,6 +11,18 @@ const fs = require('fs');
 const args = process.argv.slice(2);
 const command = args[0];
 
+// 옵션 파싱
+const options = {
+  silent: args.includes('--silent') || args.includes('-s')
+};
+
+// 로그 함수 (silent 모드 지원)
+function log(message) {
+  if (!options.silent) {
+    console.log(message);
+  }
+}
+
 // 유틸리티 함수
 function ensureDir(dir) {
   if (!fs.existsSync(dir)) {
@@ -43,6 +55,94 @@ function copyDirRecursive(sourceDir, targetDir) {
   });
 }
 
+// 협업자 자동 설치 설정
+function setupCollaboratorAutoInstall(projectRoot) {
+  const packageJsonPath = path.join(projectRoot, 'package.json');
+  const vibeDir = path.join(projectRoot, '.vibe');
+  const packageJson = require('../package.json');
+  const vibeVersion = packageJson.version;
+
+  // 1. Node.js 프로젝트: package.json에 devDependency + postinstall 추가
+  if (fs.existsSync(packageJsonPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+
+      let modified = false;
+
+      // devDependencies에 vibe 추가
+      if (!pkg.devDependencies) {
+        pkg.devDependencies = {};
+      }
+      if (!pkg.devDependencies['@su-record/vibe']) {
+        pkg.devDependencies['@su-record/vibe'] = `^${vibeVersion}`;
+        modified = true;
+      }
+
+      // scripts에 postinstall 추가
+      if (!pkg.scripts) {
+        pkg.scripts = {};
+      }
+      if (!pkg.scripts.postinstall) {
+        pkg.scripts.postinstall = 'vibe update --silent';
+        modified = true;
+      } else if (!pkg.scripts.postinstall.includes('vibe update')) {
+        // 기존 postinstall이 있으면 vibe update 추가
+        pkg.scripts.postinstall = `${pkg.scripts.postinstall} && vibe update --silent`;
+        modified = true;
+      }
+
+      if (modified) {
+        fs.writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2) + '\n');
+        log('   ✅ package.json에 협업자 자동 설치 설정 추가\n');
+      } else {
+        log('   ℹ️  package.json 협업 설정 이미 존재\n');
+      }
+    } catch (e) {
+      log('   ⚠️  package.json 수정 실패: ' + e.message + '\n');
+    }
+  }
+
+  // 2. 범용: .vibe/setup.sh 생성 (비-Node 프로젝트 또는 추가 지원)
+  const setupShPath = path.join(vibeDir, 'setup.sh');
+  if (!fs.existsSync(setupShPath)) {
+    const setupScript = `#!/bin/bash
+# Vibe 협업자 자동 설치 스크립트
+# 사용법: ./.vibe/setup.sh
+
+set -e
+
+echo "🔧 Vibe 설치 확인 중..."
+
+# npm/npx 확인
+if ! command -v npx &> /dev/null; then
+    echo "❌ Node.js/npm이 설치되어 있지 않습니다."
+    echo "   https://nodejs.org 에서 설치해주세요."
+    exit 1
+fi
+
+# vibe 설치 확인 및 업데이트
+if command -v vibe &> /dev/null; then
+    echo "✅ Vibe가 이미 설치되어 있습니다."
+    vibe update --silent
+    echo "✅ Vibe 업데이트 완료!"
+else
+    echo "📦 Vibe 설치 중..."
+    npm install -g @su-record/vibe
+    vibe update --silent
+    echo "✅ Vibe 설치 및 설정 완료!"
+fi
+
+echo ""
+echo "다음 명령어로 시작하세요:"
+echo "  /vibe.spec \\"기능명\\"    SPEC 작성"
+echo "  /vibe.run \\"기능명\\"     구현 실행"
+`;
+    fs.writeFileSync(setupShPath, setupScript);
+    fs.chmodSync(setupShPath, '755');
+    log('   ✅ 협업자 설치 스크립트 생성 (.vibe/setup.sh)\n');
+  }
+}
+
 // 프로젝트 초기화
 async function init(projectName) {
   try {
@@ -53,34 +153,34 @@ async function init(projectName) {
       projectRoot = path.join(process.cwd(), projectName);
 
       if (fs.existsSync(projectRoot)) {
-        console.log(`❌ 폴더가 이미 존재합니다: ${projectName}/`);
+        log(`❌ 폴더가 이미 존재합니다: ${projectName}/`);
         return;
       }
 
-      console.log(`📁 새 프로젝트 생성: ${projectName}/\n`);
+      log(`📁 새 프로젝트 생성: ${projectName}/\n`);
       fs.mkdirSync(projectRoot, { recursive: true });
       isNewProject = true;
     }
 
     const vibeDir = path.join(projectRoot, '.vibe');
     if (fs.existsSync(vibeDir)) {
-      console.log('❌ .vibe/ 폴더가 이미 존재합니다.');
+      log('❌ .vibe/ 폴더가 이미 존재합니다.');
       return;
     }
 
     // MCP 서버 등록 (Claude Code)
     const mcpPath = path.join(__dirname, '..', 'node_modules', '@su-record', 'hi-ai', 'dist', 'index.js');
 
-    console.log('🔧 Claude Code MCP 서버 등록 중...\n');
+    log('🔧 Claude Code MCP 서버 등록 중...\n');
     const { execSync } = require('child_process');
     try {
       execSync(`claude mcp add vibe node "${mcpPath}"`, { stdio: 'pipe' });
-      console.log('   ✅ MCP 서버 등록 완료\n');
+      log('   ✅ MCP 서버 등록 완료\n');
     } catch (e) {
       if (e.message.includes('already exists')) {
-        console.log('   ℹ️  MCP 서버 이미 등록됨\n');
+        log('   ℹ️  MCP 서버 이미 등록됨\n');
       } else {
-        console.log('   ⚠️  MCP 수동 등록 필요\n');
+        log('   ⚠️  MCP 수동 등록 필요\n');
       }
     }
 
@@ -98,7 +198,7 @@ async function init(projectName) {
 
     const sourceDir = path.join(__dirname, '../.claude/commands');
     copyDirContents(sourceDir, commandsDir);
-    console.log('   ✅ 슬래시 커맨드 설치 완료 (7개)\n');
+    log('   ✅ 슬래시 커맨드 설치 완료 (7개)\n');
 
     // 설정 파일 생성
     const templatePath = path.join(__dirname, '../templates/constitution-template.md');
@@ -126,28 +226,28 @@ async function init(projectName) {
         // vibe 섹션이 없으면 끝에 추가
         const mergedContent = existingContent.trim() + '\n\n---\n\n' + vibeContent;
         fs.writeFileSync(projectClaudeMd, mergedContent);
-        console.log('   ✅ CLAUDE.md에 vibe 섹션 추가\n');
+        log('   ✅ CLAUDE.md에 vibe 섹션 추가\n');
       } else {
-        console.log('   ℹ️  CLAUDE.md에 vibe 섹션 이미 존재\n');
+        log('   ℹ️  CLAUDE.md에 vibe 섹션 이미 존재\n');
       }
     } else {
       // 없으면 새로 생성
       fs.copyFileSync(vibeClaudeMd, projectClaudeMd);
-      console.log('   ✅ CLAUDE.md 생성\n');
+      log('   ✅ CLAUDE.md 생성\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');
+    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');
+    log('   ✅ 서브에이전트 설치 완료 (.claude/agents/)\n');
 
     // .claude/settings.local.json 생성 (Hooks 설정)
     const settingsPath = path.join(claudeDir, 'settings.local.json');
@@ -155,14 +255,17 @@ async function init(projectName) {
       const hooksTemplate = path.join(__dirname, '../templates/hooks-template.json');
       if (fs.existsSync(hooksTemplate)) {
         fs.copyFileSync(hooksTemplate, settingsPath);
-        console.log('   ✅ Hooks 설정 설치 완료 (.claude/settings.local.json)\n');
+        log('   ✅ Hooks 설정 설치 완료 (.claude/settings.local.json)\n');
       }
     } else {
-      console.log('   ℹ️  Hooks 설정 이미 존재\n');
+      log('   ℹ️  Hooks 설정 이미 존재\n');
     }
 
+    // 협업자 자동 설치 설정
+    setupCollaboratorAutoInstall(projectRoot);
+
     // 완료 메시지
-    console.log(`
+    log(`
 ✅ vibe 초기화 완료!
 
 ${isNewProject ? `프로젝트 위치:
@@ -181,10 +284,12 @@ ${isNewProject ? `프로젝트 위치:
   .vibe/
   ├── config.json                # 프로젝트 설정
   ├── constitution.md            # 프로젝트 원칙
+  ├── setup.sh                   # 협업자 설치 스크립트
   ├── specs/                     # SPEC 문서들
   └── features/                  # BDD Feature 파일들
 
 MCP 서버 (hi-ai): ✓
+협업자 자동 설치: ✓
 
 사용법:
   /vibe.spec "기능명"            SPEC 작성 (대화형)
@@ -244,27 +349,27 @@ async function update() {
       return;
     }
 
-    console.log('🔄 vibe 업데이트 중...\n');
+    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');
+    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');
+    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');
+    log('   ✅ 서브에이전트 업데이트 완료 (.claude/agents/)\n');
 
     // settings.local.json에 hooks 병합
     const settingsPath = path.join(claudeDir, 'settings.local.json');
@@ -280,19 +385,29 @@ async function update() {
         if (!existingSettings.hooks) {
           existingSettings.hooks = vibeHooks.hooks;
           fs.writeFileSync(settingsPath, JSON.stringify(existingSettings, null, 2));
-          console.log('   ✅ Hooks 설정 추가 완료\n');
+          log('   ✅ Hooks 설정 추가 완료\n');
         } else {
-          console.log('   ℹ️  Hooks 설정 이미 존재\n');
+          log('   ℹ️  Hooks 설정 이미 존재\n');
         }
       } else {
         // 새로 생성
         fs.copyFileSync(hooksTemplate, settingsPath);
-        console.log('   ✅ Hooks 설정 생성 완료\n');
+        log('   ✅ Hooks 설정 생성 완료\n');
       }
     }
 
+    // MCP 서버 등록 확인
+    const mcpPath = path.join(__dirname, '..', 'node_modules', '@su-record', 'hi-ai', 'dist', 'index.js');
+    const { execSync } = require('child_process');
+    try {
+      execSync(`claude mcp add vibe node "${mcpPath}"`, { stdio: 'pipe' });
+      log('   ✅ MCP 서버 등록 완료\n');
+    } catch (e) {
+      // 이미 등록됨 - silent
+    }
+
     const packageJson = require('../package.json');
-    console.log(`
+    log(`
 ✅ vibe 업데이트 완료! (v${packageJson.version})
 
 업데이트된 항목:
@@ -300,6 +415,7 @@ async function update() {
   - 코딩 규칙 (.agent/rules/)
   - 서브에이전트 (.claude/agents/)
   - Hooks 설정
+  - MCP 서버
     `);
 
   } catch (error) {

package/package.json

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