aiwf 0.3.15 → 0.3.16

package/README.ko.md

@@ -153,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) - 일반적인 문제 및 해결책
 
 ## ✨ 주요 기능
@@ -173,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 커밋과 함께 자동 기능 추적
 - 🤖 **워크플로우 기반 상태 관리** - 지능적 작업 우선순위 지정 및 의존성 추적
@@ -238,7 +239,6 @@ aiwf/
 ├── commands/           # AIWF 명령어 구현
 ├── config/             # 설정 파일
 ├── docs/               # 프로젝트 문서
-├── feature-ledger/     # 기능 추적 JSON 파일
 ├── hooks/              # 자동화된 워크플로우를 위한 Git hooks
 ├── lib/                # 핵심 라이브러리 모듈
 ├── personas/           # AI 페르소나 정의
@@ -251,8 +251,7 @@ aiwf/
 
 ### 주요 디렉토리
 
-- **feature-ledger/**: 기능 개발 상태 및 git 커밋 관계 추적
-- **hooks/**: 자동 기능 추적을 위한 git hooks (post-commit) 포함
+- **hooks/**: 자동화 워크플로우를 위한 git hooks (post-commit) 포함
 
 ## 🔧 요구사항
 

package/README.md

@@ -178,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
@@ -198,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
@@ -286,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
@@ -299,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