FAQ - Frequently Asked Questions

[GoosLab]

Frequently Asked Questions (FAQ) ❓

Common questions and answers about MoAI-ADK.

---

Q: What is MoAI-ADK?

A: MoAI-ADK (Agentic Development Kit) is an AI-powered development framework for Claude Code. It provides 20+ specialized agents, 50+ skills, and a SPEC-driven development workflow with DDD/TDD methodologies.

---

Q: What's the difference between MoAI-ADK (Python) and MoAI-ADK (Go)?

A: The Go version is the next-generation rewrite with:

• Faster execution (compiled binary vs Python runtime)
• Simpler installation (go install — no uv/pip dependency)
• Cross-platform support (Linux, macOS, Windows)
• Embedded templates (single binary distribution)
• Hook system using shell scripts (no Python dependency)

---

Q: How do I update MoAI-ADK?

A:

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

# Sync project templates
moai update

---

Q: What development modes are available?

A: Three modes configured in .moai/config/sections/quality.yaml:

Mode	Best For	Cycle
DDD	Legacy refactoring	ANALYZE → PRESERVE → IMPROVE
TDD	New features	RED → GREEN → REFACTOR
Hybrid (default)	All development	TDD for new + DDD for legacy

---

Q: How do Agent Teams work?

A: Agent Teams is an experimental feature that enables parallel multi-agent execution:

1. Set CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 in settings
2. Enable in .moai/config/sections/workflow.yaml
3. Use --team flag: /moai run SPEC-XXX --team

Team agents include researchers, architects, backend/frontend devs, testers, and quality validators.

---

Q: What languages does MoAI-ADK support?

A: MoAI-ADK supports conversation in Korean, English, Japanese, and Chinese. It includes language-specific skills for Go, Python, TypeScript, Rust, Java, Kotlin, Swift, Ruby, PHP, C++, C#, Scala, R, Elixir, Flutter/Dart, and JavaScript.

---

Q: How do I report a bug?

A: Use the Bug Report template or run:

/moai feedback

---

Q: Can I use MoAI-ADK with other AI tools?

A: Yes! MoAI-ADK integrates with:

• Claude Code (primary platform)
• CodeRabbit (AI code review)
• Context7 MCP (library documentation)
• Sequential Thinking MCP (complex analysis)

---

Have a question not listed here? Ask in Q&A!