aiwf 0.3.15 → 0.3.17

package/README.ko.md

@@ -131,7 +131,7 @@ your_project/
 ### 주요 명령어
 
 - **초기화**: `/project:aiwf:initialize` - 프로젝트 초기 설정
-- **계획**: `/project:aiwf:plan_milestone` - 마일스톤 계획 수립
+- **계획**: `/project:aiwf:aiwf_create_milestone_plan` - 마일스톤 계획 수립
 - **스프린트**: `/project:aiwf:create_sprints_from_milestone` - 스프린트 생성
 - **작업**: `/project:aiwf:do_task` - 작업 실행
 - **리뷰**: `/project:aiwf:code_review` - 코드 리뷰
@@ -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

@@ -8,10 +8,33 @@
 
 ## What is AIWF?
 
-AIWF is a markdown-based project management framework designed specifically for AI-assisted development with Claude Code. It helps break down software projects into manageable units that AI can effectively handle, maximizing productivity.
+AIWF is an AI-powered workflow framework that enables autonomous software development with Claude Code. It provides intelligent command sets and workflow definitions that allow AI to manage entire project lifecycles - from planning to deployment - with minimal human intervention.
 
 This project is an updated version of [Simone](https://github.com/Helmi/claude-simone).
 
+## ✨ Core Features
+
+### 🤖 **Agent-Based Autonomous Development**
+Multi-agent architecture where AIWF acts as the master orchestrator managing entire development workflows, while Claude Code operates as specialized subagents handling specific tasks. YOLO mode enables completely autonomous development - AI handles planning, coding, testing, and deployment without human intervention. Built-in checkpoint system ensures resilience and recovery.
+
+### 🧠 **Intelligent Task Management**  
+Workflow-based state management with dependency tracking, priority calculation, and smart task recommendations. AI understands project context and suggests optimal next actions.
+
+### 🎭 **Specialized AI Personas**
+Five expert personas (Architect, Security, Frontend, Backend, Data Analyst) with specialized knowledge bases and context-aware compression for domain-specific optimization.
+
+### 🧬 **Advanced Context Engineering**
+Intelligent context construction and optimization that maximizes AI effectiveness while minimizing token usage. Dynamic context compression, workflow-aware prompt engineering, and automatic relevance filtering ensure AI always has the right information at the right time.
+
+### 💡 **Smart Context Management**
+Token-efficient context strategies with automatic compression, intelligent chunking, and relevance scoring. Maintains comprehensive project understanding while optimizing for AI model limits and performance.
+
+### 🔄 **Multi-Agent Architecture** 
+AIWF operates as the master orchestration agent that coordinates complex development workflows. Claude Code instances function as specialized subagents, each handling specific domains like coding, testing, or documentation. This distributed approach enables parallel processing, fault tolerance, and specialized expertise application.
+
+### 🔗 **Seamless Integration**
+Native support for Claude Code, Cursor, Windsurf, GitHub, and Git with automated hooks, issue creation, and PR management.
+
 ## 📦 Installation
 
 ### Global Installation (Recommended)
@@ -35,54 +58,88 @@ The installer will guide you through:
 3. **Claude Commands**: Install language-specific commands
 4. **Documentation**: Download guides and templates
 
-## 🚀 Usage
-
-### Basic Commands
+## 🚀 Getting Started Guide
 
+### Step 1: Installation
 ```bash
-# Install AIWF in current project
+# Install globally
+npm install -g aiwf
+
+# Setup in your project directory
+cd your-project
 aiwf install
+```
 
-# Force complete reinstall (skip prompts, overwrite everything)
-aiwf install --force
+### Step 2: Project Planning Phase
+Enter **Plan Mode** - describe what you want to build and your project goals. **Do not start coding yet.**
+- Engage in thorough Q&A to clarify objectives
+- Define project scope and requirements
+- Set clear success criteria
 
-# Show help
-aiwf --help
+### Step 3: Initialize Project Framework
+```bash
+# Create/update Claude configuration
+/init
 
-# Check version
-aiwf --version
+# Initialize AIWF framework (creates first milestone)
+/project:aiwf:aiwf_initialize
 ```
 
-### Language Management
+### Step 4: Create Sprint Plans
+```bash
+# Generate sprints from milestone (first sprint becomes active)
+/project:aiwf:aiwf_create_sprints_from_milestone M01
 
+# If only one milestone exists, you can omit the milestone code
+/project:aiwf:aiwf_create_sprints_from_milestone
+```
+
+### Step 5: Review and Refine
+Review generated plans and refine through Q&A until satisfied with the approach.
+
+### Step 6: Generate Task Lists
 ```bash
-# Check current language
-aiwf-lang status
+# Create detailed tasks for active sprint (first task becomes active)
+/project:aiwf:aiwf_create_sprint_tasks
+```
 
-# Change language
-aiwf-lang set en    # English
-aiwf-lang set ko    # Korean
+### Step 7: Execute Development
+```bash
+# Execute individual task
+/project:aiwf:aiwf_do_task [task-id]
 
-# Reset to auto-detection
-aiwf-lang reset
+# OR run autonomous development for entire sprint
+/project:aiwf:aiwf_yolo
 ```
 
-### Update Existing Installation
+**YOLO Mode** orchestrates multiple Claude Code subagents to execute all sprint tasks continuously without interruption. The master agent coordinates planning while specialized subagents handle coding, testing, documentation, and commits automatically.
 
-When running `aiwf install` in a project with existing AIWF, you'll get these options:
+### Key Commands
+
+- **Initialize**: `/project:aiwf:aiwf_initialize` - Initial project setup
+- **Plan**: `/project:aiwf:aiwf_create_milestone_plan` - Create milestone plans
+- **Sprint**: `/project:aiwf:aiwf_create_sprints_from_milestone` - Generate sprints
+- **Task**: `/project:aiwf:aiwf_do_task` - Execute tasks
+- **Review**: `/project:aiwf:aiwf_code_review` - Code review
+- **GitHub Integration**: `/project:aiwf:aiwf_issue_create`, `/project:aiwf:aiwf_pr_create`
+- **AI Personas**: `/project:aiwf:aiwf_ai_persona_architect`, `/project:aiwf:aiwf_ai_persona_debugger`, etc.
 
-#### Interactive Mode
-1. **Update**: Updates commands and docs only, preserves work content
-2. **Complete Reinstall**: Fresh installation, overwrites existing project
-3. **Skip**: Cancel installation
+### 🚀 YOLO Mode - Autonomous AI Development
 
-#### Command Line Options
-- `--force`: Skip all prompts and perform complete reinstall
+Revolutionary multi-agent orchestration that enables completely autonomous development workflows. AIWF acts as the master agent coordinating multiple Claude Code subagents:
 
-#### 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)
+```bash
+# Full autonomous development - AI handles everything
+/project:aiwf:aiwf_yolo
+
+# Target specific sprint execution  
+/project:aiwf:aiwf_yolo S03
+
+# Continuous multi-sprint development
+/project:aiwf:aiwf_yolo sprint-all
+```
+
+Master agent analyzes requirements and coordinates specialized subagents that create tasks, write code, run tests, and commit changes - achieving true multi-agent autonomous software development.
 
 ## 📁 What Gets Installed
 
@@ -121,47 +178,6 @@ Based on your language selection, you'll get:
 - Korean documentation and templates
 - Localized project management content
 
-## 🎯 Getting Started
-
-After installation:
-
-1. Open your project in Claude Code
-2. Use `/project:aiwf` commands to manage your project
-3. Start with `/project:aiwf:initialize` to set up your project
-
-### Key Commands
-
-- **Initialize**: `/project:aiwf:initialize` - Initial project setup
-- **Plan**: `/project:aiwf:plan_milestone` - Create milestone plans
-- **Sprint**: `/project:aiwf:create_sprints_from_milestone` - Generate sprints
-- **Task**: `/project:aiwf:do_task` - Execute tasks
-- **Review**: `/project:aiwf:code_review` - Code review
-- **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
 
 ### Core Documentation
@@ -178,135 +194,13 @@ 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
-
-- 🌍 **Multi-language Support** - Complete English and Korean support
-- 🎨 **Beautiful CLI** - User-friendly interface with colors and progress indicators
-- 🔄 **Smart Updates** - Intelligent update detection with automatic backups
-- 📦 **Direct Download** - Downloads directly from official GitHub repository
-- 🚀 **Easy to Use** - Works with `npx` - no global installation needed
-- 💾 **Safe Backups** - Creates timestamped backups when updating
-- 🎯 **Language-Specific** - Language-specific commands and documentation
-- 🔧 **IDE Integration** - Cursor and Windsurf development rules support
-- 🔗 **GitHub Integration** - Automated issue and PR creation
-- 📊 **Project Tracking** - Systematic management of milestones, sprints, and tasks
-- 🎭 **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
-- 🎯 **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
-
-```
-aiwf/
-├── ai-tools/           # AI tool-specific configurations
-├── 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
-├── rules/              # Development rules and guidelines
-├── scripts/            # Build and utility scripts
-├── templates/          # Project templates (api-server, npm-library, web-app)
-├── tests/              # Test suites
-└── utils/              # Utility modules
-```
-
-### Key Directories
-
-- **feature-ledger/**: Tracks feature development status and git commit relationships
-- **hooks/**: Contains git hooks (post-commit) for automatic feature tracking
-
-## 🔧 Requirements
-
-- Node.js 14.0.0 or higher
-- Internet connection to download from GitHub
-
 ## 📖 Source
 
 This installer fetches the AIWF framework from: