aiwf 0.3.14 → 0.3.16

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/            # 문서 템플릿
@@ -143,9 +153,11 @@ your_project/
 - [기능 Git 통합 가이드](docs/guides/feature-git-integration-guide-ko.md) - Git hooks 및 추적
 
 ### 기술 문서
+- [아키텍처](docs/ARCHITECTURE.ko.md) - 시스템 아키텍처 및 설계
 - [상태 관리 가이드](docs/STATE_MANAGEMENT_GUIDE.ko.md) - 워크플로우 기반 상태 시스템
 - [AI 워크플로우](docs/AI-WORKFLOW.ko.md) - AI 통합 패턴
 - [API 참조](docs/API_REFERENCE.md) - 프로그래머틱 사용
+- [전체 API 참조](docs/API_REFERENCE_FULL.ko.md) - 포괄적인 API 문서
 - [문제 해결](docs/TROUBLESHOOTING.md) - 일반적인 문제 및 해결책
 
 ## ✨ 주요 기능
@@ -163,7 +175,6 @@ your_project/
 - 🎭 **AI 페르소나** - 5가지 전문 페르소나 (Architect, Security, Frontend, Backend, Data Analyst)
 - 🧠 **페르소나 인식 압축** - 활성 페르소나에 최적화된 지능형 컨텍스트 압축
 - 📈 **경량 평가 시스템** - 최소한의 부담으로 자동 백그라운드 품질 모니터링
-- 🚀 **Feature Ledger** - 개발 진행 상황 추적을 위한 기능 ID 시스템
 - 🔍 **AI 도구 템플릿** - GitHub Copilot, Cursor, Windsurf, Augment 지원
 - 🪝 **Git Hooks 통합** - git 커밋과 함께 자동 기능 추적
 - 🤖 **워크플로우 기반 상태 관리** - 지능적 작업 우선순위 지정 및 의존성 추적
@@ -228,7 +239,6 @@ aiwf/
 ├── commands/           # AIWF 명령어 구현
 ├── config/             # 설정 파일
 ├── docs/               # 프로젝트 문서
-├── feature-ledger/     # 기능 추적 JSON 파일
 ├── hooks/              # 자동화된 워크플로우를 위한 Git hooks
 ├── lib/                # 핵심 라이브러리 모듈
 ├── personas/           # AI 페르소나 정의
@@ -241,8 +251,7 @@ aiwf/
 
 ### 주요 디렉토리
 
-- **feature-ledger/**: 기능 개발 상태 및 git 커밋 관계 추적
-- **hooks/**: 자동 기능 추적을 위한 git hooks (post-commit) 포함
+- **hooks/**: 자동화 워크플로우를 위한 git hooks (post-commit) 포함
 
 ## 🔧 요구사항
 

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
@@ -168,9 +178,11 @@ aiwf sprint-independent "Quick Feature" --minimal
 - [Feature Git Integration Guide](docs/guides/feature-git-integration-guide.md) - Git hooks and tracking
 
 ### Technical Documentation
+- [Architecture](docs/ARCHITECTURE.md) - System architecture and design
 - [State Management Guide](docs/STATE_MANAGEMENT_GUIDE.md) - Workflow-based state system
 - [AI Workflow](docs/AI-WORKFLOW.md) - AI integration patterns
 - [API Reference](docs/API_REFERENCE.md) - Programmatic usage
+- [Complete API Reference](docs/API_REFERENCE_FULL.md) - Comprehensive API documentation
 - [Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues and solutions
 
 ## ✨ Features
@@ -188,7 +200,6 @@ aiwf sprint-independent "Quick Feature" --minimal
 - 🎭 **AI Personas** - 5 specialized personas (Architect, Security, Frontend, Backend, Data Analyst)
 - 🧠 **Persona-Aware Compression** - Intelligent context compression optimized for active persona
 - 📈 **Lightweight Evaluation** - Automatic background quality monitoring with minimal overhead
-- 🚀 **Feature Ledger** - Feature ID system for development progress tracking
 - 🔍 **AI Tool Templates** - Support for GitHub Copilot, Cursor, Windsurf, and Augment
 - 🪝 **Git Hooks Integration** - Automated feature tracking with git commits
 - 🤖 **Workflow-Based State Management** - Intelligent task prioritization and dependency tracking
@@ -276,7 +287,6 @@ aiwf/
 ├── commands/           # AIWF command implementations
 ├── config/             # Configuration files
 ├── docs/               # Project documentation
-├── feature-ledger/     # Feature tracking JSON files
 ├── hooks/              # Git hooks for automated workflows
 ├── lib/                # Core library modules
 ├── personas/           # AI persona definitions
@@ -289,9 +299,44 @@ aiwf/
 
 ### Key Directories
 
-- **feature-ledger/**: Tracks feature development status and git commit relationships
 - **hooks/**: Contains git hooks (post-commit) for automatic feature tracking
 
+## 🔧 Module Management Guide
+
+### 삭제하기 전 확인사항
+
+1. **의존성 확인**: `/src/DEPENDENCY_MAP.md` 파일 확인
+2. **파일 헤더 확인**: `@warning 삭제 금지` 주석 확인  
+3. **YOLO 모듈 확인**: YOLO 전용 모듈인지 확인
+4. **동적 import 확인**: `import()` 구문으로 로드되는지 확인
+
+### ⚠️ YOLO 핵심 모듈들 (삭제 금지)
+
+- **`engineering-guard.js`** - 오버엔지니어링 방지 (동적 로드됨)
+- **`checkpoint-manager.js`** - YOLO 상태 관리
+
+### 🔍 모듈 카테고리 확인
+
+package.json의 `aiwf.moduleCategories`에서 모듈 분류를 확인할 수 있습니다:
+
+- **core**: 핵심 유틸리티 (경로, 메시지, 언어)
+- **yolo**: YOLO 시스템 전용
+- **persona**: AI 페르소나 시스템
+- **installer**: 설치/백업 시스템  
+- **cache**: 템플릿 캐시 시스템
+- **github**: GitHub 통합
+- **common**: 공통 리소스
+
+### 📋 의존성 검사
+
+```bash
+# 특정 모듈의 사용처 확인
+grep -r "모듈명" src/
+
+# 동적 import 확인  
+grep -r "import.*engineering-guard" claude-code/
+```
+
 ## 🔧 Requirements
 
 - Node.js 14.0.0 or higher

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