modu-ai/moai-adk

API Patterns Reference documents REST and GraphQL API design patterns, error handling conventions, and input validation for backend development. Use it when designing, implementing, or reviewing backend API endpoints.

Backend Development covers API design, database integration, microservices, and backend security patterns for building server-side applications. Use it when designing APIs, implementing server logic, authentication, or authorization.

CI Loop polls required pull request checks, classifies mechanical vs semantic failures, and applies safe automated patches up to three iterations before escalating to the user. Use it after creating a PR with /moai sync to monitor CI and auto-fix failures.

Claude Code Authoring Kit is a comprehensive reference for creating and configuring Claude Code extensions, covering Skills, sub-agents, plugins, slash commands, hooks, memory, settings, sandboxing, headless mode, and advanced agent patterns.

Cross-Model Audit Convergence documents how plan-auditor and sync-auditor agents invoke the audit_multi MCP tool to run code review across codex and GLM backends in parallel, converge their verdicts with Claude, and fold per-backend verdicts and a disagreement flag into audit output. Use it when a project sets audit_model to multi.

Database Domain Specialist provides patterns and implementations for PostgreSQL, MongoDB, Redis, Oracle, and cloud databases. Use it for schema design, query optimization, indexing, data modeling, and cloud database selection.

Docs i18n Rules defines hard internationalization rules for the moai-adk-go README and docs-site, covering canonical locale chains, simultaneous 4-locale updates, Mermaid TD-only diagrams, no-emoji in body text, emphasis-marker spacing, URL blacklist, version SSOT, and immutable Vercel binding. Loaded first by documentation specialists before any edit.

Frontend Development Specialist covers React 19, Next.js 16, Vue 3.5, and modern UI/UX patterns with component architecture. Use it when building web UIs, implementing components, optimizing frontend performance, or integrating state management.

HNS LSEL Applier consumes approved decision.json records to drive the local self-evolution apply hook, validating targets against a frozen allowlist and applying patches. Use it during the APPLY pass of the LSEL loop when a proposal is approved and ready to be committed.

HNS OSS Docs Structure Map documents exact paths and schemas for the HNS OSS docs site, including Hugo config, locale metadata, sidebar menu icons, and Vercel redirects. Use it before editing navigation or configuration in the docs-site so changes stay consistent across all four locales.

HNS OSS Docs Verify runs inlined read-only checks that gate documentation quality before returning to the orchestrator. It validates Hugo build warnings, sitemap existence, URL blacklist, Mermaid direction, 4-locale file and section parity, README heading parity, and body emoji usage.

HTML Report Renderer converts markdown reports into self-contained single-file HTML files with audience-tier enrichment and inline SVG charts. Use it when a report must be email-attached, printed, or viewed offline.

Kanban Foreman Loop Iteration runs one unattended pass of a kanban queue, dispatching the next operator-picked card to an isolated worker and collecting completion evidence before reporting. Use it as the body of a bare /loop or to test one cycle by hand.

LSEL Curator drains the .moai/lessons-inbox.jsonl, filters Bash timeout/sandbox noise, clusters remaining failures by event key, and stages high-signal candidates for the Local Self-Evolution Loop. Use it to turn raw tool failure stubs into curated proposal candidates.

MoAI ADK Go Best Practices codifies quality gates, test isolation, hardcoding prevention, and agent-boundary rules for harness specialists. Use it when authoring or reviewing moai-adk-go code to enforce TRUST 5 quality gates and verification-claim integrity.

MoAI Foundation Core provides foundational principles for MoAI-ADK, including the TRUST 5 quality framework, SPEC-First DDD methodology, delegation patterns, progressive disclosure, and token budget management. Use for TRUST 5 gates, SPEC workflow, or context optimization.

MoAI Foundation Quality documents the TRUST 5 quality principles and how MoAI enforces them through agents, the 3-level harness, /moai gate, and sync-auditor scoring. Use it for code review, quality gate checks, coverage targets, or TRUST 5 compliance.

MoAI Foundation Thinking provides structured frameworks for critical evaluation, diverge-converge brainstorming, and deep questioning to analyze proposals, generate solutions, and explore complex problems. Use it for ideation, strategic analysis, architecture decisions, and deep reasoning.

MoAI Harness Learner coordinates the harness learning subsystem, producing Tier 4 auto-update proposal payloads for the MoAI orchestrator to surface via AskUserQuestion, and manages Apply/Rollback workflows.

Moai ADK Domain Patterns is a reference for the four harness specialists working on the moai-adk-go Go codebase and templates. It covers the CLI/template/config/hook/spec subsystem architecture, key source paths, specialist delegation map, template-first build cycle, namespace separation contract, and common add-a-template/add-a-hook/add-an-agent/add-a-SPEC workflows.

Moai ADK Go Dev Reference provides version management, release process, shell-script hook development, and build/dev commands for moai-adk-go local development. Load it only when performing these specific tasks.

Moai Domain Humanize detects and removes AI tells from generated text while preserving meaning, facts, and figures. Use it for Korean, English, Japanese, and Chinese prose or marketing copy to make AI text read as human-authored.

Moai Meta Harness is a deprecated legacy 7-phase meta-harness that redirects to the v4 harness Builder (/moai:harness) for new harness creation. Use it only for backward-compatible invocation paths that reference the old 7-phase workflow.

README 4-File Sync guides editing the canonical Korean README and deriving the English, Japanese, and Chinese versions with shared header and section-order parity. Use it when updating repo README files that must stay synchronized.

SVG Technical Infographic produces hand-editable SVG diagrams, computing geometry numerically before writing markup and rendering a 2x PNG via headless Chromium. Use it for static technical infographics—architecture, flow, comparison, hierarchy—when pixel-level control or CJK text wrapping is required.