Getting Started Guide

[GoosLab]

Getting Started with MoAI-ADK 🚀

A quick guide to installing and using MoAI-ADK.

Prerequisites

• Go 1.25+ — Install Go
• Claude Code — Install Claude Code
• Git — For version control

Installation

# Install via Go
go install github.com/modu-ai/moai-adk/cmd/moai@latest

# Verify installation
moai --version

Quick Start

1. Initialize a New Project

# Create a new project with MoAI-ADK
moai init my-project
cd my-project

# Or initialize in an existing project
cd existing-project
moai init .

2. The Init Wizard

The wizard will ask you to configure:

• Language — Korean, English, Japanese, Chinese
• Development Mode — DDD, TDD, or Hybrid
• Agent Teams — Enable experimental team mode

3. Start Developing

# Open Claude Code in your project
claude

# Use MoAI commands
/moai plan "Add user authentication"    # Create SPEC
/moai run SPEC-AUTH-001                 # Implement with DDD/TDD
/moai sync SPEC-AUTH-001                # Generate docs
/moai fix                               # Auto-fix errors

Key Concepts

Concept	Description
SPEC	Specification document using EARS format
Agents	20+ specialized AI agents for different tasks
Skills	50+ domain-specific knowledge packages
TRUST 5	Quality framework (Tested, Readable, Unified, Secured, Trackable)
DDD/TDD	Development methodologies for code quality

Updating

# Update to latest version
go install github.com/modu-ai/moai-adk/cmd/moai@latest

# Sync project templates
moai update

Need Help?

• 🙏 Ask in Q&A
• 🐛 Report bugs via Issues
• 💡 Suggest features in Ideas