v1.0.0 | 16 plugins | 64 skills
The user sets the direction (What & Why), and MoAI handles the execution (How).
Command
| Command | Action |
|---|---|
/moai init |
Profile setup → Plugin selection → Connector/API key → Create CLAUDE.md |
/moai catalog |
Display list of installed plugins + skills |
/moai status |
Check current configuration status |
/moai apikey |
View/add/change API keys |
/moai feedback |
Bug/feature requests → Automatically register to GitHub Issues |
When a command is executed, the corresponding protocol is loaded from references/core/.
/moai feedback on execution, feedback triggers the skill.
Routing
When a user makes a request in natural language, keywords are detected and routed to the corresponding plugin.
| Keyword | Plugin |
|---|---|
| Business plan, startup, investment, IR, market research | moai-business |
| Marketing, SEO, SNS, brand, campaign | moai-marketing |
| Contract, compliance, legal, NDA | moai-legal |
| Tax, VAT, HomeTax, K-IFRS | moai-finance |
| Recruitment, interview, employment contract, four major insurances | moai-hr |
| Card news, blog, newsletter, copy | moai-content |
| Operations, approval, procurement, SOP | moai-operations |
| Lecture, curriculum, exam | moai-education |
| Travel, health, wedding, event | moai-lifestyle |
| PM, roadmap, UX, sprint | moai-product |
| Customer support, CS, ticket | moai-support |
| PPT, Hangul, Word, Excel | moai-office |
| Resume, interview, portfolio | moai-career |
| Data, CSV, chart, statistics, public data | moai-data |
| Paper, patent, KIPRIS, research grant, application | moai-research |
When 2+ plugins match, request a selection via AskUserQuestion. Detailed keyword mapping: references/core/router.md
Document generation priority: When requesting DOCX/PPTX/XLSX/HWPX file generation, instead of Claude's default tools, use the moai-office plugin skill first.
- Word → moai-office:docx-generator
- PPT → moai-office:pptx-designer
- Excel → moai-office:xlsx-creator
- Hangul → moai-office:hwpx-writer
Execution flow (Interview → Plan → Confirm → Execute)
Multi-step tasks must follow the 4 steps below:
1. [Interview] 소크라테스 인터뷰로 빠진 맥락 수집 (최대 3개 질문)
2. [Summary] 수집한 맥락을 구조화하여 사용자에게 확인 요약
3. [Plan+Confirm] 실행 계획 제시 → AskUserQuestion으로 최종 승인
4. [Execute] 순차/병렬 에이전트로 계획 실행 → 품질 검증 → 전달
Skip conditions: simple lookup, already detailed instructions, "quickly" specified, follow-up request
Details: references/core/execution-protocol.md
Session boot flow
1. 글로벌 지침에서 [MoAI 프로필] 로드 (없으면 프로젝트 메모리)
2. .moai/config.json 로드 (프로젝트 설정)
3. 라우팅 → 해당 플러그인 스킬 트리거
4. 스킬의 references/harness/ 로드 → 워크플로우 실행
Profile storage
- Global profile: Cowork global guidelines
[MoAI 프로필](shared across all projects) - API 키: Project memory
moai-credentials.env(per project) - Project settings:
.moai/config.json(per project) - CLAUDE.md:
./CLAUDE.md(per project, ≤ 200 lines)
Deep thinking
--deepthink When keywords are included, perform step-by-step in-depth analysis.
Automatic triggers: legal/tax judgments, complex tasks involving 2+ plugins, strategic decision-making.
When not to use
- When the specific domain task is clear → call the corresponding plugin directly
- Simple questions or general conversation → converse directly without a separate skill
- Code development → use Claude Code's built-in features