aiwf

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.

🔌 Claude Code Plugin System

AIWF is built as a Claude Code Plugin following the official Anthropic plugin architecture. The framework is organized into 4 specialized plugins:

aiwf/
├── .claude-plugin/
│   └── marketplace.json    # Plugin registry
└── plugins/
    ├── aiwf-core/     (26 files) → Session, YOLO, Sprint/Task management
    ├── aiwf-dev/      (19 files) → TDD, DevOps automation
    ├── aiwf-experts/  (24 files) → Expert agents (architects, reviewers)
    └── aiwf-tools/    (51 files) → Development tools

Plugin Overview

Plugin	Description	Key Features
aiwf-core	Core framework	Session management, YOLO mode, Sprint/Task execution
aiwf-dev	Development workflow	TDD (red/green/refactor), DevOps, CI/CD
aiwf-experts	Expert agents	Build fixers, architects, code reviewers
aiwf-tools	Utility tools	Refactoring, debugging, API scaffolding, docs

✨ 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

Option 1: Claude Code Plugin (Recommended)

Install AIWF as a Claude Code plugin directly:

# From GitHub repository
claude plugin add https://github.com/moonklabs/aiwf

# Or from local path (for development)
claude plugin add /path/to/aiwf

After installation, verify the plugins are loaded:

claude plugin list

You should see 4 AIWF plugins:

• aiwf-core - Session, YOLO, Sprint/Task
• aiwf-dev - TDD, DevOps
• aiwf-experts - Expert agents
• aiwf-tools - Development tools

Option 2: NPM Global Installation

npm install -g aiwf

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. Plugin Installation: Install Claude Code plugins
4. Documentation: Download guides and templates
5. Validation: Comprehensive installation verification

🚀 Getting Started Guide