aiwf 0.3.13 → 0.3.15

package/README.ko.md

@@ -42,7 +42,7 @@ aiwf install
 # 현재 프로젝트에 AIWF 설치
 aiwf install
 
-# 강제 설치 (프롬프트 건너뛰기)
+# 완전 재설치 강제 실행 (프롬프트 건너뛰고 모든 내용 덮어쓰기)
 aiwf install --force
 
 # 도움말 표시
@@ -68,10 +68,20 @@ aiwf-lang reset
 
 ### 기존 설치 업데이트
 
-기존 AIWF가 있는 프로젝트에서 `aiwf install` 실행 시:
-- 자동 백업 생성
-- 업데이트 또는 건너뛰기 옵션
-- 설정 보존
+기존 AIWF가 있는 프로젝트에서 `aiwf install` 실행 시 다음 옵션을 제공합니다:
+
+#### 대화형 모드
+1. **업데이트**: 명령어와 문서만 업데이트하고 작업 내용은 보존
+2. **완전 재설치**: 새로 설치, 기존 프로젝트 덮어쓰기
+3. **건너뛰기**: 설치 취소
+
+#### 명령행 옵션
+- `--force`: 모든 프롬프트 건너뛰고 완전 재설치 실행
+
+#### 보존/업데이트 내용
+- **항상 보존**: 작업 파일, 스프린트, 태스크, 프로젝트 내용
+- **항상 업데이트**: Claude 명령어, 문서, 템플릿, 규칙
+- **백업 생성**: 업데이트된 파일의 자동 백업 (*.bak)
 
 ## 📁 설치 내용
 
@@ -85,7 +95,7 @@ your_project/
 │   ├── 02_REQUIREMENTS/          # 마일스톤 요구사항
 │   ├── 03_SPRINTS/              # 스프린트 실행 추적
 │   ├── 04_GENERAL_TASKS/        # 독립 작업
-│   ├── 05_ARCHITECTURE_DECISIONS/ # ADR 문서
+│   ├── 05_ARCHITECTURAL_DECISIONS/ # ADR 문서
 │   ├── 10_STATE_OF_PROJECT/     # 프로젝트 상태 스냅샷
 │   ├── 98_PROMPTS/              # 유용한 AI 프롬프트
 │   └── 99_TEMPLATES/            # 문서 템플릿

package/README.md

@@ -43,7 +43,7 @@ The installer will guide you through:
 # Install AIWF in current project
 aiwf install
 
-# Force installation (skip prompts)
+# Force complete reinstall (skip prompts, overwrite everything)
 aiwf install --force
 
 # Show help
@@ -69,10 +69,20 @@ aiwf-lang reset
 
 ### Update Existing Installation
 
-When running `aiwf install` in a project with existing AIWF:
-- Automatic backup creation
-- Option to update or skip
-- Preserves your settings
+When running `aiwf install` in a project with existing AIWF, you'll get these options:
+
+#### Interactive Mode
+1. **Update**: Updates commands and docs only, preserves work content
+2. **Complete Reinstall**: Fresh installation, overwrites existing project
+3. **Skip**: Cancel installation
+
+#### Command Line Options
+- `--force`: Skip all prompts and perform complete reinstall
+
+#### What Gets Preserved/Updated
+- **Always Preserved**: Your work files, sprints, tasks, and project content
+- **Always Updated**: Claude commands, documentation, templates, and rules
+- **Backup Created**: Automatic backup of updated files (*.bak)
 
 ## 📁 What Gets Installed
 
@@ -86,7 +96,7 @@ your_project/
 │   ├── 02_REQUIREMENTS/          # Milestone requirements
 │   ├── 03_SPRINTS/              # Sprint execution tracking
 │   ├── 04_GENERAL_TASKS/        # Standalone tasks
-│   ├── 05_ARCHITECTURE_DECISIONS/ # ADR documents
+│   ├── 05_ARCHITECTURAL_DECISIONS/ # ADR documents
 │   ├── 10_STATE_OF_PROJECT/     # Project state snapshots
 │   ├── 98_PROMPTS/              # Useful AI prompts
 │   └── 99_TEMPLATES/            # Document templates

package/docs/AI-WORKFLOW.ko.md

@@ -250,7 +250,7 @@ AIWF 워크플로를 구동하는 맞춤형 Claude Code 명령어:
 │   ├── TX001_Refactor_Logging_Module.md  # Completed task
 │   ├── T002_API_Rate_Limiting.md          # Open task
 │   └── ...
-├── 05_ARCHITECTURE_DECISIONS/
+├── 05_ARCHITECTURAL_DECISIONS/
 │   ├── ADR001_Database_Selection.md
 │   └── ...
 ├── 10_STATE_OF_PROJECT/         # Project review snapshots

