Skip to main content
SECTION · CORE CONCEPTS

Core Concepts

The foundational principles behind MoAI-ADK — SPEC-First development, DDD/TDD, the TRUST 5 quality framework, and dedicated agents.

Info
Belongs to: Agentic Harness

Core Concepts: Harness structure

This section introduces the core concepts you need to understand MoAI-ADK v3.0. The value of v3.0 comes down to three core elements — Tokenomics (Token Economics), Agentic Loop Engineering, and the Agentic Harness. The documents in this section unpack, one by one, how those three core elements work in a real development flow.

Info
New here? Read top to bottom in order and the full picture of MoAI-ADK falls into place naturally. Each document can also be read on its own.

Three Core Elements

Core ElementKey QuestionRepresentative Document
TokenomicsHow do we get the same quality with fewer tokens?What is MoAI-ADK?
Agentic Loop EngineeringHow does the loop work and learn on its own?Harness Engineering
Agentic HarnessHow do we design an environment where agents work well?SPEC-Based Development · TRUST 5
flowchart TD
    A["What is MoAI-ADK?"] --> B["Harness Engineering"]
    B --> C["SPEC-Based Development"]
    C --> D["Development Methodology (DDD/TDD)"]
    D --> E["TRUST 5 Quality"]
    E --> F["Constitution System"]

    A -.- A1["Understand the three core elements\nand the overall architecture"]
    B -.- B1["The paradigm of designing\nthe environment agents work in"]
    C -.- C1["The Plan phase: defining\nrequirements as documents"]
    D -.- D1["The Run phase: implementing\ncode safely"]
    E -.- E1["Verify every phase with\nfive quality principles"]
    F -.- F1["The safeguard separating\nfrozen rules from evolvable rules"]

Learning Order

OrderDocumentKey Question
1What is MoAI-ADK?What is MoAI-ADK, and why does it aim for tokenomics?
2Harness EngineeringWhat does it mean to design the environment instead of writing code directly?
3SPEC-Based DevelopmentHow do we define and manage requirements clearly?
4Development Methodology (DDD/TDD)How do we improve existing code without breaking it?
5TRUST 5 QualityBy what standards is code quality guaranteed?
6Constitution SystemWhen the harness evolves on its own, what governs that evolution?
Info
Summarized as a flow: decide what to build with a SPEC, build it safely with DDD/TDD, and verify quality with TRUST 5. The harness wraps this entire loop, and as the loop runs the harness learns and its guidance evolves — the safeguard for that evolution is the Constitution.