AIWF (AI Workflow Framework)

Read in Korean (한국어로 보기)

What is AIWF?

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.

✨ 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.

✅ Robust Validation System

Advanced installation validation with intelligent file checking, dependency verification, and automated troubleshooting. Enhanced validation architecture ensures reliable framework setup and operation.

📦 Installation

Global Installation (Recommended)

npm install -g aiwf

First Time Setup

After global installation, navigate to your project directory and run:

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
5. Validation: Comprehensive installation verification and troubleshooting

🚀 Getting Started Guide

Step 1: Installation

# Install globally
npm install -g aiwf

# Setup in your project directory
cd your-project
aiwf install

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

Step 3: Initialize Project Framework

# Create/update Claude configuration
/init

# Initialize AIWF framework (creates first milestone)
/project:aiwf:aiwf_initialize

Step 4: Create Sprint Plans

# 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

# Create detailed tasks for active sprint (first task becomes active)
/project:aiwf:aiwf_create_sprint_tasks

Step 7: Execute Development

# Execute individual task
/project:aiwf:aiwf_do_task [task-id]

# OR run autonomous development for entire sprint
/project:aiwf:aiwf_yolo

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.

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.

🚀 YOLO Mode - Autonomous AI Development

Revolutionary multi-agent orchestration that enables completely autonomous development workflows. AIWF acts as the master agent coordinating multiple Claude Code subagents:

# 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.

🛠️ CLI Tools

AIWF provides several specialized CLI tools for different aspects of project management:

Main CLI Commands

• aiwf install - Install AIWF framework in current project
• aiwf create-project - Create new project from templates
• aiwf compress - Context compression for token optimization
• aiwf token - Token usage monitoring and management
• aiwf persona - AI persona management
• aiwf evaluate - AI response and code quality evaluation

Sprint Management (aiwf-sprint)

• aiwf-sprint create - Create new independent sprint
• aiwf-sprint list - List all sprints
• aiwf-sprint status - Show sprint status and progress
• aiwf-sprint task create - Add tasks to sprint
• aiwf-sprint task execute - Execute sprint tasks

Checkpoint System (aiwf-checkpoint)

• aiwf-checkpoint create - Create project checkpoint for rollback
• aiwf-checkpoint list - List all available checkpoints
• aiwf-checkpoint restore - Restore project to previous checkpoint

Language Management (aiwf-lang)

• aiwf-lang status - Check current language settings
• aiwf-lang set ko - Switch to Korean
• aiwf-lang set en - Switch to English

Cache Management (aiwf-cache)

• aiwf-cache download - Download templates to local cache
• aiwf-cache list - List all cached templates
• aiwf-cache clean - Clean cache storage
• aiwf-cache update - Update cached templates
• aiwf-cache status - Check cache status and usage

📁 What Gets Installed

Directory Structure

your_project/
├── .aiwf/                        # Project management root
│   ├── 00_PROJECT_MANIFEST.md    # Central tracking document
│   ├── 01_PROJECT_DOCS/          # Project documentation
│   ├── 02_REQUIREMENTS/          # Milestone requirements
│   ├── 03_SPRINTS/              # Sprint execution tracking
│   ├── 04_GENERAL_TASKS/        # Standalone tasks
│   ├── 05_ARCHITECTURAL_DECISIONS/ # ADR documents
│   ├── 10_STATE_OF_PROJECT/     # Project state snapshots
│   ├── 98_PROMPTS/              # Useful AI prompts
│   └── 99_TEMPLATES/            # Document templates
├── .claude/commands/aiwf/       # Language-specific Claude commands
├── .cursor/rules/               # Cursor IDE development rules
└── .windsurf/rules/             # Windsurf IDE development rules

Language-Specific Content

Based on your language selection, you'll get:

English Version (en/) (Default):

• English Claude commands
• English documentation and templates
• Standard project management content

Korean Version (ko/):

• Korean Claude commands (with _kr suffix available)
• Korean documentation and templates
• Localized project management content

🏗️ Code Architecture

Optimized Validation System

AIWF features a significantly improved validation system that ensures reliable installation and operation:

Key Improvements in v0.3.18+

• 86% Code Reduction: Streamlined validator.js from 348 lines to 48 lines
• Unified Interface: Single validateInstallation() function replaces 3 redundant methods
• Constants-Based Configuration: All validation parameters centralized in VALIDATION_CONSTANTS
• Enhanced Error Reporting: Specific, actionable error messages with detailed diagnostics

VALIDATION_CONSTANTS Structure

const VALIDATION_CONSTANTS = {
  MIN_FILE_SIZE: 10,              // Minimum file size requirement
  MIN_RULE_FILE_SIZE: 50,         // Minimum size for AI tool rule files
  MIN_FILE_COUNT: {
    CURSOR_MDC: 2,                // Required .mdc files for Cursor
    WINDSURF_MD: 2,               // Required .md files for Windsurf  
    CLAUDE_COMMANDS: 4            // Required command files for Claude
  }
};

Validation Features

• Multi-Tool Support: Validates Claude Code, Cursor, Windsurf, and Gemini CLI
• File Integrity Checks: Size validation, accessibility verification, and structure validation
• Intelligent Error Recovery: Detailed troubleshooting guidance for failed validations
• Performance Optimized: Faster execution with reduced memory footprint

Clean Architecture Principles

The codebase follows clean architecture principles for maintainability and extensibility:

Eliminated Code Duplication

• Unified Validation Logic: Consolidated validation functions eliminate redundancy
• Shared Constants: Centralized configuration reduces maintenance overhead
• Streamlined Error Handling: Consistent error reporting across all validation types

Improved Developer Experience

• Clear Separation of Concerns: Validation, file management, and error reporting are properly isolated
• Maintainable Code Structure: Reduced complexity makes the codebase easier to understand and modify
• Performance Benefits: Optimized code paths improve installation speed and reliability

📚 Documentation

Core Documentation

• Commands Guide - Complete list of AIWF commands
• CLI Usage Guide - Detailed CLI tool documentation
• Getting Started - Quick start guide for new users
• Development Guide - Contributing to AIWF

Feature Guides

• Independent Sprint Guide - YOLO-focused sprint creation
• Checkpoint System Guide - Recovery and progress tracking
• AI Personas Guide - Using specialized AI personas
• Context Compression Guide - Token optimization strategies
• Feature Git Integration Guide - Git hooks and tracking

Technical Documentation

• Architecture - System architecture and design
• State Management Guide - Workflow-based state system
• AI Workflow - AI integration patterns
• API Reference - Programmatic usage
• Complete API Reference - Comprehensive API documentation
• Validator API Reference - Validation system API documentation
• Code Cleanup Guide - Code cleanup principles and patterns
• Troubleshooting - Common issues and solutions

📖 Source

This installer fetches the AIWF framework from: https://github.com/moonklabs/aiwf

📝 License

MIT