@su-record/vibe 0.1.0

package/bin/sutory

@@ -0,0 +1,332 @@
+#!/usr/bin/env node
+
+/**
+ * sutory CLI
+ * Your story becomes code
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+// 명령어 목록
+const commands = {
+  init: 'Initialize sutory in current project',
+  story: 'Create/manage SPEC documents',
+  plan: 'Create technical implementation plan',
+  tasks: 'Break down SPEC into actionable tasks',
+  run: 'Run task implementation (with auto guide generation)',
+  implement: 'Start implementation with AI agents (deprecated, use run)',
+  verify: 'Verify implementation against SPEC',
+  agents: 'List available agents',
+  skills: 'List installed skills',
+  update: 'Update sutory framework',
+  help: 'Show help message'
+};
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+// 도움말 출력
+function showHelp() {
+  console.log(`
+📖 sutory - Your story becomes code
+
+Usage:
+  sutory <command> [options]
+
+Commands:
+  init                           Initialize sutory in current project
+  story create <name>            Create new SPEC through Q&A
+  story list                     List all SPECs
+  story show <name>              Show SPEC content
+  plan <name>                    Create implementation plan from SPEC
+  tasks <name>                   Generate tasks from SPEC + PLAN
+
+  🆕 run <task-id>               Run specific task (auto-generates guide + implements)
+  🆕 run --phase <N>             Run all tasks in Phase N
+  🆕 run --all                   Run all tasks sequentially
+
+  verify <name>                  Verify against SPEC requirements
+  agents                         List available agents
+  skills                         List installed skills
+  update                         Update sutory framework
+  help                           Show this message
+
+Workflow:
+  1. sutory spec "기능명"              → SPEC 작성 (Q&A)
+  2. sutory plan "기능명"              → PLAN 작성 (기술 계획)
+  3. sutory tasks "기능명"             → TASKS 생성 (19개 Task)
+  4. sutory run "Task 1-1"             → Task 구현 (가이드 생성 + 코드 작성)
+  5. sutory verify "기능명"            → SPEC 검증
+
+Examples:
+  $ sutory init
+  $ sutory story create "푸시 알림 설정"
+  $ sutory plan "푸시 알림 설정"
+  $ sutory tasks "푸시 알림 설정"
+  $ sutory run "Task 1-1"              # 개별 Task 실행
+  $ sutory run --phase 1               # Phase 1 전체 실행
+  $ sutory run --all                   # 전체 실행
+
+More info:
+  https://github.com/your-username/sutory
+  `);
+}
+
+// 버전 정보
+function showVersion() {
+  const packageJson = require('../package.json');
+  console.log(`sutory v${packageJson.version}`);
+}
+
+// 프로젝트 초기화
+function init() {
+  const sutoryDir = path.join(process.cwd(), '.sutory');
+
+  if (fs.existsSync(sutoryDir)) {
+    console.log('❌ .sutory/ 폴더가 이미 존재합니다.');
+    return;
+  }
+
+  // 폴더 생성
+  fs.mkdirSync(sutoryDir);
+  fs.mkdirSync(path.join(sutoryDir, 'specs'));
+  fs.mkdirSync(path.join(sutoryDir, 'plans'));
+  fs.mkdirSync(path.join(sutoryDir, 'tasks'));
+
+  // constitution.md 템플릿 복사
+  const templatePath = path.join(__dirname, '../templates/constitution-template.md');
+  const constitutionPath = path.join(sutoryDir, 'constitution.md');
+
+  if (fs.existsSync(templatePath)) {
+    fs.copyFileSync(templatePath, constitutionPath);
+  }
+
+  // config.json 생성 (언어 설정 포함)
+  const configPath = path.join(sutoryDir, 'config.json');
+  const config = {
+    language: 'ko',  // 기본 한국어
+    agents: {
+      default: 'backend-python-expert'
+    },
+    mcp: {
+      enabled: true,
+      servers: ['hi-ai', 'context-7']
+    },
+    quality: {
+      strict: true,
+      autoVerify: true
+    }
+  };
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+
+  console.log(`
+✅ sutory 초기화 완료!
+
+생성된 구조:
+  .sutory/
+  ├── config.json       # 프로젝트 설정 (언어: 한국어)
+  ├── constitution.md    # 프로젝트 원칙
+  ├── specs/            # SPEC 문서들
+  ├── plans/            # 기술 계획들
+  └── tasks/            # 작업 목록들
+
+언어 변경:
+  .sutory/config.json에서 "language"를 "en" 또는 "ko"로 변경
+
+다음 단계:
+  sutory story create "기능명"  - 새 기능 스토리 작성
+  `);
+}
+
+// 에이전트 목록
+function listAgents() {
+  const agentsDir = path.join(__dirname, '../agents');
+  const agents = fs.readdirSync(agentsDir).filter(f => f.endsWith('.md'));
+
+  console.log('\n🤖 사용 가능한 에이전트:\n');
+  agents.forEach((agent, i) => {
+    const name = agent.replace('.md', '');
+    console.log(`  ${i + 1}. ${name}`);
+  });
+  console.log('');
+}
+
+// 스킬 목록
+function listSkills() {
+  const skillsDir = path.join(__dirname, '../skills');
+  const categories = fs.readdirSync(skillsDir).filter(f => {
+    return fs.statSync(path.join(skillsDir, f)).isDirectory();
+  });
+
+  console.log('\n📚 설치된 스킬:\n');
+  categories.forEach(category => {
+    const skills = fs.readdirSync(path.join(skillsDir, category))
+      .filter(f => f.endsWith('.md'));
+    console.log(`  ${category}/`);
+    skills.forEach(skill => {
+      console.log(`    - ${skill.replace('.md', '')}`);
+    });
+  });
+  console.log('');
+}
+
+// Claude Code와 통합 (추후 구현)
+function delegateToClaudeCode(command, args) {
+  console.log(`
+⚠️  이 명령어는 Claude Code와 통합이 필요합니다.
+
+지금은 수동으로 Claude Code를 열고 다음과 같이 요청하세요:
+
+  "${command} ${args.join(' ')}"
+
+향후 업데이트에서 자동화될 예정입니다.
+  `);
+}
+
+// 메인 라우터
+switch (command) {
+  case 'init':
+    init();
+    break;
+
+  case 'agents':
+    listAgents();
+    break;
+
+  case 'skills':
+    listSkills();
+    break;
+
+  case 'version':
+  case '-v':
+  case '--version':
+    showVersion();
+    break;
+
+  case 'help':
+  case '-h':
+  case '--help':
+  case undefined:
+    showHelp();
+    break;
+
+  // sutory run 명령어 (새로운 구현 워크플로우)
+  case 'run':
+    handleRunCommand(args.slice(1));
+    break;
+
+  // Claude Code 위임이 필요한 명령어들
+  case 'story':
+  case 'plan':
+  case 'tasks':
+  case 'implement':
+  case 'verify':
+    delegateToClaudeCode(command, args.slice(1));
+    break;
+
+  default:
+    console.log(`❌ 알 수 없는 명령어: ${command}`);
+    console.log('사용법을 보려면: sutory help');
+    process.exit(1);
+}
+
+// sutory run 명령어 핸들러
+function handleRunCommand(args) {
+  const option = args[0];
+
+  if (!option) {
+    console.log(`
+❌ 사용법: sutory run <task-id> | --phase <N> | --all
+
+예시:
+  sutory run "Task 1-1"        # 특정 Task 실행
+  sutory run --phase 1         # Phase 1 전체 실행
+  sutory run --all             # 모든 Task 실행
+    `);
+    return;
+  }
+
+  // --all 플래그 처리
+  if (option === '--all') {
+    console.log(`
+🚀 전체 Task 실행 시작...
+
+Claude Code에 다음과 같이 요청하세요:
+
+  "sutory run --all 실행해줘. TASKS 문서의 의존성 순서대로 19개 Task를 모두 구현해줘."
+
+작업 순서:
+  Phase 1 (Backend) → Task 1-1 ~ 1-8
+  Phase 2 (Frontend) → Task 2-1 ~ 2-8
+  Phase 3 (FCM) → Task 3-1 ~ 3-3
+
+⚠️  주의: 전체 실행은 약 24시간 소요됩니다.
+    `);
+    return;
+  }
+
+  // --phase 플래그 처리
+  if (option === '--phase') {
+    const phaseNumber = args[1];
+    if (!phaseNumber) {
+      console.log(`❌ Phase 번호를 지정하세요: sutory run --phase <1|2|3>`);
+      return;
+    }
+
+    console.log(`
+🚀 Phase ${phaseNumber} 실행 시작...
+
+Claude Code에 다음과 같이 요청하세요:
+
+  "sutory run --phase ${phaseNumber} 실행해줘. TASKS 문서의 Phase ${phaseNumber} Task들을 순차적으로 구현해줘."
+
+Phase ${phaseNumber} 작업 목록:
+  ${getPhaseTaskList(phaseNumber)}
+
+예상 시간: ${getPhaseEstimatedTime(phaseNumber)}
+    `);
+    return;
+  }
+
+  // 특정 Task 실행
+  const taskId = option;
+  console.log(`
+🚀 Task 실행: "${taskId}"
+
+Claude Code에 다음과 같이 요청하세요:
+
+  "sutory run '${taskId}' 실행해줘. 다음 순서로 진행해줘:
+
+  1. TASKS 문서에서 '${taskId}' 찾기
+  2. 구현 가이드 생성 (.sutory/guides/${taskId}.md)
+  3. 가이드에 따라 코드 구현
+  4. Acceptance Criteria 검증
+  5. Task 상태를 ✅ 완료로 업데이트"
+
+구현 가이드 생성 위치:
+  .sutory/guides/${taskId.replace(/\s+/g, '-').toLowerCase()}.md
+
+검증 명령어는 TASKS 문서 참고
+  `);
+}
+
+// Phase별 Task 목록 (하드코딩 - 추후 TASKS 파일에서 파싱)
+function getPhaseTaskList(phase) {
+  const phases = {
+    '1': 'Task 1-1 ~ 1-8 (Backend 개발)',
+    '2': 'Task 2-1 ~ 2-8 (Frontend 개발)',
+    '3': 'Task 3-1 ~ 3-3 (FCM 연동 및 테스트)'
+  };
+  return phases[phase] || '알 수 없는 Phase';
+}
+
+// Phase별 예상 시간
+function getPhaseEstimatedTime(phase) {
+  const times = {
+    '1': '8시간 (1일)',
+    '2': '12시간 (1.5일)',
+    '3': '4시간 (0.5일)'
+  };
+  return times[phase] || '알 수 없음';
+}

package/bin/vibe

@@ -0,0 +1,338 @@
+#!/usr/bin/env node
+
+/**
+ * vibe CLI
+ * Vibe Development - SPEC-driven AI coding framework
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+// 명령어 목록
+const commands = {
+  init: 'Initialize vibe in current project',
+  spec: 'Create/manage SPEC documents',
+  plan: 'Create technical implementation plan',
+  tasks: 'Break down SPEC into actionable tasks',
+  run: 'Run task implementation (with auto guide generation)',
+  verify: 'Verify implementation against SPEC',
+  analyze: 'Analyze project (code quality, architecture, dependencies)',
+  ui: 'Preview UI with ASCII art',
+  diagram: 'Generate diagrams (architecture, ERD, flow)',
+  agents: 'List available agents',
+  skills: 'List installed skills',
+  help: 'Show help message'
+};
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+// 도움말 출력
+function showHelp() {
+  console.log(`
+📖 vibe - Your story becomes code
+
+Usage:
+  vibe <command> [options]
+
+Commands:
+  init                           Initialize vibe in current project
+  spec <name>                    Create SPEC through 6-question Q&A
+  plan <name>                    Create implementation plan from SPEC
+  tasks <name>                   Generate tasks from SPEC + PLAN
+  run <task-id>                  Run task (auto-guide + implement)
+  run --phase <N>                Run all tasks in Phase N
+  run --all                      Run all tasks sequentially
+  verify <name>                  Verify against SPEC requirements
+
+  analyze                        Analyze project (code/deps/arch)
+  analyze --code                 Code quality analysis
+  analyze --deps                 Dependency analysis
+  ui <description>               Preview UI with ASCII art
+  diagram                        Generate architecture diagram
+  diagram --er                   Generate ERD diagram
+
+  agents                         List available agents
+  skills                         List installed skills
+  help                           Show this message
+
+Workflow:
+  1. vibe spec "기능명"              → SPEC 작성 (Q&A)
+  2. vibe plan "기능명"              → PLAN 작성 (기술 계획)
+  3. vibe tasks "기능명"             → TASKS 생성 (19개 Task)
+  4. vibe run "Task 1-1"             → Task 구현 (가이드 생성 + 코드 작성)
+  5. vibe verify "기능명"            → SPEC 검증
+
+Examples:
+  $ vibe init
+  $ vibe story create "푸시 알림 설정"
+  $ vibe plan "푸시 알림 설정"
+  $ vibe tasks "푸시 알림 설정"
+  $ vibe run "Task 1-1"              # 개별 Task 실행
+  $ vibe run --phase 1               # Phase 1 전체 실행
+  $ vibe run --all                   # 전체 실행
+
+More info:
+  https://github.com/your-username/vibe
+  `);
+}
+
+// 버전 정보
+function showVersion() {
+  const packageJson = require('../package.json');
+  console.log(`vibe v${packageJson.version}`);
+}
+
+// 프로젝트 초기화
+function init() {
+  const vibeDir = path.join(process.cwd(), '.vibe');
+
+  if (fs.existsSync(vibeDir)) {
+    console.log('❌ .vibe/ 폴더가 이미 존재합니다.');
+    return;
+  }
+
+  // 폴더 생성
+  fs.mkdirSync(vibeDir);
+  fs.mkdirSync(path.join(vibeDir, 'specs'));
+  fs.mkdirSync(path.join(vibeDir, 'plans'));
+  fs.mkdirSync(path.join(vibeDir, 'tasks'));
+
+  // constitution.md 템플릿 복사
+  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: ['hi-ai', 'context-7']
+    },
+    quality: {
+      strict: true,
+      autoVerify: true
+    }
+  };
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+
+  console.log(`
+✅ vibe 초기화 완료!
+
+생성된 구조:
+  .vibe/
+  ├── config.json       # 프로젝트 설정 (언어: 한국어)
+  ├── constitution.md    # 프로젝트 원칙
+  ├── specs/            # SPEC 문서들
+  ├── plans/            # 기술 계획들
+  └── tasks/            # 작업 목록들
+
+언어 변경:
+  .vibe/config.json에서 "language"를 "en" 또는 "ko"로 변경
+
+다음 단계:
+  vibe story create "기능명"  - 새 기능 스토리 작성
+  `);
+}
+
+// 에이전트 목록
+function listAgents() {
+  const agentsDir = path.join(__dirname, '../agents');
+  const agents = fs.readdirSync(agentsDir).filter(f => f.endsWith('.md'));
+
+  console.log('\n🤖 사용 가능한 에이전트:\n');
+  agents.forEach((agent, i) => {
+    const name = agent.replace('.md', '');
+    console.log(`  ${i + 1}. ${name}`);
+  });
+  console.log('');
+}
+
+// 스킬 목록
+function listSkills() {
+  const skillsDir = path.join(__dirname, '../skills');
+  const categories = fs.readdirSync(skillsDir).filter(f => {
+    return fs.statSync(path.join(skillsDir, f)).isDirectory();
+  });
+
+  console.log('\n📚 설치된 스킬:\n');
+  categories.forEach(category => {
+    const skills = fs.readdirSync(path.join(skillsDir, category))
+      .filter(f => f.endsWith('.md'));
+    console.log(`  ${category}/`);
+    skills.forEach(skill => {
+      console.log(`    - ${skill.replace('.md', '')}`);
+    });
+  });
+  console.log('');
+}
+
+// Claude Code와 통합 (추후 구현)
+function delegateToClaudeCode(command, args) {
+  console.log(`
+⚠️  이 명령어는 Claude Code와 통합이 필요합니다.
+
+지금은 수동으로 Claude Code를 열고 다음과 같이 요청하세요:
+
+  "${command} ${args.join(' ')}"
+
+향후 업데이트에서 자동화될 예정입니다.
+  `);
+}
+
+// 메인 라우터
+switch (command) {
+  case 'init':
+    init();
+    break;
+
+  case 'agents':
+    listAgents();
+    break;
+
+  case 'skills':
+    listSkills();
+    break;
+
+  case 'version':
+  case '-v':
+  case '--version':
+    showVersion();
+    break;
+
+  case 'help':
+  case '-h':
+  case '--help':
+  case undefined:
+    showHelp();
+    break;
+
+  // vibe run 명령어 (새로운 구현 워크플로우)
+  case 'run':
+    handleRunCommand(args.slice(1));
+    break;
+
+  // Claude Code 위임이 필요한 명령어들
+  case 'spec':
+  case 'plan':
+  case 'tasks':
+  case 'verify':
+  case 'analyze':
+  case 'ui':
+  case 'diagram':
+    delegateToClaudeCode(command, args.slice(1));
+    break;
+
+  default:
+    console.log(`❌ 알 수 없는 명령어: ${command}`);
+    console.log('사용법을 보려면: vibe help');
+    process.exit(1);
+}
+
+// vibe run 명령어 핸들러
+function handleRunCommand(args) {
+  const option = args[0];
+
+  if (!option) {
+    console.log(`
+❌ 사용법: vibe run <task-id> | --phase <N> | --all
+
+예시:
+  vibe run "Task 1-1"        # 특정 Task 실행
+  vibe run --phase 1         # Phase 1 전체 실행
+  vibe run --all             # 모든 Task 실행
+    `);
+    return;
+  }
+
+  // --all 플래그 처리
+  if (option === '--all') {
+    console.log(`
+🚀 전체 Task 실행 시작...
+
+Claude Code에 다음과 같이 요청하세요:
+
+  "vibe run --all 실행해줘. TASKS 문서의 의존성 순서대로 19개 Task를 모두 구현해줘."
+
+작업 순서:
+  Phase 1 (Backend) → Task 1-1 ~ 1-8
+  Phase 2 (Frontend) → Task 2-1 ~ 2-8
+  Phase 3 (FCM) → Task 3-1 ~ 3-3
+
+⚠️  주의: 전체 실행은 약 24시간 소요됩니다.
+    `);
+    return;
+  }
+
+  // --phase 플래그 처리
+  if (option === '--phase') {
+    const phaseNumber = args[1];
+    if (!phaseNumber) {
+      console.log(`❌ Phase 번호를 지정하세요: vibe run --phase <1|2|3>`);
+      return;
+    }
+
+    console.log(`
+🚀 Phase ${phaseNumber} 실행 시작...
+
+Claude Code에 다음과 같이 요청하세요:
+
+  "vibe run --phase ${phaseNumber} 실행해줘. TASKS 문서의 Phase ${phaseNumber} Task들을 순차적으로 구현해줘."
+
+Phase ${phaseNumber} 작업 목록:
+  ${getPhaseTaskList(phaseNumber)}
+
+예상 시간: ${getPhaseEstimatedTime(phaseNumber)}
+    `);
+    return;
+  }
+
+  // 특정 Task 실행
+  const taskId = option;
+  console.log(`
+🚀 Task 실행: "${taskId}"
+
+Claude Code에 다음과 같이 요청하세요:
+
+  "vibe run '${taskId}' 실행해줘. 다음 순서로 진행해줘:
+
+  1. TASKS 문서에서 '${taskId}' 찾기
+  2. 구현 가이드 생성 (.vibe/guides/${taskId}.md)
+  3. 가이드에 따라 코드 구현
+  4. Acceptance Criteria 검증
+  5. Task 상태를 ✅ 완료로 업데이트"
+
+구현 가이드 생성 위치:
+  .vibe/guides/${taskId.replace(/\s+/g, '-').toLowerCase()}.md
+
+검증 명령어는 TASKS 문서 참고
+  `);
+}
+
+// Phase별 Task 목록 (하드코딩 - 추후 TASKS 파일에서 파싱)
+function getPhaseTaskList(phase) {
+  const phases = {
+    '1': 'Task 1-1 ~ 1-8 (Backend 개발)',
+    '2': 'Task 2-1 ~ 2-8 (Frontend 개발)',
+    '3': 'Task 3-1 ~ 3-3 (FCM 연동 및 테스트)'
+  };
+  return phases[phase] || '알 수 없는 Phase';
+}
+
+// Phase별 예상 시간
+function getPhaseEstimatedTime(phase) {
+  const times = {
+    '1': '8시간 (1일)',
+    '2': '12시간 (1.5일)',
+    '3': '4시간 (0.5일)'
+  };
+  return times[phase] || '알 수 없음';
+}