This is the onboarding path for anyone meeting MoAI-ADK for the first time. Read in the order Introduction → Installation → Quick Start and you can have your first MoAI-ADK project running within 30 minutes. Installation is nothing more than downloading a single binary, and no extra runtime or dependency is needed to run your first SPEC.

Info
If you have already finished installing, jump straight to the Quick Start. Curious about CLI flags? See the CLI Reference. Having trouble? Check the FAQ.

Learning Flow

flowchart TD
    A["Introduction
WHAT/WHY"] --> B["Installation
Environment setup"]
    B --> C["Initial Setup
moai init"]
    C --> D["Quick Start
Run your first SPEC"]
    D --> E["Update · Profile
Ongoing operation"]
    E --> F["CLI · FAQ
Reference material"]

Recommended Reading Order

Order	Document	Key Content
1	Introduction	What MoAI-ADK is and which problems it solves
2	Installation	Installation and prerequisites on macOS/Linux
3	Windows Guide	Special considerations for Windows environments
4	Initial Setup	Configure your project with the `moai init` interactive wizard
5	Quick Start	Create your first SPEC and run `/moai plan → run → sync`
6	Update	Keep templates on the latest version
7	Profile Management	User profile, environment variables, and settings sync
8	CLI Reference	Full subcommand index for the `moai` binary
9	FAQ	Common issues during installation and execution, with solutions

Info
Next step: Once installation is done, head to Core Concepts to learn the three core ideas behind v3.0 — Tokenomics · Agentic Loop Engineering · Agentic Harness — and MoAI-ADK’s design philosophy including SPEC, DDD, and TRUST 5.