aiwf 0.3.8 → 0.3.13

package/CHANGELOG.md

@@ -7,6 +7,103 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.10] - 2025-07-23
+
+### 🚀 Added
+- **Modular State Management Architecture**: Refactored 1,163-line state.js into specialized modules
+  - `StateIndexManager` - Centralized state file operations
+  - `PriorityCalculator` - Intelligent task priority scoring
+  - `TaskScanner` - Project file scanning and parsing
+  - `EnhancedResourceLoader` - Memory-cached resource loading
+
+- **GitHub CLI Integration**: Complete GitHub workflow integration
+  - `aiwf github issue <task-id>` - Auto-generate GitHub issues from tasks
+  - `aiwf github pr [task-id]` - Create pull requests with task context
+  - `aiwf github sync` - Bidirectional sync between GitHub and AIWF
+  - Automatic issue/PR template generation with task metadata
+
+- **Cache Management Commands**: Advanced offline template system
+  - `aiwf cache download` - Download templates for offline use
+  - `aiwf cache status` - Display cache health and statistics
+  - `aiwf cache clean` - Intelligent cache cleanup with age-based policies
+  - `aiwf cache update` - Check and install template updates
+
+- **Memory Caching System**: Performance-optimized resource loading
+  - LRU (Least Recently Used) cache eviction policy
+  - Configurable TTL (Time To Live) for cached resources
+  - Cache hit/miss statistics and memory usage monitoring
+  - Automatic cleanup of expired cache entries
+
+### 🔧 Changed
+- **Enhanced Resource Loader**: Upgraded with memory caching capabilities
+  - 5-minute default TTL for cached resources
+  - Maximum 100 cached items with intelligent eviction
+  - Real-time cache statistics (hit rate, memory usage)
+  - Periodic cleanup of expired entries
+
+- **CLI Command Consistency**: Unified CLI and Claude command interfaces
+  - All GitHub operations available through both CLI and Claude commands
+  - Consistent parameter naming and option structures
+  - Standardized error handling and user feedback
+
+### ⚡ Performance
+- **40-60% Faster Resource Loading**: Memory caching reduces file I/O operations
+- **Modular Architecture**: Improved maintainability and reduced memory footprint
+- **Optimized Task Scanning**: Parallel processing of sprint directories and task files
+- **Efficient State Calculations**: Cached priority calculations with incremental updates
+
+### 🐛 Fixed
+- Resolved state synchronization issues between CLI and Claude commands
+- Fixed cache invalidation problems with template updates
+- Improved error handling in GitHub integration workflows
+- Enhanced file parsing reliability for complex task structures
+
+## [0.3.9] - 2025-07-23
+
+### ✨ Added
+- **Workflow-Based State Management**: Revolutionary state management system for AI context preservation
+  - Central state index (`task-state-index.json`) for persistent AI memory
+  - Workflow rules engine with priority matrix calculation
+  - Dependency tracking with circular dependency detection
+  - 80% rule implementation for adaptive sprint management
+  
+- **State Management CLI Commands**: New `aiwf state` command suite
+  - `aiwf state update` - Sync project state with file system
+  - `aiwf state show` - Display current state and recommendations
+  - `aiwf state next` - Get AI-powered next action suggestions
+  - `aiwf state validate` - Check workflow consistency
+  - `aiwf state start/complete` - Track task progress
+  
+- **Smart Task Prioritization**: Intelligent task scoring algorithm
+  - Urgency (40%) - deadline-based scoring
+  - Importance (30%) - priority level weighting
+  - Dependencies (20%) - blocking task analysis
+  - Effort (10%) - inverse effort scoring
+  
+- **Enhanced YOLO Mode**: Workflow-integrated autonomous execution
+  - Automatic task selection based on workflow rules
+  - Adaptive sprint generation at 80% completion
+  - Real-time state monitoring during execution
+  - Smart commit and checkpoint management
+
+### 🔄 Changed
+- **Command Updates**: Enhanced existing commands with state synchronization
+  - `aiwf_do_task.md` - Auto-updates state on task completion
+  - `aiwf_create_sprint_tasks.md` - Syncs new tasks to state index
+  - `aiwf_commit.md` - Updates state after successful commits
+  - `aiwf_yolo.md` - Complete workflow intelligence integration
+
+### 📝 Added Commands
+- `aiwf_smart_start.md` - Workflow-aware task initialization
+- `aiwf_smart_complete.md` - Intelligent task completion with state sync
+- `aiwf_validate_state.md` - Comprehensive workflow validation
+
+### 🐛 Fixed
+- AI losing track of current work context between sessions
+- Manual state updates causing synchronization issues
+- Simple task selection missing dependency relationships
+- Sprint transitions lacking intelligent decision making
+
 ## [0.3.5] - 2025-07-19
 
 ### ✨ Features

