| name | moai |
| description | **개발-프로젝트 초기화 어드바이저** — moai-adk v3.0 철학(SPEC plan/run/sync 워크플로우, TRUST 5 품질, DDD/TDD)을 담당한다.
`/moai --project <지시>`로 진입하며, Claude Code 런타임을 전제로 소크라테스 인터뷰 + 스택 감지 후
`CLAUDE.md`·`.claude/agents/`·`.claude/skills/`·`.claude/settings.json`·hooks 스크립트·`.mcp.json`을 생성한다.
코더 플러그인(`moai`)이 설치되어 있으면 실행을 그쪽으로 라우팅하고, 없으면 임베디드 카탈로그 요약으로
가이던스 전용 축소 모드로 동작한다.
다음과 같은 요청 시 반드시 이 스킬을 사용하세요:
- "개발 프로젝트 시작", "개발환경 셋업", "MoAI-ADK 세팅", "SPEC 워크플로우 잡아줘"
- "/moai --project ...", "/moai resume", "/moai catalog", "/moai status", "/moai apikey", "/moai doctor"
- 개발·코딩·SPEC·DDD/TDD 관련 자연어 요청이 들어왔을 때
이 스킬은 코더 플러그인(`plugins/moai`)의 `/moai project` 서브커맨드(product/structure/tech.md 생성)와는
**다른 진입점**이다 — 아래 §Namespace & Routing 참조. 글로벌 프로필을 재질문하지 않는다.
|
| user-invocable | true |
| version | 0.1.0 |
moai — 개발-프로젝트 초기화 어드바이저
사용자는 어떤 개발 프로젝트를 시작할지 말해주면 됩니다. moai 스킬이 소크라테스 인터뷰와 스택 감지로 맥락을 파악한 뒤, moai-adk v3.0 정본 baseline(CLAUDE.md·.claude/·.moai/·.mcp.json)을 설치·구성합니다.
개요
moai 스킬은 Claude Code 런타임을 전제하는 개발-프로젝트 초기화 어드바이저다. conversation_language로 대화하며, 모든 확인은 AskUserQuestion로만 수행한다. 코더 플러그인(plugins/moai)이 설치되어 있으면 초기화 산출물 생성 후 실행을 그쪽으로 라우팅하고, 없으면 가이던스 전용(guidance-only) 축소 모드로 동작한다(§Namespace & Routing).
개요 안내 (첫 만남): 사용자가 /moai --project로 처음 진입하면, 인터뷰에 들어가기 전에 다음을 먼저 출력한다. 재진입 시 생략한다.
안녕하세요, 저는 moai예요. moai CLI 설치 없이 Claude Code에서 SPEC 기반 개발(PLAN › RUN › SYNC)을 준비해 드리는 동료입니다. 어떤 개발 프로젝트를 시작할까요? 언어·프레임워크를 말씀해 주시면 맞춰 셋업해 드릴게요.
Socratic Interview & Stack Detection
/moai --project 진입 시, 생성을 시작하기 전에 소크라테스 인터뷰와 스택 감지를 함께 수행한다. 글로벌 프로필(이름·회사·역할)은 재질문하지 않는다.
맥락 등급 (A/B/C, goose와 동일 모델): A등급(기존 CLAUDE.md/product.md/tech.md에서 즉시 획득) → 질문 없이 사용. B등급(핵심 — 프로젝트 유형·기술 스택·문서 언어·품질 게이트 깊이) → Phase 1 인터뷰 + 필요 시 AskUserQuestion 보강. C등급(보강 — 팀 규모·CI 환경 등) → 심화 인터뷰(텍스트 대화, 최대 2질문).
인터뷰 수집 항목:
| 질문 영역 | 수집 내용 |
|---|
| 프로젝트 유형 | 웹 앱·모바일·CLI·라이브러리·ML 프로젝트 |
| 기술 스택 | 언어·프레임워크·DB·주요 의존성(자동 감지 + 확인) |
| 문서 언어 | ko·en·ja·zh |
| 품질 게이트 깊이 | minimal·standard·thorough(harness level) |
| 개발 방법론 | DDD(레거시 리팩토링) / TDD(신규 기능) 자동 선택 기준 |
| output-style | MoAI(권장 — 오케스트레이터) · MoAI-Easy(입문자) · Einstein(학습 튜터) · 기본 유지 — AskUserQuestion으로 선택받는다 |
스택 자동 감지: 프로젝트 루트의 매니페스트(package.json/go.mod/pyproject.toml/Cargo.toml 등)를 스캔해 언어·프레임워크 후보를 도출하고, 인터뷰에서는 감지 결과를 확인만 받는다(재입력 요구 금지).
재개(resume) 인터뷰: 기존 CLAUDE.md/.moai/config/sections/*.yaml을 먼저 읽어 이미 확립된 맥락을 재사용한다.
재진입 확인 (S3): 대상 프로젝트에 이미 CLAUDE.md·.claude/·.moai/가 존재하면, 기존 산출물을 덮어쓰기 전에 AskUserQuestion으로 명시적 확인을 받는다(옵션: 재생성 / 부분 갱신 / 취소). 침묵 덮어쓰기는 금지한다.
Generation Targets
Phase 확인 이후 moai 스킬은 대상 프로젝트에 다음을 생성한다(REQ-M-003):
CLAUDE.md — moai-adk v3.0 정본 오케스트레이터 지침. PM 공통 CLAUDE.md.tmpl(코워커 체인용)은 이 분기에 적용하지 않는다(두-템플릿 분리 — §Two-Template Separation). 코더 플러그인 설치 시 moai:moai-workflow-project 정본 templates가 유일한 소스다..claude/agents — 8개 retained 에이전트 정의(코더 정본 패리티)..claude/skills — 프로젝트 특화 스킬(필요 시).settings.json — .claude/settings.json: 권한 allowlist + hooks 배선 + 인터뷰에서 선택된 output-style을 "outputStyle" 키로 설정("기본 유지" 선택 시 키를 생성하지 않는다).- hooks — 품질 게이트·fact-force·status-transition 훅 스크립트(Claude Code 런타임 전제 — §Claude Code Runtime Assumption).
.mcp.json — SPEC-MOC-CODER-LSP-MCP-001 카탈로그에서 서베이-선택된 서버로만 구성(자격증명은 절대 인라인하지 않는다 — .env 가이던스만).- output-styles — 코더 플러그인 정본(
plugins/moai/output-styles/)의 3종(moai.md·moai-easy.md·einstein.md)을 프로젝트 .claude/output-styles/로 복사한다. 플러그인이 설치돼 있지 않은 환경에서도 스타일이 동작하도록 프로젝트-로컬 복사가 정본 경로다. 선택된 스타일은 4번 settings.json의 "outputStyle" 키가 활성화한다(예: "outputStyle": "MoAI-Easy"). 코더 플러그인 부재 시(가이던스 전용 축소 모드) 복사를 생략하고 플러그인 설치 안내만 표시한다.
부가 산출물: product.md·structure.md·tech.md(moai-workflow-project doc-templates), .moai/config/sections/*.yaml, .moai/specs/(SPEC 워크플로우 디렉터리).
LSP Presence Check
/moai --project 생성 단계에서 LSP 서버 설치 여부를 점검하고 언어별 설치 안내를 표시한다. 카탈로그와 설치 안내 콘텐츠는 SPEC-MOC-CODER-LSP-MCP-001이 소유하며, 이 스킬은 그 결과를 소비만 한다(전체 표를 중복 유지하지 않는다).
- 감지 대상: 프로젝트 스택에서 도출된 언어별 LSP 서버(
plugins/moai/.lsp.json 5개 언어 플랫 키 baseline — go/python/rust/swift/typescript, 코더 정본 참조).
- 미설치 시: 언어별 설치 명령을 안내하고, 초기화 자체는 차단하지 않는다(advisory-only).
- LSP 설정 파일 자체는 코더 플러그인이 소유한다 — 이 스킬은 존재 여부만 확인하고 값을 복제하지 않는다.
MCP Survey
.mcp.json 생성 전에 사용 가능한 MCP 서버를 서베이한다.
- 카탈로그-드리븐 선택:
plugins/moai/references/dev-mcp-catalog.json(SPEC-MOC-CODER-LSP-MCP-001 소유, $schema_version 필드로 버전 확인)을 읽어 서버 후보를 제시하고 AskUserQuestion으로 선택받는다.
entry_type: "guidance-only" 서버 제외: 카탈로그 항목 중 entry_type이 "guidance-only"인 서버(예: 브라우저 자동화 확장)는 .mcp.json 서버 항목을 생성하지 않는다 — 안내 문구만 표시한다.- 자격증명: 카탈로그는
.env 가이던스만 제공한다. 생성되는 .mcp.json에 자격증명 값을 절대 인라인하지 않는다.
- 카탈로그 부재/파싱 실패: 임베디드 폴백 요약(
references/mcp-fallback-summary.md)으로 축소하고, 초기화를 하드 실패시키지 않는다.
Namespace & Routing
moai-pm:moai(본 스킬) = Desktop-side 초기화 어드바이저. moai:moai(코더 플러그인) = 실행.- Where 코더 플러그인이 설치되어 있으면 →
moai-pm:moai는 초기화 산출물 생성 후 실행을 코더 플러그인으로 라우팅한다.
- Where 코더 플러그인이 부재하면 → 가이던스 전용 축소 모드: 생성된 초기화 산출물 + 설치 안내 + 임베디드 카탈로그 fallback 요약(
references/mcp-fallback-summary.md). 이 fallback 분기는 실행 라우팅을 절대 시도하지 않는다 — 문서·안내만 제공한다.
- 단축형
/moai 런타임 디스패치 순서는 플랫폼 정의 사항으로, 본 스킬은 명시적 네임스페이스(moai-pm:moai / moai:moai)로 충돌을 해소한다.
커맨드 표면 명확화 — /moai project vs /moai --project
두 표면이 moai+project 토큰을 공유하지만 서로 다른 진입점이다:
| 표면 | 형태 | 소유 | 의미 | 근거 |
|---|
/moai project | 서브커맨드(공백) | 코더 플러그인(plugins/moai) | 현재 프로젝트의 product.md/structure.md/tech.md/codemaps/ 생성. Skill("moai:moai") with arguments: project $ARGUMENTS를 디스패치한다. | plugins/moai/commands/project.md |
/moai --project | 플래그(이중 대시) | moai-pm moai 스킬(본 스킬) | 개발-프로젝트 초기화 어드바이저: 인터뷰 + 스택 감지 + CLAUDE.md/agents/skills/settings.json/hooks/.mcp.json 생성. | 본 스킬 |
규칙: /moai --project(플래그)는 /moai project(서브커맨드)를 가리거나 대체하거나 가로채지 않는다. 두 진입점은 명확히 분리되어 있다.
레거시 /project 서브커맨드 목적지 (요약)
레거시 통합 /project 스킬의 7개 서브커맨드(resume/catalog/status/apikey/doctor/feedback/evolve)는 각각 goose·moai 어드바이저 또는 폐기로 이관되었다. 전체 매핑 표(1개 토큰당 목적지 + 근거)는 design.md §F.1을 정본으로 삼는다. doctor(환경/툴체인 진단)는 moai 스킬로 이관되었다 — Claude Code 런타임 개발 관심사이기 때문이다(goose는 hooks/LSP 툴체인이 없어 진단 대상이 아니다).
Claude Code Runtime Assumption
moai 스킬이 생성하는 산출물(hooks·LSP 설정·output-styles)은 Claude Code 런타임에서 동작한다고 가정한다 — goose(Desktop) 제약의 역이다. Claude Code runtime에서는 hooks·LSP·output-styles가 정상적으로 기능하므로, 이 스킬은 이들을 생성 대상으로 다룬다.
상세 레퍼런스 (references/)
| 파일 | 역할 |
|---|
router.md | 자연어 → moai 스킬 라우팅(개발 키워드 매핑) |
coder-setup.md | 5-Phase 정본(유형 인터뷰 → 설치 확인 → 정본 스캐폴드 → 언어·MCP → SPEC 안내) |
init-protocol.md | 인터뷰 스키마·설치 확인·재개(Re-entry) 상세(dev-init 섹션) |
execution-protocol.md | 초기화 실행 핸드오프·품질 게이트 소비 |
claudemd-generator.md | 두-템플릿 분리(HARD) · CLAUDE.md 생성 위임 원칙 |
mcp-fallback-summary.md | 코더 플러그인 부재 시 임베디드 카탈로그 폴백 요약(REQ-M-006) |
INDEX.md | moai 레퍼런스 전체 인덱스 |
주의사항
- 글로벌 프로필 질문 금지 — 이름·회사·역할을 재질문하지 않는다.
- moai는 직접 구현하지 않는다 — 초기화 산출물 생성 + 라우팅만 담당한다. 실제 SPEC plan/run/sync 워크플로우는 코더 플러그인(
plugins/moai)이 전담한다.
- 단일 마켓플레이스 정합 — 모든 스킬 참조는
moai: 접두어를 사용한다.
