create-ax-project 1.0.0 → 1.0.2

package/bin/create.js

@@ -3,6 +3,7 @@
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
+import { input } from '@inquirer/prompts';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -41,12 +42,82 @@ function copyRecursiveSync(src, dest) {
   }
 }
 
-function main() {
+async function collectBriefInfo() {
+  console.log('');
+  log('📝 프로젝트 브리프를 작성합니다. (Enter만 누르면 건너뜁니다)', 'yellow');
+  console.log('');
+
+  const info = {};
+
+  // 순차적으로 질문 (각 input()이 완료되어야 다음으로 진행)
+  info.description = await input({ message: '한 줄 설명:' });
+  info.problem = await input({ message: '문제 정의 (해결하려는 문제):' });
+  info.targetUser = await input({ message: '타겟 사용자:' });
+  info.successCriteria = await input({ message: '성공 기준:' });
+  info.constraintSchedule = await input({ message: '제약조건 - 일정:' });
+  info.constraintBudget = await input({ message: '제약조건 - 예산:' });
+  info.constraintTech = await input({ message: '제약조건 - 기술:' });
+  info.references = await input({ message: '참고 자료 (URL 또는 문서):' });
+
+  // 핵심 기능 - 여러 개 입력 (별도 루프)
+  console.log('');
+  log('핵심 기능 (빈 입력 시 종료):', 'reset');
+  info.features = [];
+  let featureNum = 1;
+  while (true) {
+    const feature = await input({ message: `  ${featureNum}.` });
+    if (!feature) break;
+    info.features.push(feature);
+    featureNum++;
+  }
+
+  return info;
+}
+
+function generateBriefContent(projectName, info) {
+  // 핵심 기능 포맷팅
+  let featuresContent;
+  if (info.features && info.features.length > 0) {
+    featuresContent = info.features.map((f, i) => `${i + 1}. ${f}`).join('\n');
+  } else {
+    featuresContent = '1. [기능 1]\n2. [기능 2]\n3. [기능 3]';
+  }
+
+  return `# Project Brief
+
+## 프로젝트 이름
+${projectName}
+
+## 한 줄 설명
+${info.description || '[프로젝트를 한 줄로 설명해주세요]'}
+
+## 문제 정의
+${info.problem || '[해결하려는 문제는 무엇인가요?]'}
+
+## 타겟 사용자
+${info.targetUser || '[주요 사용자는 누구인가요?]'}
+
+## 핵심 기능 (초안)
+${featuresContent}
+
+## 성공 기준
+${info.successCriteria || '[프로젝트가 성공했다고 판단하는 기준은?]'}
+
+## 제약조건
+- 일정: ${info.constraintSchedule || ''}
+- 예산: ${info.constraintBudget || ''}
+- 기술: ${info.constraintTech || ''}
+
+## 참고 자료
+- ${info.references || '[URL 또는 문서]'}
+`;
+}
+
+async function main() {
   const args = process.argv.slice(2);
-  const projectName = args[0] || '.';
 
-  // 도움말
-  if (projectName === '--help' || projectName === '-h') {
+  // 도움말 체크 (가장 먼저 처리)
+  if (args.includes('--help') || args.includes('-h')) {
     console.log(`
 ${colors.cyan}create-ax-project${colors.reset} - Multi-AI Workflow Pipeline 프로젝트 생성
 
@@ -54,9 +125,13 @@ ${colors.yellow}사용법:${colors.reset}
   npx create-ax-project <project-name>
   npx create-ax-project .  (현재 디렉토리에 생성)
 
+${colors.yellow}옵션:${colors.reset}
+  --yes, -y    프롬프트 없이 기본값으로 생성
+
 ${colors.yellow}예시:${colors.reset}
   npx create-ax-project my-saas-app
   npx create-ax-project my-game
+  npx create-ax-project my-project --yes
 
 ${colors.yellow}생성 후:${colors.reset}
   1. cd <project-name>
@@ -66,6 +141,9 @@ ${colors.yellow}생성 후:${colors.reset}
     process.exit(0);
   }
 
+  const skipPrompts = args.includes('--yes') || args.includes('-y');
+  const projectName = args.find(arg => !arg.startsWith('-')) || '.';
+
   // 프로젝트 이름 검증
   if (projectName !== '.' && !/^[a-z0-9-]+$/.test(projectName)) {
     log('오류: 프로젝트 이름은 영문 소문자, 숫자, 하이픈만 허용됩니다.', 'red');
@@ -103,12 +181,18 @@ ${colors.yellow}생성 후:${colors.reset}
   }
   log(`✓ 프로젝트 디렉토리: ${targetDir}`, 'green');
 
-  // 2. 템플릿 복사
+  // 2. 프로젝트 브리프 정보 수집 (--yes 플래그가 없을 때만)
+  let briefInfo = {};
+  if (!skipPrompts) {
+    briefInfo = await collectBriefInfo();
+  }
+
+  // 3. 템플릿 복사
   log('  템플릿 복사 중...', 'blue');
   copyRecursiveSync(templateDir, targetDir);
   log('✓ 템플릿 복사 완료', 'green');
 
-  // 3. progress.json 초기화
+  // 4. progress.json 초기화
   const progressTemplatePath = path.join(targetDir, 'state', 'progress.json.template');
   const progressPath = path.join(targetDir, 'state', 'progress.json');
 
@@ -125,7 +209,7 @@ ${colors.yellow}생성 후:${colors.reset}
     log('✓ progress.json 초기화 완료', 'green');
   }
 
-  // 4. project_brief.md 생성
+  // 5. project_brief.md 생성
   const briefPath = path.join(targetDir, 'stages', '01-brainstorm', 'inputs', 'project_brief.md');
   const briefDir = path.dirname(briefPath);
 
@@ -133,41 +217,11 @@ ${colors.yellow}생성 후:${colors.reset}
     fs.mkdirSync(briefDir, { recursive: true });
   }
 
-  const briefContent = `# Project Brief
-
-## 프로젝트 이름
-${actualProjectName}
-
-## 한 줄 설명
-[프로젝트를 한 줄로 설명해주세요]
-
-## 문제 정의
-[해결하려는 문제는 무엇인가요?]
-
-## 타겟 사용자
-[주요 사용자는 누구인가요?]
-
-## 핵심 기능 (초안)
-1. [기능 1]
-2. [기능 2]
-3. [기능 3]
-
-## 성공 기준
-[프로젝트가 성공했다고 판단하는 기준은?]
-
-## 제약조건
-- 일정:
-- 예산:
-- 기술:
-
-## 참고 자료
-- [URL 또는 문서]
-`;
-
+  const briefContent = generateBriefContent(actualProjectName, briefInfo);
   fs.writeFileSync(briefPath, briefContent);
   log('✓ project_brief.md 생성 완료', 'green');
 
-  // 5. 완료 메시지
+  // 6. 완료 메시지
   console.log('');
   log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━', 'green');
   log(`✓ 프로젝트 '${actualProjectName}' 생성 완료!`, 'green');
@@ -190,4 +244,7 @@ ${actualProjectName}
   console.log('');
 }
 
-main();
+main().catch(err => {
+  log(`오류: ${err.message}`, 'red');
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ax-project",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Multi-AI Workflow Pipeline - Create new projects with 10-stage development workflow",
   "type": "module",
   "bin": {
@@ -34,5 +34,8 @@
   "bugs": {
     "url": "https://github.com/znehraks/ax-templates/issues"
   },
-  "homepage": "https://github.com/znehraks/ax-templates#readme"
+  "homepage": "https://github.com/znehraks/ax-templates#readme",
+  "dependencies": {
+    "@inquirer/prompts": "^8.2.0"
+  }
 }

package/template/.claude/CLAUDE.md

@@ -1,7 +0,0 @@
-<claude-mem-context>
-# Recent Activity
-
-<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
-
-*No recent activity*
-</claude-mem-context>

package/template/stages/01-brainstorm/HANDOFF.md

@@ -1,110 +0,0 @@
-# HANDOFF: 01-brainstorm → 02-research
-
-> 생성일: 2026-01-21
-> 프로젝트: snake-game
-> 현재 스테이지: 01-brainstorm (완료)
-> 다음 스테이지: 02-research
-
----
-
-## ✅ 완료된 작업
-
-- [x] 프로젝트 브리프 작성 (`inputs/project_brief.md`)
-- [x] 핵심 기능 아이디어 12개 브레인스토밍
-- [x] 사용자 페르소나 3개 정의
-- [x] 유사 프로젝트 사례 조사
-- [x] 장단점 분석 완료
-- [x] MVP 범위 제안
-
----
-
-## 📋 핵심 결정사항
-
-### 1. 기술 스택 방향
-- **렌더링**: Canvas (성능 우선, 모바일 지원)
-- **상태관리**: useReducer + Custom Hook
-- **게임 루프**: requestAnimationFrame
-
-### 2. MVP 기능 범위
-| 우선순위 | 기능 |
-|---------|------|
-| 🔴 필수 | 기본 조작, 먹이 시스템, 충돌 감지, 점수, 재시작 |
-| 🟡 중요 | 레벨 시스템, 하이스코어 저장, 일시정지, 모바일 터치 |
-| 🟢 선택 | Combo System, Portal Edges, Different Food |
-
-### 3. 타겟 사용자 (우선순위)
-1. **Persona A**: 캐주얼 게이머 (모바일, 5-10분 플레이)
-2. **Persona B**: 경쟁적 게이머 (데스크톱, 하이스코어 추구)
-3. **Persona C**: 레트로 팬 (클래식 스타일 선호)
-
----
-
-## 📁 생성된 산출물
-
-| 파일 | 설명 |
-|------|------|
-| `inputs/project_brief.md` | 프로젝트 개요 및 요구사항 |
-| `outputs/ideas.md` | 브레인스토밍 아이디어 (12개) |
-| `outputs/requirements_analysis.md` | 요구사항 분석 |
-| `HANDOFF.md` | 이 문서 |
-
----
-
-## 🔜 다음 스테이지 즉시 실행 작업
-
-### 02-research에서 조사할 항목
-
-1. **Canvas 게임 루프 구현 방법**
-   - requestAnimationFrame vs setInterval
-   - 최적화 기법 (더블 버퍼링)
-
-2. **React + Canvas 통합 패턴**
-   - useRef로 Canvas 접근
-   - Canvas 리렌더링 최소화
-
-3. **모바일 터치 이벤트 처리**
-   - touchstart/touchmove/touchend
-   - 스와이프 방향 감지 로직
-
-4. **localStorage 하이스코어 저장**
-   - 데이터 구조 설계
-   - 보안 고려사항
-
-5. **충돌 감지 알고리즘**
-   - O(n) 자기 몸 충돌
-   - 최적화 방안
-
----
-
-## ⚠️ 주의사항
-
-1. **외부 게임 엔진 미사용**: Phaser, PixiJS 등 금지
-2. **순수 React 구현**: jQuery 미사용
-3. **정적 배포 가능**: 백엔드 서버 없음
-
----
-
-## 📊 AI 호출 기록
-
-| AI | 시간 | 프롬프트 | 결과 | 상태 |
-|----|------|---------|------|------|
-| Gemini | 11:58 | Snake Game 브레인스토밍 | 12개 아이디어, 3 페르소나 | ✅ |
-| ClaudeCode | 11:57 | 결과 구조화 | ideas.md, HANDOFF.md | ✅ |
-
----
-
-## 🚀 다음 단계
-
-```bash
-# 다음 스테이지 실행
-/run-stage 02-research
-
-# 또는
-/research
-```
-
----
-
-**생성자**: ClaudeCode
-**검토자**: -
-**승인**: 대기

package/template/stages/01-brainstorm/inputs/project_brief.md

@@ -1,40 +0,0 @@
-# Project Brief: Snake Game
-
-## 프로젝트 이름
-Snake Game
-
-## 한 줄 설명
-클래식 스네이크 게임의 현대적 웹 버전
-
-## 문제 정의
-간단하지만 중독성 있는 캐주얼 게임 필요
-
-## 타겟 사용자
-- 짧은 시간 게임을 즐기고 싶은 사용자
-- 레트로 게임 팬
-- 모바일/데스크톱 모두에서 게임을 원하는 사용자
-
-## 핵심 기능
-1. 방향키/터치로 뱀 조작
-2. 먹이 수집 및 성장
-3. 충돌 감지 (벽, 자기 몸)
-4. 점수 시스템
-
-## 기술 요구사항
-- React + TypeScript
-- Vite 빌드 도구
-- Canvas 또는 CSS Grid 기반 렌더링
-- 반응형 디자인 (모바일 지원)
-
-## 성공 지표
-- 게임 플레이 가능 (기본 기능 완성)
-- 모바일/데스크톱 모두 지원
-- 테스트 커버리지 80% 이상
-- 배포 완료 (GitHub Pages 또는 Vercel)
-
-## 타임라인
-- 전체 파이프라인 (01~10): 약 4시간
-
-## 제약사항
-- 외부 게임 엔진 미사용 (순수 React)
-- 복잡한 백엔드 없음 (프론트엔드 only)

package/template/stages/01-brainstorm/outputs/ideas.md

@@ -1,159 +0,0 @@
-# 🐍 Snake Game - 브레인스토밍 아이디어
-
-> 생성일: 2026-01-21
-> 스테이지: 01-brainstorm
-> 프로젝트: snake-game
-> AI 도구: Gemini CLI + ClaudeCode
-
----
-
-## 📋 핵심 기능 아이디어 (12개)
-
-### 🎮 기본 게임플레이 (필수)
-
-| # | 아이디어 | 설명 | 우선순위 |
-|---|---------|------|---------|
-| 1 | **기본 뱀 조작** | 방향키(↑↓←→)로 뱀 이동 | 🔴 필수 |
-| 2 | **먹이 시스템** | 먹이를 먹으면 뱀 길이 +1, 점수 +10 | 🔴 필수 |
-| 3 | **충돌 감지** | 벽/자기 몸 충돌 시 게임 오버 | 🔴 필수 |
-| 4 | **점수 시스템** | 실시간 점수 표시 | 🔴 필수 |
-| 5 | **게임 재시작** | 게임 오버 후 다시 시작 기능 | 🔴 필수 |
-
-### ⭐ Gemini 제안 기능
-
-| # | 아이디어 | 설명 | 우선순위 |
-|---|---------|------|---------|
-| 6 | **Dash / Sprint** | 제한된 스태미나로 2배속 이동 | 🟢 선택 |
-| 7 | **Ghost Mode** | 자기 몸 통과 파워업 (5초) | 🟢 선택 |
-| 8 | **Dynamic Obstacles** | 10초마다 위치 변경되는 장애물 | 🟢 선택 |
-| 9 | **Combo System** | 연속 먹이 획득 시 점수 배율 (x1→x2→x4) | 🟡 중요 |
-| 10 | **Portal Edges** | 벽 통과 시 반대편으로 이동 (팩맨 스타일) | 🟡 중요 |
-| 11 | **Different Food Types** | 사과(+1), 황금사과(점수만), 고추(속도↑), 얼음(속도↓) | 🟢 선택 |
-| 12 | **Puzzle Levels** | 미로 레벨에서 모든 먹이 수집 | 🟢 선택 |
-
----
-
-## 📊 장단점 분석 (Gemini 분석)
-
-| 아이디어 | 장점 | 단점 |
-|:---------|:-----|:-----|
-| **Dash / Sprint** | 스킬 요소 추가, "클러치" 모멘트 | 속도로 인한 실수 충돌 가능 |
-| **Ghost Mode** | 초보자 친화적, 좌절감 감소 | 너무 쉬워질 수 있음 |
-| **Dynamic Obstacles** | 신선함 유지, 안전지대 캠핑 방지 | 불공정하게 느껴질 수 있음 |
-| **Combo System** | 공격적이고 위험한 플레이 유도 | UI 복잡해짐 (타이머 표시) |
-| **Portal Edges** | 클래식하고 만족스러운 플로우 | "코너 함정" 긴장감 감소 |
-| **Different Food** | 전략적 깊이 (위험 vs 보상) | 플레이어가 색상별 효과 기억 필요 |
-| **Puzzle Levels** | 명확한 진행감/완료감 | 무한 모드 대비 재플레이성 낮음 |
-
----
-
-## 👥 사용자 페르소나 (Gemini 생성)
-
-### 페르소나 A: "The Commuter" (캐주얼)
-- **인구통계**: 28세 직장인
-- **행동**: 지하철에서 모바일로 5-10분 플레이
-- **니즈**:
-  - 한 손 조작 (스와이프)
-  - 빠른 시작 (로딩 없음)
-  - 오프라인 가능
-  - 브라우저 닫아도 자동 저장
-- **불만**: 복잡한 메뉴, 작은 버튼, 광고
-
-### 페르소나 B: "The High-Scorer" (경쟁적)
-- **인구통계**: 16세 학생
-- **행동**: 쉬는 시간에 데스크톱 PC로 플레이, 리더보드에 집착
-- **니즈**:
-  - 정밀한 키보드 조작 (입력 지연 제로)
-  - 고대비 시각 (장애물 명확히 보임)
-  - 즉시 재시작 기능 ("R" 키)
-  - 글로벌 리더보드
-- **불만**: 불공정한 RNG, 랙, 느린 애니메이션
-
-### 페르소나 C: "The Retro Fan" (향수)
-- **인구통계**: 40세 개발자
-- **행동**: 픽셀 아트와 칩튠 음악 선호, 휴식용 플레이
-- **니즈**:
-  - 클래식 CRT 필터 또는 픽셀아트 미학
-  - 단순하고 "순수한" 게임플레이
-  - 게임패드/컨트롤러 지원
-- **불만**: 과도하게 현대적인 "화려한" 효과, 소액결제
-
----
-
-## 🔍 유사 프로젝트 사례 (Gemini 조사)
-
-### 1. Google Snake (검색 이스터에그)
-- **특징**: "접근 가능한" 스네이크의 표준
-- **핵심 기능**: 토글 가능한 모드 (속도, 포털, 평화 모드)
-
-### 2. Slither.io
-- **특징**: "현대 멀티플레이어" 시대 정의
-- **핵심 기능**: 마우스 따라가기 (아날로그), "차단" 메카닉
-
-### 3. Classic Nokia Snake (Snake II)
-- **특징**: 장르의 기초
-- **핵심 기능**: 단색, 그리드 기반, 벽 랩어라운드 옵션
-
-### 4. React-Snake (GitHub Topics)
-- **공통 기술 스택 패턴**:
-  - `useInterval` 훅으로 게임 루프
-  - 좌표 배열 `[{x,y}, {x,y}]`로 뱀 몸통
-  - CSS Grid (쉬움) vs HTML5 Canvas (성능 좋음)
-  - Redux/Zustand로 하이스코어 관리
-
----
-
-## 🎯 MVP 권장사항 (Gemini 제안)
-
-**페르소나 A (The Commuter)**와 **페르소나 B (The Competitive)**를 염두에 두고:
-
-### 기술 스택
-- **렌더링**: React + Canvas (모바일 성능 우선)
-- **입력**: 키보드 (Arrow/WASD) + 모바일 스와이프
-
-### MVP 기능 세트
-- [x] 클래식 무한 모드
-- [x] LocalStorage에 하이스코어 저장
-- [x] 3단계 속도 (느림, 보통, 빠름)
-- [x] "즉시 재시작" (한 번 더 시도 루프)
-
----
-
-## 📊 최종 우선순위 매트릭스
-
-```
-                    높은 가치
-                        │
-    ┌───────────────────┼───────────────────┐
-    │  Combo System     │  기본 조작        │
-    │  Portal Edges     │  먹이 시스템      │
-    │  레벨 시스템      │  충돌 감지        │
-    │                   │  점수 시스템      │
-적은 ─────────────────────────────────────── 많은
-노력  │                   │  게임 재시작      │ 노력
-    │  일시정지         │                   │
-    │  하이스코어 저장  │  Different Food   │
-    │                   │  Ghost Mode       │
-    └───────────────────┼───────────────────┘
-                        │
-                    낮은 가치
-```
-
----
-
-## ✅ 브레인스토밍 완료 체크리스트
-
-- [x] 최소 10개 아이디어 생성 (12개 완료)
-- [x] 3개 이상 사용자 페르소나 정의 (3개 완료)
-- [x] 각 아이디어 장단점 분석
-- [x] 유사 프로젝트 조사
-- [x] MVP 범위 제안
-
----
-
-## 📝 AI 호출 기록
-
-| AI | 호출 시간 | 프롬프트 | 결과 | 상태 |
-|----|----------|---------|------|------|
-| Gemini | 2026-01-21 11:58 | Snake Game 브레인스토밍 | 12개 아이디어, 3 페르소나, 사례 조사 | ✅ 성공 |
-| ClaudeCode | 2026-01-21 11:57 | 결과 구조화 | ideas.md 작성 | ✅ 성공 |