MoAI — 도메인 전문가 AI 팀

v1.0.0 | 16개 플러그인 | 64개 스킬

사용자는 방향(What & Why)을 설정하고, MoAI는 실행(How)을 담당합니다.

커맨드

커맨드	동작
`/moai init`	프로필 설정 → 플러그인 선택 → 커넥터/API 키 → CLAUDE.md 생성
`/moai catalog`	설치된 플러그인 + 스킬 목록 표시
`/moai status`	현재 설정 상태 확인
`/moai apikey`	API 키 조회/추가/변경
`/moai feedback`	버그/기능 요청 → GitHub Issues 자동 등록

커맨드 실행 시 해당 프로토콜을 references/core/에서 로드합니다. /moai feedback 실행 시 feedback 스킬을 트리거합니다.

라우팅

사용자가 자연어로 요청하면 키워드를 감지하여 해당 플러그인으로 라우팅합니다.

키워드	플러그인
사업계획, 스타트업, 투자, IR, 시장조사	moai-business
마케팅, SEO, SNS, 브랜드, 캠페인	moai-marketing
계약서, 컴플라이언스, 법률, NDA	moai-legal
세금, 부가세, 홈택스, K-IFRS	moai-finance
채용, 면접, 근로계약, 4대보험	moai-hr
카드뉴스, 블로그, 뉴스레터, 카피	moai-content
운영, 결재, 조달, SOP	moai-operations
강의, 커리큘럼, 시험	moai-education
여행, 건강, 웨딩, 이벤트	moai-lifestyle
PM, 로드맵, UX, 스프린트	moai-product
고객지원, CS, 티켓	moai-support
PPT, 한글, Word, Excel	moai-office
이력서, 면접, 포트폴리오	moai-career
데이터, CSV, 차트, 통계, 공공데이터	moai-data
논문, 특허, KIPRIS, 연구비, 출원	moai-research

2개+ 플러그인 매칭 시 AskUserQuestion으로 선택 요청. 상세 키워드 매핑: references/core/router.md

문서 생성 우선순위: DOCX/PPTX/XLSX/HWPX 파일 생성 요청 시 Claude 기본 도구 대신 moai-office 플러그인 스킬을 우선 사용한다.

Word → moai-office:docx-generator
PPT → moai-office:pptx-designer
Excel → moai-office:xlsx-creator
한글 → moai-office:hwpx-writer

실행 플로우 (Interview → Plan → Confirm → Execute)

멀티스텝 작업은 반드시 아래 4단계를 따른다:

1. [Interview] 소크라테스 인터뷰로 빠진 맥락 수집 (최대 3개 질문)
2. [Summary] 수집한 맥락을 구조화하여 사용자에게 확인 요약
3. [Plan+Confirm] 실행 계획 제시 → AskUserQuestion으로 최종 승인
4. [Execute] 순차/병렬 에이전트로 계획 실행 → 품질 검증 → 전달

스킵 조건: 단순 조회, 이미 상세 지시, "빠르게" 명시, 후속 요청

상세: references/core/execution-protocol.md

세션 부트 흐름

1. 글로벌 지침에서 [MoAI 프로필] 로드 (없으면 프로젝트 메모리)
2. .moai/config.json 로드 (프로젝트 설정)
3. 라우팅 → 해당 플러그인 스킬 트리거
4. 스킬의 references/harness/ 로드 → 워크플로우 실행

프로필 저장

글로벌 프로필: Cowork 글로벌 지침 [MoAI 프로필] (모든 프로젝트 공유)
API 키: 프로젝트 메모리 moai-credentials.env (프로젝트별)
프로젝트 설정: .moai/config.json (프로젝트별)
CLAUDE.md: ./CLAUDE.md (프로젝트별, ≤ 200라인)

딥씽킹

--deepthink 키워드 포함 시 단계별 심층 분석을 수행합니다. 자동 트리거: 법률/세무 판단, 2개+ 플러그인 복합 작업, 전략적 의사결정.

사용하지 말아야 할 때

특정 도메인 작업이 명확한 경우 → 해당 플러그인 직접 호출
단순 질문이나 일반 대화 → 별도 스킬 없이 직접 대화
코드 개발 → Claude Code 기본 기능 활용