@su-record/vibe 0.3.0 → 0.4.0

package/bin/vibe

@@ -2,192 +2,211 @@
 
 /**
  * vibe CLI
- * Vibe Development - SPEC-driven AI coding framework
+ * SPEC-driven AI coding framework (Claude Code 전용)
  */
 
 const path = require('path');
 const fs = require('fs');
 
-// 명령어 목록 (Claude Code 전용)
-const commands = {
-  init: 'Initialize vibe in current project (MCP registration)',
-  help: 'Show help message'
-};
-
 const args = process.argv.slice(2);
 const command = args[0];
 
-// 도움말 출력
-function showHelp() {
-  console.log(`
-📖 Vibe - SPEC-driven AI coding framework for Claude Code
-
-⚠️  Vibe는 Claude Code 전용 프레임워크입니다.
-   터미널에서는 초기화만 가능합니다.
-
-터미널 명령어:
-  vibe init                  Initialize vibe in current project
-  vibe init <project-name>   Create new project with vibe
-  vibe help                  Show this message
-
-Claude Code 슬래시 커맨드 (프로젝트 내에서 사용):
-  /vibe.spec "기능명"       SPEC 작성 (대화형 Q&A)
-  /vibe.plan "기능명"       기술 계획 작성
-  /vibe.tasks "기능명"      Task 목록 생성
-  /vibe.run "Task 1-1"      Task 구현
-  /vibe.verify "기능명"     검증
-  /vibe.analyze             프로젝트 분석
-  /vibe.ui "설명"           UI 미리보기
-  /vibe.diagram --er        다이어그램 생성
-
-Workflow:
-  1. 터미널에서 vibe init 실행 (MCP 서버 등록)
-  2. Claude Code에서 슬래시 커맨드 사용
-     /vibe.spec "푸시 알림 설정"
-     /vibe.plan "푸시 알림 설정"
-     /vibe.tasks "푸시 알림 설정"
-     /vibe.run "Task 1-1"
-     /vibe.verify "푸시 알림 설정"
-
-설치:
-  npm install -g @su-record/vibe
-
-문서:
-  https://github.com/su-record/vibe/wiki
-  `);
+// 유틸리티 함수
+function ensureDir(dir) {
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
 }
 
-// 버전 정보
-function showVersion() {
-  const packageJson = require('../package.json');
-  console.log(`vibe v${packageJson.version}`);
+function copyDirContents(sourceDir, targetDir) {
+  if (fs.existsSync(sourceDir)) {
+    fs.readdirSync(sourceDir).forEach(file => {
+      fs.copyFileSync(path.join(sourceDir, file), path.join(targetDir, file));
+    });
+  }
 }
 
-// 프로젝트 초기화
-function init(projectName) {
-  let projectRoot = process.cwd();
-  let isNewProject = false;
+function copyDirRecursive(sourceDir, targetDir) {
+  if (!fs.existsSync(sourceDir)) return;
 
-  // 새 프로젝트 생성 케이스
-  if (projectName) {
-    projectRoot = path.join(process.cwd(), projectName);
+  ensureDir(targetDir);
 
-    if (fs.existsSync(projectRoot)) {
-      console.log(`❌ 폴더가 이미 존재합니다: ${projectName}/`);
-      return;
-    }
+  fs.readdirSync(sourceDir).forEach(item => {
+    const sourcePath = path.join(sourceDir, item);
+    const targetPath = path.join(targetDir, item);
 
-    console.log(`📁 새 프로젝트 생성: ${projectName}/\n`);
-    fs.mkdirSync(projectRoot, { recursive: true });
-    isNewProject = true;
-  }
-
-  const vibeDir = path.join(projectRoot, '.vibe');
-
-  if (fs.existsSync(vibeDir)) {
-    console.log('❌ .vibe/ 폴더가 이미 존재합니다.');
-    return;
-  }
+    if (fs.statSync(sourcePath).isDirectory()) {
+      copyDirRecursive(sourcePath, targetPath);
+    } else {
+      fs.copyFileSync(sourcePath, targetPath);
+    }
+  });
+}
 
-  // MCP 서버 등록 먼저 체크 및 실행
-  console.log('🔧 MCP 서버 확인 중...\n');
+// 프로젝트 초기화
+async function init(projectName) {
   try {
-    const { execSync } = require('child_process');
+    let projectRoot = process.cwd();
+    let isNewProject = false;
 
-    // MCP 서버 등록 스크립트 실행
-    const installScriptPath = path.join(__dirname, '../scripts/install-mcp.js');
-    execSync(`node "${installScriptPath}"`, { stdio: 'inherit' });
+    if (projectName) {
+      projectRoot = path.join(process.cwd(), projectName);
 
-  } catch (error) {
-    console.log('\n⚠️  MCP 서버 등록 중 오류가 발생했습니다.');
-    console.log('   계속 진행합니다...\n');
-  }
+      if (fs.existsSync(projectRoot)) {
+        console.log(`❌ 폴더가 이미 존재합니다: ${projectName}/`);
+        return;
+      }
 
-  // 폴더 생성
-  fs.mkdirSync(vibeDir);
-  fs.mkdirSync(path.join(vibeDir, 'specs'));
-  fs.mkdirSync(path.join(vibeDir, 'features'));
-  fs.mkdirSync(path.join(vibeDir, 'plans'));
-  fs.mkdirSync(path.join(vibeDir, 'tasks'));
+      console.log(`📁 새 프로젝트 생성: ${projectName}/\n`);
+      fs.mkdirSync(projectRoot, { recursive: true });
+      isNewProject = true;
+    }
 
-  // .claude/commands 폴더 생성 및 슬래시 커맨드 복사
-  const claudeDir = path.join(projectRoot, '.claude');
-  const commandsDir = path.join(claudeDir, 'commands');
+    const vibeDir = path.join(projectRoot, '.vibe');
+    if (fs.existsSync(vibeDir)) {
+      console.log('❌ .vibe/ 폴더가 이미 존재합니다.');
+      return;
+    }
 
-  if (!fs.existsSync(claudeDir)) {
-    fs.mkdirSync(claudeDir);
-  }
-  if (!fs.existsSync(commandsDir)) {
-    fs.mkdirSync(commandsDir);
-  }
+    // MCP 서버 등록 (Claude Code)
+    const mcpPath = path.join(__dirname, '..', 'node_modules', '@su-record', 'hi-ai', 'dist', 'index.js');
 
-  // 슬래시 커맨드 파일들 복사
-  const sourceCommandsDir = path.join(__dirname, '../.claude/commands');
-  if (fs.existsSync(sourceCommandsDir)) {
-    const commandFiles = fs.readdirSync(sourceCommandsDir);
-    commandFiles.forEach(file => {
-      const sourcePath = path.join(sourceCommandsDir, file);
-      const destPath = path.join(commandsDir, file);
-      fs.copyFileSync(sourcePath, destPath);
-    });
-  }
+    console.log('🔧 Claude Code MCP 서버 등록 중...\n');
+    const { execSync } = require('child_process');
+    try {
+      execSync(`claude mcp add vibe node "${mcpPath}"`, { stdio: 'pipe' });
+      console.log('   ✅ MCP 서버 등록 완료\n');
+    } catch (e) {
+      if (e.message.includes('already exists')) {
+        console.log('   ℹ️  MCP 서버 이미 등록됨\n');
+      } else {
+        console.log('   ⚠️  MCP 수동 등록 필요\n');
+      }
+    }
 
-  // constitution.md 템플릿 복사
-  const templatePath = path.join(__dirname, '../templates/constitution-template.md');
-  const constitutionPath = path.join(vibeDir, 'constitution.md');
+    // .vibe 폴더 구조 생성
+    const dirs = ['', 'specs', 'features'];
+    dirs.forEach(dir => {
+      ensureDir(path.join(vibeDir, dir));
+    });
 
-  if (fs.existsSync(templatePath)) {
-    fs.copyFileSync(templatePath, constitutionPath);
-  }
+    // .claude/commands 복사
+    const claudeDir = path.join(projectRoot, '.claude');
+    const commandsDir = path.join(claudeDir, 'commands');
+    ensureDir(claudeDir);
+    ensureDir(commandsDir);
+
+    const sourceDir = path.join(__dirname, '../.claude/commands');
+    copyDirContents(sourceDir, commandsDir);
+    console.log('   ✅ 슬래시 커맨드 설치 완료 (7개)\n');
+
+    // 설정 파일 생성
+    const templatePath = path.join(__dirname, '../templates/constitution-template.md');
+    const constitutionPath = path.join(vibeDir, 'constitution.md');
+    if (fs.existsSync(templatePath)) {
+      fs.copyFileSync(templatePath, constitutionPath);
+    }
 
-  // config.json 생성 (언어 설정 포함)
-  const configPath = path.join(vibeDir, 'config.json');
-  const config = {
-    language: 'ko',  // 기본 한국어
-    agents: {
-      default: 'backend-python-expert'
-    },
-    mcp: {
-      enabled: true,
-      servers: ['vibe']
-    },
-    quality: {
-      strict: true,
-      autoVerify: true
+    const config = {
+      language: 'ko',
+      quality: { strict: true, autoVerify: true }
+    };
+    fs.writeFileSync(path.join(vibeDir, 'config.json'), JSON.stringify(config, null, 2));
+
+    // CLAUDE.md 복사
+    const agentsSource = path.join(__dirname, '../CLAUDE.md');
+    const agentsDest = path.join(projectRoot, 'CLAUDE.md');
+    if (fs.existsSync(agentsSource)) {
+      fs.copyFileSync(agentsSource, agentsDest);
     }
-  };
-  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
 
-  console.log(`
+    // .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');
+
+    // 완료 메시지
+    console.log(`
 ✅ vibe 초기화 완료!
 
 ${isNewProject ? `프로젝트 위치:
   ${projectRoot}/
 
 ` : ''}생성된 구조:
-  .claude/commands/     # 슬래시 커맨드 (8개)
+  CLAUDE.md                      # 프로젝트 컨텍스트
+  .claude/
+  ├── commands/                  # 슬래시 커맨드 (7개)
+  └── agents/                    # 서브에이전트 (simplifier)
+  .agent/rules/                  # 코딩 규칙
+  ├── core/                      # 핵심 원칙
+  ├── quality/                   # 품질 체크리스트
+  └── standards/                 # 코딩 표준
   .vibe/
-  ├── config.json       # 프로젝트 설정 (언어: 한국어)
-  ├── constitution.md    # 프로젝트 원칙
-  ├── specs/            # SPEC 문서들
-  ├── features/         # BDD Feature 파일들 (Gherkin)
-  ├── plans/            # 기술 계획들
-  └── tasks/            # 작업 목록들
+  ├── config.json                # 프로젝트 설정
+  ├── constitution.md            # 프로젝트 원칙
+  ├── specs/                     # SPEC 문서들
+  └── features/                  # BDD Feature 파일들
 
-MCP 서버:
-  ✓ vibe MCP 서버 등록 완료 (38개 도구)
-  확인: claude mcp list
+MCP 서버 (hi-ai): ✓
 
-언어 변경:
-  .vibe/config.json에서 "language"를 "en" 또는 "ko"로 변경
+사용법:
+  /vibe.spec "기능명"            SPEC 작성 (대화형)
+  /vibe.run "기능명"             구현 실행
+  /vibe.verify "기능명"          검증
 
 다음 단계:
-  ${isNewProject ? `1. cd ${projectName}\n  2. ` : ''}Claude Code에서 슬래시 커맨드 사용:
-     /vibe.spec "기능명"
-     /vibe.plan "기능명"
+  ${isNewProject ? `cd ${projectName}\n  ` : ''}/vibe.spec "기능명" 으로 시작하세요!
+    `);
+
+  } catch (error) {
+    console.error('❌ 초기화 실패:', error.message);
+    process.exit(1);
+  }
+}
+
+// 도움말 출력
+function showHelp() {
+  console.log(`
+📖 Vibe - SPEC-driven AI coding framework (Claude Code 전용)
+
+Commands:
+  vibe init [project]     Initialize vibe in current/new project
+  vibe help               Show this message
+  vibe version            Show version
+
+Claude Code 슬래시 커맨드:
+  /vibe.spec "기능명"     SPEC 작성 (PTCF 구조)
+  /vibe.run "기능명"      구현 실행
+  /vibe.verify "기능명"   검증
+  /vibe.reason "문제"     체계적 추론
+  /vibe.analyze           프로젝트 분석
+  /vibe.ui "설명"         UI 미리보기
+  /vibe.diagram           다이어그램 생성
+
+Workflow:
+  /vibe.spec → /vibe.run → /vibe.verify
+
+설치:
+  npm install -g @su-record/vibe
+
+문서:
+  https://github.com/su-record/vibe
   `);
 }
 
+// 버전 정보
+function showVersion() {
+  const packageJson = require('../package.json');
+  console.log(`vibe v${packageJson.version}`);
+}
 
 // 메인 라우터
 switch (command) {
@@ -212,14 +231,10 @@ switch (command) {
     console.log(`
 ❌ 알 수 없는 명령어: ${command}
 
-⚠️  Vibe는 Claude Code 전용 프레임워크입니다.
-   터미널에서는 'init'만 사용 가능합니다.
-
-Claude Code에서 슬래시 커맨드를 사용하세요:
-  /vibe.spec "기능명"
-  /vibe.plan "기능명"
-  /vibe.tasks "기능명"
-  /vibe.run "Task 1-1"
+사용 가능한 명령어:
+  vibe init       프로젝트 초기화
+  vibe help       도움말
+  vibe version    버전 정보
 
 사용법: vibe help
     `);

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@su-record/vibe",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Vibe - Claude Code exclusive SPEC-driven AI coding framework",
-  "main": "cli/index.js",
   "bin": {
     "vibe": "./bin/vibe"
   },
@@ -37,12 +36,10 @@
   "devDependencies": {},
   "files": [
     "bin/",
-    "cli/",
     ".claude/",
-    "agents/",
-    "skills/",
+    ".agent/",
     "templates/",
-    "scripts/",
+    "CLAUDE.md",
     "README.md",
     "LICENSE"
   ]

package/templates/hooks-template.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://claude.ai/schemas/hooks.json",
+  "description": "VIBE 프레임워크 자동 품질 검증 훅",
+  "hooks": {
+    "PostToolUse": [
+      {
+        "tools": ["Write", "Edit"],
+        "description": "코드 작성/수정 후 품질 검증",
+        "command": "echo '📋 품질 검증 중...' && claude --agent simplifier --file $CHANGED_FILE",
+        "enabled": true
+      }
+    ],
+    "PreCommit": [
+      {
+        "description": "커밋 전 전체 품질 체크",
+        "command": "npm run lint && npm run type-check",
+        "enabled": true
+      }
+    ]
+  },
+  "settings": {
+    "autoFix": true,
+    "minGrade": "B",
+    "reportPath": ".vibe/reports/"
+  }
+}

package/.claude/commands/vibe.plan.md

@@ -1,81 +0,0 @@
----
-description: Create PLAN document with Planning Agent
-argument-hint: "feature name"
----
-
-# /vibe.plan
-
-PLAN 문서를 작성합니다 (Planning Agent).
-
-## Usage
-
-```
-/vibe.plan "기능명"
-```
-
-## Description
-
-SPEC 문서를 분석하여 기술 구현 계획(PLAN)을 작성합니다.
-
-## Process
-
-1. **SPEC 문서 읽기**: `.vibe/specs/{기능명}.md` 분석
-2. **Feature 파일 읽기**: `.vibe/features/{기능명}.feature` 확인 (BDD)
-3. **프로젝트 컨텍스트 파악**:
-   - `CLAUDE.md` 읽기 (기술 스택 확인)
-   - `package.json` / `pyproject.toml` / `pubspec.yaml` 확인
-4. **PLAN 문서 작성**: 15개 섹션 포함
-   - 기술 스택 선정 (기존 스택 재사용 우선)
-   - 아키텍처 설계
-   - API 설계
-   - DB 스키마
-   - 외부 서비스 통합
-   - 보안 설계
-   - 성능 최적화
-   - 에러 처리
-   - 모니터링 및 로깅
-   - **테스트 전략 (BDD/Contract Testing 포함)**
-     - BDD 도구 선정 (pytest-bdd, behave, cucumber 등)
-     - Contract Testing 도구 (Pact, Spring Cloud Contract 등)
-     - Feature 파일과 SPEC 매핑
-     - API Contract 스키마 정의
-   - 배포 전략
-   - 비용 예측
-   - 마일스톤 (Phase별)
-   - 리스크 및 완화 방안
-   - 다음 단계
-5. **품질 검증**: 기술 선택 근거, 비용, 일정 현실성, BDD 테스트 전략 타당성
-
-## Agent
-
-`~/.vibe/agents/planning-agent.md`
-
-## Input
-
-- `.vibe/specs/{기능명}.md` (SPEC 문서)
-- `.vibe/features/{기능명}.feature` (BDD Feature 파일)
-- `CLAUDE.md` (프로젝트 기술 스택)
-
-## Output
-
-- `.vibe/plans/{기능명}.md` - PLAN 문서
-- 예상 공수 (시간/일)
-- 예상 비용 ($)
-- Phase별 마일스톤
-
-## Example
-
-```
-/vibe.plan "푸시 알림 설정 기능"
-```
-
-**결과:**
-- 3 Phases (Backend → Frontend → FCM)
-- 24시간 (3일)
-- $0.50/월 추가 비용
-
-## Next Step
-
-```
-/vibe.tasks "푸시 알림 설정 기능"
-```

package/.claude/commands/vibe.tasks.md

@@ -1,83 +0,0 @@
----
-description: Create TASKS document with Task Agent
-argument-hint: "feature name"
----
-
-# /vibe.tasks
-
-TASKS 문서를 작성합니다 (Task Agent).
-
-## Usage
-
-```
-/vibe.tasks "기능명"
-```
-
-## Description
-
-PLAN 문서를 분석하여 Phase별 구체적인 작업 목록(TASKS)을 생성합니다.
-
-## Process
-
-1. **PLAN 문서 읽기**: `.vibe/plans/{기능명}.md` 분석
-2. **Feature 파일 읽기**: `.vibe/features/{기능명}.feature` 확인 (BDD Scenarios)
-3. **Phase별 Task 분해**:
-   - Phase 1: Backend 개발 (DB, API, Service, Repository, Unit Tests, **Contract Provider**)
-   - Phase 2: Frontend 개발 (Model, Service, Provider, UI, Unit Tests, **Contract Consumer**)
-   - Phase 3: 통합 및 테스트 (FCM, E2E, **BDD Step Definitions**, **Contract Verification**)
-4. **각 Task마다 정의**:
-   - 상태 (⬜ 대기 / 🟡 진행 중 / ✅ 완료)
-   - 담당 Agent
-   - 예상 시간
-   - 우선순위 (HIGH/MEDIUM/LOW)
-   - 의존성 (선행 Task)
-   - Acceptance Criteria (검증 기준)
-   - 참고 파일 경로
-   - 검증 명령어
-4. **의존성 그래프 생성**: Task 간 실행 순서 시각화
-5. **체크리스트 생성**: 코드 품질, 테스트, 문서, SPEC 검증
-
-## Agent
-
-`~/.vibe/agents/task-agent.md`
-
-## Input
-
-- `.vibe/plans/{기능명}.md` (PLAN 문서)
-- `.vibe/specs/{기능명}.md` (SPEC 문서)
-- `.vibe/features/{기능명}.feature` (BDD Feature 파일)
-
-## Output
-
-- `.vibe/tasks/{기능명}.md` - TASKS 문서
-- 총 Task 수
-- 의존성 그래프
-- Phase별 체크리스트
-
-## Example
-
-```
-/vibe.tasks "푸시 알림 설정 기능"
-```
-
-**결과:**
-- 23개 Task (Phase 1: 9개, Phase 2: 9개, Phase 3: 5개)
-  - **Phase 1:** DB, API, Service, Repository, Unit Tests, **Contract Provider 정의**
-  - **Phase 2:** Model, Service, Provider, UI, Unit Tests, **Contract Consumer 정의**
-  - **Phase 3:** FCM, E2E, **BDD Step Definitions**, **Contract Verification**
-- 의존성 그래프 포함
-- 각 Task별 Acceptance Criteria
-- BDD Scenarios와 매핑된 Contract Test Tasks
-
-## Next Step
-
-```
-/vibe.run "Task 1-1"
-```
-
-또는:
-
-```
-/vibe.run --phase 1  # Phase 1 전체 실행
-/vibe.run --all      # 모든 Task 실행
-```