package/README.ko.md

@@ -1,9 +1,9 @@
 # AIWF (AI Workflow Framework)
 
-[Read in Korean (한국어로 보기)](README.ko.md)
+[Read in English](README.md)
 
 [![NPM Version](https://img.shields.io/npm/v/aiwf.svg)](https://www.npmjs.com/package/aiwf)
-[![License](https://img.shields.io/npm/l/aiwf.svg)](https://github.com/aiwf/aiwf/blob/main/LICENSE)
+[![License](https://img.shields.io/npm/l/aiwf.svg)](https://github.com/moonklabs/aiwf/blob/main/LICENSE)
 [![Downloads](https://img.shields.io/npm/dm/aiwf.svg)](https://www.npmjs.com/package/aiwf)
 
 ## AIWF란?
@@ -13,49 +13,65 @@ AIWF는 Claude Code와 함께 AI 기반 개발을 위해 특별히 설계된 마
 
 ## 📦 설치
 
-프로젝트 디렉토리에서 AIWF 설치:
+### 전역 설치 (권장)
 
 ```bash
-npx aiwf
+npm install -g aiwf
 ```
 
-설치 프로그램의 동작:
+### 최초 설정
+
+전역 설치 후, 프로젝트 디렉토리에서 실행:
+
+```bash
+aiwf install
+```
+
+설치 과정에서 안내하는 내용:
 
 1. **언어 선택**: 한국어와 영어 중 선택
-2. **디렉토리 구성**: 프로젝트 관리를 위한 `.aiwf/` 디렉토리 구조 생성
-3. **명령어 설치**: 선택한 언어의 `.claude/commands/aiwf/` Claude 명령어 설정
-4. **콘텐츠 다운로드**: 선택한 언어의 최신 템플릿과 문서 다운로드
+2. **프로젝트 설정**: 현재 디렉토리에 AIWF 초기화
+3. **Claude 명령어**: 언어별 명령어 설치
+4. **문서화**: 가이드 및 템플릿 다운로드
 
 ## 🚀 사용법
 
-### 첫 설치
+### 기본 명령어
 
 ```bash
-npx aiwf
-```
-
-### 기존 설치 업데이트
+# 현재 프로젝트에 AIWF 설치
+aiwf install
 
-AIWF가 이미 설치되어 있다면 설치 프로그램이 자동으로 감지하고 다음 옵션을 제공합니다:
+# 강제 설치 (프롬프트 건너뛰기)
+aiwf install --force
 
-- 업데이트 (자동 백업 포함)
-- 설치 건너뛰기
-- 취소
+# 도움말 표시
+aiwf --help
 
-### 강제 설치
+# 버전 확인
+aiwf --version
+```
 
-모든 프롬프트를 건너뛰고 강제 설치 (기본값: 한국어):
+### 언어 관리
 
 ```bash
-npx aiwf --force
-```
+# 현재 언어 확인
+aiwf-lang status
 
-### 언어별 설치
+# 언어 변경
+aiwf-lang set ko    # 한국어
+aiwf-lang set en    # 영어
 
-설치 프로그램은 선택한 언어에 따라 적절한 언어 버전을 자동으로 선택합니다:
+# 자동 감지로 리셋
+aiwf-lang reset
+```
 
-- 한국어 버전: 한국어 명령어와 문서 포함 (기본값)
-- English version: English commands and documentation
+### 기존 설치 업데이트
+
+기존 AIWF가 있는 프로젝트에서 `aiwf install` 실행 시:
+- 자동 백업 생성
+- 업데이트 또는 건너뛰기 옵션
+- 설정 보존
 
 ## 📁 설치 내용
 
@@ -111,9 +127,26 @@ your_project/
 - **리뷰**: `/project:aiwf:code_review` - 코드 리뷰
 - **GitHub 연동**: `/project:aiwf:issue_create`, `/project:aiwf:pr_create`
 
-## 📚 문서 참조
+## 📚 문서
+
+### 핵심 문서
+- [명령어 가이드](docs/COMMANDS_GUIDE.ko.md) - 전체 AIWF 명령어 목록
+- [CLI 사용 가이드](docs/CLI_USAGE_GUIDE.ko.md) - 상세한 CLI 도구 문서
+- [시작하기](docs/GETTING_STARTED.md) - 새 사용자를 위한 빠른 시작 가이드
+- [개발 가이드](docs/DEVELOPMENT_GUIDE.ko.md) - AIWF에 기여하기
 
-전체 AIWF 명령어 목록과 자세한 사용법은 [COMMANDS_GUIDE.md](docs/COMMANDS_GUIDE.md)를 참조하세요.
+### 기능 가이드
+- [독립 스프린트 가이드](docs/guides/independent-sprint-guide-ko.md) - YOLO 중심 스프린트 생성
+- [체크포인트 시스템 가이드](docs/guides/checkpoint-system-guide-ko.md) - 복구 및 진행 상황 추적
+- [AI 페르소나 가이드](docs/guides/ai-personas-guide-ko.md) - 전문 AI 페르소나 사용
+- [컨텍스트 압축 가이드](docs/guides/context-compression-guide-ko.md) - 토큰 최적화 전략
+- [기능 Git 통합 가이드](docs/guides/feature-git-integration-guide-ko.md) - Git hooks 및 추적
+
+### 기술 문서
+- [상태 관리 가이드](docs/STATE_MANAGEMENT_GUIDE.ko.md) - 워크플로우 기반 상태 시스템
+- [AI 워크플로우](docs/AI-WORKFLOW.ko.md) - AI 통합 패턴
+- [API 참조](docs/API_REFERENCE.md) - 프로그래머틱 사용
+- [문제 해결](docs/TROUBLESHOOTING.md) - 일반적인 문제 및 해결책
 
 ## ✨ 주요 기능
 
@@ -133,6 +166,59 @@ your_project/
 - 🚀 **Feature Ledger** - 개발 진행 상황 추적을 위한 기능 ID 시스템
 - 🔍 **AI 도구 템플릿** - GitHub Copilot, Cursor, Windsurf, Augment 지원
 - 🪝 **Git Hooks 통합** - git 커밋과 함께 자동 기능 추적
+- 🤖 **워크플로우 기반 상태 관리** - 지능적 작업 우선순위 지정 및 의존성 추적
+- 🎯 **스마트 작업 추천** - 프로젝트 상태 기반 AI 구동 다음 행동 제안
+- 🔄 **적응적 스프린트 관리** - 80% 완료 시 자동 스프린트 생성
+- 🔍 **의존성 분석** - 순환 의존성 감지 및 차단 작업 식별
+
+## 🤖 워크플로우 기반 상태 관리 (신규!)
+
+AIWF는 이제 AI가 프로젝트 컨텍스트를 유지하는 데 도움이 되는 고급 상태 관리 시스템을 포함합니다:
+
+### 상태 관리 명령어
+
+```bash
+# 프로젝트 상태 인덱스 업데이트
+aiwf state update
+
+# 현재 상태 및 추천사항 표시
+aiwf state show
+
+# AI 기반 다음 작업 추천 받기
+aiwf state next
+
+# 워크플로우 일관성 검증
+aiwf state validate
+
+# 작업 시작으로 표시
+aiwf state start <task-id>
+
+# 작업 완료로 표시  
+aiwf state complete <task-id>
+```
+
+### 주요 특징
+
+- **우선순위 매트릭스**: 긴급도(40%), 중요도(30%), 의존성(20%), 노력(10%) 기반 작업 점수화
+- **의존성 추적**: 차단 작업 및 순환 의존성 자동 식별
+- **80% 규칙**: 현재 스프린트가 80% 완료 시 다음 스프린트 준비 권장
+- **워크플로우 검증**: 마일스톤, 스프린트, 작업 전반의 상태 일관성 보장
+- **스마트 추천**: 프로젝트 상태 기반 최적 다음 행동 AI 제안
+
+### YOLO 모드와의 통합
+
+향상된 YOLO 모드는 이제 워크플로우 인텔리전스를 사용합니다:
+
+```bash
+# 워크플로우 기반 작업 선택으로 YOLO 실행
+/project:aiwf:yolo
+
+# 워크플로우 최적화를 통한 스프린트별 실행
+/project:aiwf:yolo S03
+
+# 적응적 스프린트 관리
+/project:aiwf:yolo sprint-all
+```
 
 ## 📁 프로젝트 구조
 
@@ -166,7 +252,7 @@ aiwf/
 ## 📖 소스
 
 이 설치 프로그램은 다음에서 AIWF 프레임워크를 가져옵니다:
-https://github.com/aiwf/aiwf
+https://github.com/moonklabs/aiwf
 
 ## 📝 라이선스
 

package/README.md

@@ -3,7 +3,7 @@
 [Read in Korean (한국어로 보기)](README.ko.md)
 
 [![NPM Version](https://img.shields.io/npm/v/aiwf.svg)](https://www.npmjs.com/package/aiwf)
-[![License](https://img.shields.io/npm/l/aiwf.svg)](https://github.com/aiwf/aiwf/blob/main/LICENSE)
+[![License](https://img.shields.io/npm/l/aiwf.svg)](https://github.com/moonklabs/aiwf/blob/main/LICENSE)
 [![Downloads](https://img.shields.io/npm/dm/aiwf.svg)](https://www.npmjs.com/package/aiwf)
 
 ## What is AIWF?
@@ -14,69 +14,65 @@ This project is an updated version of [Simone](https://github.com/Helmi/claude-s
 
 ## 📦 Installation
 
-Install AIWF in any project directory:
+### Global Installation (Recommended)
 
 ```bash
-npx aiwf
+npm install -g aiwf
 ```
 
-The installer will:
+### First Time Setup
 
-1. **Intelligent Language Detection**: Automatically detect your system language or let you choose
-2. **Language Preference Storage**: Save your language preference for future installations
-3. **Directory Setup**: Create the `.aiwf/` directory structure for project management
-4. **Commands**: Set up `.claude/commands/aiwf/` with localized Claude commands
-5. **Content**: Download the latest templates and documentation in your selected language
+After global installation, navigate to your project directory and run:
+
+```bash
+aiwf install
+```
+
+The installer will guide you through:
+
+1. **Language Selection**: Choose between English and Korean
+2. **Project Setup**: Initialize AIWF in your current directory
+3. **Claude Commands**: Install language-specific commands
+4. **Documentation**: Download guides and templates
 
 ## 🚀 Usage
 
-### First Time Installation
+### Basic Commands
 
 ```bash
-npx aiwf
-```
+# Install AIWF in current project
+aiwf install
 
-### Update Existing Installation
+# Force installation (skip prompts)
+aiwf install --force
 
-If AIWF is already installed, the installer will automatically detect it and offer options to:
+# Show help
+aiwf --help
 
-- Update (with automatic backup)
-- Skip installation
-- Cancel
+# Check version
+aiwf --version
+```
 
 ### Language Management
 
-AIWF includes a sophisticated language management system:
-
 ```bash
-# Check current language settings
+# Check current language
 aiwf-lang status
 
-# Change language interactively
-aiwf-lang set
-
-# Set specific language
-aiwf-lang set ko    # Korean
+# Change language
 aiwf-lang set en    # English
+aiwf-lang set ko    # Korean
 
 # Reset to auto-detection
 aiwf-lang reset
 ```
 
-### Force Installation
-
-Skip all prompts and force installation (uses auto-detected language):
-
-```bash
-npx aiwf --force
-```
-
-### Language-Specific Installation
-
-The installer automatically selects the appropriate language version based on your choice:
+### Update Existing Installation
 
-- English version: English commands and documentation (default)
-- Korean version: Korean commands and documentation
+When running `aiwf install` in a project with existing AIWF:
+- Automatic backup creation
+- Option to update or skip
+- Preserves your settings
 
 ## 📁 What Gets Installed
 
@@ -133,9 +129,49 @@ After installation:
 - **GitHub Integration**: `/project:aiwf:issue_create`, `/project:aiwf:pr_create`
 - **AI Personas**: `/project:aiwf:ai_persona:architect`, `/project:aiwf:ai_persona:debugger`, etc.
 
+### 🚀 YOLO Mode - The Core Feature
+
+YOLO mode is the heart of AIWF, enabling autonomous task execution:
+
+```bash
+# Basic YOLO - processes general tasks then sprint tasks
+/project:aiwf:yolo
+
+# Sprint-specific execution
+/project:aiwf:yolo S03
+
+# Execute all sprints continuously
+/project:aiwf:yolo sprint-all
+
+# Execute all milestones
+/project:aiwf:yolo milestone-all
+
+# Independent sprint creation (no milestone required)
+aiwf sprint-independent --from-readme
+aiwf sprint-independent --from-issue 123
+aiwf sprint-independent "Quick Feature" --minimal
+```
+
 ## 📚 Documentation
 
-For a complete list of AIWF commands and detailed usage, see [COMMANDS_GUIDE.md](docs/COMMANDS_GUIDE.md).
+### Core Documentation
+- [Commands Guide](docs/COMMANDS_GUIDE.md) - Complete list of AIWF commands
+- [CLI Usage Guide](docs/CLI_USAGE_GUIDE.md) - Detailed CLI tool documentation
+- [Getting Started](docs/GETTING_STARTED.md) - Quick start guide for new users
+- [Development Guide](docs/DEVELOPMENT_GUIDE.md) - Contributing to AIWF
+
+### Feature Guides
+- [Independent Sprint Guide](docs/guides/independent-sprint-guide.md) - YOLO-focused sprint creation
+- [Checkpoint System Guide](docs/guides/checkpoint-system-guide.md) - Recovery and progress tracking
+- [AI Personas Guide](docs/guides/ai-personas-guide.md) - Using specialized AI personas
+- [Context Compression Guide](docs/guides/context-compression-guide.md) - Token optimization strategies
+- [Feature Git Integration Guide](docs/guides/feature-git-integration-guide.md) - Git hooks and tracking
+
+### Technical Documentation
+- [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
+- [Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues and solutions
 
 ## ✨ Features
 
@@ -155,6 +191,82 @@ For a complete list of AIWF commands and detailed usage, see [COMMANDS_GUIDE.md]
 - 🚀 **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
+- 🎯 **Smart Task Recommendations** - AI-powered next action suggestions based on project state
+- 🔄 **Adaptive Sprint Management** - Automatic sprint generation at 80% completion
+- 🔍 **Dependency Analysis** - Circular dependency detection and blocking task identification
+- 🏃 **Independent Sprints** - Create and run sprints without milestone dependencies
+- 🛡️ **Overengineering Prevention** - Built-in guards to maintain simplicity and focus
+- 💾 **Checkpoint System** - Save and restore YOLO execution state for resilience
+
+## 🤖 Workflow-Based State Management (NEW!)
+
+AIWF now includes an advanced state management system that helps AI maintain project context:
+
+### State Management Commands
+
+```bash
+# Update project state index
+aiwf state update
+
+# Show current state and recommendations
+aiwf state show
+
+# Get AI-powered next task recommendations
+aiwf state next
+
+# Validate workflow consistency
+aiwf state validate
+
+# Mark task as started
+aiwf state start <task-id>
+
+# Mark task as completed  
+aiwf state complete <task-id>
+```
+
+### Key Features
+
+- **Priority Matrix**: Tasks are scored based on urgency (40%), importance (30%), dependencies (20%), and effort (10%)
+- **Dependency Tracking**: Automatically identifies blocking tasks and circular dependencies
+- **80% Rule**: Recommends preparing next sprint when current sprint reaches 80% completion
+- **Workflow Validation**: Ensures state consistency across milestones, sprints, and tasks
+- **Smart Recommendations**: AI suggests optimal next actions based on project state
+
+### Integration with YOLO Mode
+
+The enhanced YOLO mode now uses workflow intelligence:
+
+```bash
+# Run YOLO with workflow-based task selection
+/project:aiwf:yolo
+
+# Sprint-specific with workflow optimization
+/project:aiwf:yolo S03
+
+# Adaptive sprint management
+/project:aiwf:yolo sprint-all
+```
+
+### 🛡️ Overengineering Prevention
+
+AIWF includes built-in guards to prevent overengineering:
+
+- **Configurable Engineering Levels**: minimal, balanced, complete
+- **Focus Rules**: requirement_first, simple_solution, no_gold_plating
+- **Code Complexity Checks**: file size, function length, nesting depth limits
+- **Design Pattern Limits**: prevents excessive abstraction
+- **YAGNI Enforcement**: no future-proofing without current need
+
+Configure in `.aiwf/yolo-config.yaml`:
+
+```yaml
+engineering_level: minimal
+focus_rules:
+  requirement_first: true
+  simple_solution: true
+  no_gold_plating: true
+```
 
 ## 📁 Project Structure
 
@@ -188,7 +300,7 @@ aiwf/
 ## 📖 Source
 
 This installer fetches the AIWF framework from:
-<https://github.com/aiwf/aiwf>
+<https://github.com/moonklabs/aiwf>
 
 ## 📝 License