package/docs/AI-WORKFLOW.md

@@ -352,7 +352,7 @@ Custom Claude Code commands that drive the AIWF workflow:
 │   ├── TX001_Refactor_Logging_Module.md  # Completed task
 │   ├── T002_API_Rate_Limiting.md          # Open task
 │   └── ...
-├── 05_ARCHITECTURE_DECISIONS/
+├── 05_ARCHITECTURAL_DECISIONS/
 │   ├── ADR001_Database_Selection.md
 │   └── ...
 ├── 10_STATE_OF_PROJECT/         # Project review snapshots

package/docs/GETTING_STARTED.md

@@ -168,7 +168,7 @@ my-project/
 │   │   ├── S02_M01_frontend_development/
 │   │   └── S03_M01_integration_testing/
 │   ├── 04_GENERAL_TASKS/           # Non-sprint tasks
-│   ├── 05_ARCHITECTURE_DECISIONS/  # ADRs
+│   ├── 05_ARCHITECTURAL_DECISIONS/  # ADRs
 │   ├── 06_FEATURE_LEDGERS/         # Feature tracking
 │   └── 99_TEMPLATES/               # Reusable templates
 ├── .claude/commands/aiwf/          # Claude commands

package/docs/ROADMAP_v0.4.0.md

@@ -0,0 +1,286 @@
+# AIWF v0.4.0 로드맵: "Autonomous AI Development Partner"
+
+## 🎯 비전 선언
+
+AIWF v0.4.0은 **자율 AI 개발 파트너**로의 진화를 목표로 합니다. 단순한 프로젝트 관리 도구를 넘어서, AI가 스스로 판단하고 행동하며 개발자와 진정한 협업을 이루는 혁신적인 플랫폼을 구축합니다.
+
+## 📅 개발 일정
+
+**전체 기간**: 2025년 8월 - 2025년 11월 (4개월)
+**메이저 마일스톤**: 4개
+**예상 릴리스**: 2025년 11월
+
+---
+
+## 🎯 M1: 지능형 자동화 시스템 (8월)
+
+### 🤖 자율 태스크 실행 엔진
+
+**목표**: AI가 반복적인 개발 작업을 완전 자동으로 수행
+
+#### 핵심 기능
+- **Smart Task Executor**: 태스크 내용을 분석하여 자동 실행 계획 수립
+- **Code Generation Pipeline**: 요구사항에서 코드까지 완전 자동 생성
+- **Test Auto-Generation**: 코드 변경 시 관련 테스트 자동 생성
+- **Documentation Sync**: 코드 변경 시 문서 자동 업데이트
+
+#### 기술 구현
+```javascript
+// 자율 실행 엔진 예시
+class AutonomousTaskExecutor {
+  async executeTask(taskId) {
+    const plan = await this.analyzeTask(taskId);
+    const steps = await this.generateExecutionSteps(plan);
+    
+    for (const step of steps) {
+      await this.executeStep(step);
+      await this.validateStep(step);
+      await this.updateProgress(taskId, step);
+    }
+  }
+}
+```
+
+#### CLI 명령어
+```bash
+aiwf auto execute T001      # 태스크 자동 실행
+aiwf auto plan T001         # 실행 계획 미리보기
+aiwf auto monitor           # 자동 실행 모니터링
+aiwf auto rollback T001     # 실행 결과 롤백
+```
+
+### 🔍 지능형 코드 분석
+
+**목표**: 코드베이스를 이해하고 개선점을 자동 제안
+
+#### 핵심 기능
+- **Architecture Analysis**: 코드 구조 자동 분석 및 리팩토링 제안
+- **Performance Profiling**: 성능 병목 지점 자동 식별
+- **Security Audit**: 보안 취약점 자동 스캔 및 수정 제안
+- **Code Quality Metrics**: 지속적인 코드 품질 모니터링
+
+---
+
+## 🎯 M2: 예측 분석 및 인사이트 (9월)
+
+### 📊 AI 기반 프로젝트 예측
+
+**목표**: 데이터 기반 프로젝트 성공 예측 및 리스크 관리
+
+#### 핵심 기능
+- **Completion Prediction**: 머신러닝 기반 프로젝트 완료 시점 예측
+- **Risk Assessment**: 프로젝트 리스크 자동 평가 및 완화 방안 제시
+- **Resource Optimization**: 팀 리소스 배분 최적화 제안
+- **Velocity Analysis**: 팀 개발 속도 분석 및 개선 방안
+
+#### 예측 모델
+```python
+# 프로젝트 완료 예측 모델 (Python/FastAPI)
+class ProjectPredictionModel:
+    def predict_completion(self, project_data):
+        features = self.extract_features(project_data)
+        completion_date = self.model.predict(features)
+        confidence = self.calculate_confidence(features)
+        return {
+            'predicted_date': completion_date,
+            'confidence': confidence,
+            'risk_factors': self.identify_risks(features)
+        }
+```
+
+### 🧠 학습형 AI 어시스턴트
+
+**목표**: 팀의 작업 패턴을 학습하여 맞춤형 지원 제공
+
+#### 핵심 기능
+- **Pattern Learning**: 개발자 개인/팀의 작업 패턴 학습
+- **Personalized Suggestions**: 개인 선호도 기반 작업 제안
+- **Adaptive Workflows**: 팀 특성에 맞는 워크플로우 자동 조정
+- **Knowledge Base Building**: 프로젝트 특화 지식 자동 구축
+
+---
+
+## 🎯 M3: 고급 협업 시스템 (10월)
+
+### 🤝 실시간 AI 협업
+
+**목표**: 개발자와 AI 간 실시간 협업 환경 구축
+
+#### 핵심 기능
+- **Live Code Review**: 코드 작성 중 실시간 AI 리뷰
+- **Pair Programming AI**: AI와 함께하는 페어 프로그래밍
+- **Context Sharing**: 팀원 간 AI 컨텍스트 공유
+- **Collaborative Planning**: AI 참여형 프로젝트 계획 수립
+
+#### 실시간 협업 아키텍처
+```javascript
+// WebSocket 기반 실시간 협업
+class AICollaborationHub {
+  constructor() {
+    this.aiAgents = new Map();
+    this.developers = new Map();
+    this.sharedContext = new SharedContext();
+  }
+  
+  async startPairProgramming(developerId, taskId) {
+    const aiAgent = await this.createAIAgent(taskId);
+    const session = new PairProgrammingSession(developerId, aiAgent);
+    return session.start();
+  }
+}
+```
+
+### 🌐 멀티 플랫폼 통합
+
+**목표**: 모든 개발 도구와 원활한 통합
+
+#### 지원 플랫폼
+- **IDE 통합**: VSCode, IntelliJ, Sublime Text 확장
+- **CI/CD 통합**: GitHub Actions, GitLab CI, Jenkins
+- **커뮤니케이션**: Slack, Discord, Microsoft Teams
+- **프로젝트 관리**: Jira, Asana, Notion, Linear
+
+---
+
+## 🎯 M4: 지능형 생태계 (11월)
+
+### 🏪 AI 마켓플레이스
+
+**목표**: 커뮤니티 기반 AI 모듈 생태계 구축
+
+#### 핵심 기능
+- **AI Module Store**: 전문화된 AI 모듈 마켓플레이스
+- **Custom AI Training**: 프로젝트 특화 AI 모델 훈련
+- **Community Templates**: 커뮤니티 제작 프로젝트 템플릿
+- **Performance Benchmarks**: AI 모듈 성능 비교 시스템
+
+### 🔮 미래 기술 통합
+
+**목표**: 차세대 AI 기술과의 통합
+
+#### 통합 기술
+- **GPT-5/Claude-4**: 최신 LLM 모델 지원
+- **Code Llama 2**: 코드 특화 AI 모델 통합
+- **Multimodal AI**: 이미지, 음성, 코드 멀티모달 처리
+- **Agentic AI**: 자율적 AI 에이전트 네트워크
+
+---
+
+## 🏗️ 기술 아키텍처 v0.4.0
+
+### 마이크로서비스 아키텍처
+
+```
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│   Frontend      │    │   AI Gateway    │    │  Prediction     │
+│   Dashboard     │◄──►│    Service      │◄──►│   Service       │
+└─────────────────┘    └─────────────────┘    └─────────────────┘
+         │                       │                       │
+         ▼                       ▼                       ▼
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│   Task Engine   │    │  Code Analysis  │    │   Learning      │
+│    Service      │    │    Service      │    │   Service       │
+└─────────────────┘    └─────────────────┘    └─────────────────┘
+         │                       │                       │
+         └───────────────────────┼───────────────────────┘
+                                 ▼
+                    ┌─────────────────┐
+                    │   Data Lake     │
+                    │   (Vector DB)   │
+                    └─────────────────┘
+```
+
+### 새로운 기술 스택
+
+#### Backend
+- **Node.js 20+**: 최신 ECMAScript 기능 활용
+- **TypeScript 5.x**: 강력한 타입 시스템
+- **Fastify**: 고성능 웹 프레임워크
+- **Prisma**: 타입세이프 ORM
+- **Redis**: 고성능 캐싱 및 세션 관리
+
+#### AI/ML
+- **LangChain**: LLM 체이닝 및 에이전트
+- **Pinecone**: 벡터 데이터베이스
+- **TensorFlow.js**: 브라우저/Node.js AI 추론
+- **Hugging Face**: 오픈소스 AI 모델 허브
+
+#### Frontend
+- **React 18**: 동시성 기능 활용
+- **Next.js 14**: 풀스택 React 프레임워크
+- **Tailwind CSS**: 유틸리티 우선 CSS
+- **Framer Motion**: 고급 애니메이션
+
+---
+
+## 📈 성능 목표 v0.4.0
+
+| 지표 | v0.3.10 | v0.4.0 목표 | 개선율 |
+|------|---------|-------------|--------|
+| 태스크 자동 실행 | 수동 | 80% 자동화 | ∞ |
+| 코드 품질 예측 정확도 | N/A | 85% | N/A |
+| 프로젝트 완료 예측 오차 | N/A | ±15% | N/A |
+| 시스템 응답 시간 | 100ms | 50ms | 50% |
+| 메모리 사용량 | 11MB | 25MB | -127% |
+| 동시 사용자 지원 | 1명 | 100명 | 10,000% |
+
+---
+
+## 🎯 성공 지표
+
+### 정량적 지표
+- **자동화율**: 전체 태스크의 80% 이상 자동 실행
+- **예측 정확도**: 프로젝트 완료 시점 예측 오차 15% 이내
+- **사용자 만족도**: NPS 점수 70+ 달성
+- **성능**: 평균 응답 시간 50ms 이하
+- **확장성**: 100명 동시 사용자 지원
+
+### 정성적 지표
+- **개발자 경험**: "AI가 진짜 팀원 같다"는 피드백 50% 이상
+- **생산성**: 개발 속도 2배 향상 사례 창출
+- **혁신성**: 업계 벤치마크 도구로 인정
+- **생태계**: 커뮤니티 기여 모듈 100개 이상
+
+---
+
+## 🚧 도전 과제 및 해결 방안
+
+### 기술적 도전
+1. **AI 응답 지연**: 로컬 AI 모델 활용으로 지연 최소화
+2. **데이터 프라이버시**: 온프레미스 배포 옵션 제공
+3. **모델 정확도**: 지속적 학습 및 피드백 루프 구축
+4. **시스템 복잡성**: 마이크로서비스 아키텍처로 모듈화
+
+### 비즈니스 도전
+1. **사용자 수용성**: 점진적 AI 도입으로 학습 곡선 완화
+2. **경쟁 차별화**: 독특한 자율 AI 기능으로 차별화
+3. **비용 효율성**: 오픈소스 AI 모델 활용으로 비용 절감
+4. **규모 확장**: 클라우드 네이티브 아키텍처 채택
+
+---
+
+## 🎉 v0.4.0 출시 계획
+
+### 베타 프로그램 (2025년 10월)
+- **얼리 어답터 모집**: 100명 베타 테스터
+- **피드백 수집**: 주간 설문 조사 및 인터뷰
+- **버그 수정**: 실시간 이슈 트래킹 및 해결
+
+### 정식 출시 (2025년 11월)
+- **론칭 이벤트**: 온라인 컨퍼런스 개최
+- **문서화**: 완전한 API 문서 및 튜토리얼
+- **커뮤니티**: Discord/Slack 커뮤니티 개설
+- **파트너십**: 주요 개발 도구업체와 협력
+
+---
+
+## 🌟 장기 비전 (2026년+)
+
+AIWF v0.4.0은 **자율 AI 개발 시대**의 시작점입니다. 미래에는:
+
+- **AI 팀원**: AI가 정식 팀원으로 인정받는 시대
+- **자율 개발**: 요구사항만 주면 완전한 소프트웨어 생성
+- **지능형 유지보수**: AI가 버그 수정과 기능 개선을 자동 수행
+- **창의적 협업**: AI와 인간이 함께 혁신적 솔루션 창출
+
+AIWF는 이러한 미래를 현실로 만드는 핵심 플랫폼이 될 것입니다! 🚀

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "aiwf",
-    "version": "0.3.13",
+    "version": "0.3.15",
     "description": "AI Workflow Framework for Claude Code with multi-language support (Korean/English)",
     "main": "index.js",
     "type": "module",

package/src/cli/index.js

@@ -35,7 +35,7 @@ program
 program
   .command('install')
   .description('Install AIWF framework')
-  .option('-f, --force', 'Force install without prompts')
+  .option('-f, --force', 'Force complete reinstall without prompts')
   .action((options) => installAIWF({ ...options, debugLog: true }));
 
 // AI Tool command