moai init 초기화
moai init 은 현재 디렉터리 또는 새 폴더에 MoAI 프로젝트를 초기화합니다. Claude Code 연동에 필요한 .claude/, .moai/ 구조와 설정을 배치하고, 필요 시 대화형 마법사로 프로젝트 모드·언어·품질 게이트를 설정합니다.
빈 폴더에서 시작하면 관리자 에이전트와 하네스(harness) 가 동작할 규칙·스킬·훅이 모두 없기 때문에, 이 커맨드는 템플릿 카탈로그를 한 번에 깔아 두는 역할을 합니다. SPEC 워크플로우와 품질 게이트가 모두 이 초기 구조를 전제로 동작하므로, 처음 한 번 정확히 세팅해 두면 이후 moai update 로 일관되게 유지됩니다. 따라서 새 프로젝트의 첫 단추이자 다른 모든 moai 커맨드가 의존하는 기반 셋업 커맨드입니다.
bash
moai init [project-name]| 패턴 | 동작 |
|---|---|
moai init <name> | ./<name>/ 폴더를 만들고 그 안에 초기화 |
moai init . | 현재 디렉터리에 초기화 |
moai init | 현재 디렉터리에 초기화 (moai init . 과 동일) |
인자는 최대 1개까지 받습니다.
| 플래그 | 설명 |
|---|---|
--all | 전체 로컬 배포: 카탈로그 모든 등급을 로컬에 배치 (--no-plugin 페이로드 + 선택 팩). 플래그 없이는 core-only slim 모드가 기본값 |
--no-plugin | moai 플러그인을 건너뛰고 전체 로컬 페이로드를 배치 (스킬, 명령, .mcp.json 의 moai 항목, Codex 미러). MOAI_SKIP_PLUGIN_INSTALL=1 도 같은 효과. 기본 경로(플러그인 모드)에서는 로컬 스킬·명령을 배치하지 않는다 — moai 플러그인이 운반한다 |
--force | 기존 프로젝트 재초기화 (현재 .moai/ 를 백업) |
--no-hooks | git 훅 설치 생략 |
--llm <claude|codex|both> | 연결할 LLM 하네스 선택 (기본값: claude) |
확정된 배포 모드는 .moai/config/sections/llm.yaml 의 deployment_mode (plugin 또는 local) 에 기록되고, moai update 는 그 기록을 따라 같은 범위를 유지한다. 플러그인 설치가 확인되지 않은 프로젝트는 안전한 쪽인 local 로 기록된다.
| 플래그 | 설명 |
|---|---|
--root <dir> | 프로젝트 루트 (기본: 현재 디렉터리) |
--name <name> | 프로젝트 이름 (기본: 디렉터리명) |
--language <lang> | 주 프로그래밍 언어 |
--framework <name> | 프레임워크 (기본: 자동 감지 또는 none) |
--mode <ddd|tdd> | 개발 방법론 (기본: tdd) |
--non-interactive | 대화형 마법사 생략 — 플래그와 기본값만 사용 |
| 플래그 | 설명 |
|---|---|
--enable-lsp | LSP 통합 활성화 (기본: true) |
--enforce-quality | 품질 게이트 강제 (기본: true) |
--enable-design | 디자인 워크플로우 활성화 (기본: true) |
| 플래그 | 설명 |
|---|---|
--git-mode <manual|personal|team> | Git 워크플로우 모드 (기본: manual) |
--git-provider <github|gitlab> | Git 제공자 |
--github-username <name> | GitHub 사용자명 (personal/team 모드 필수) |
--profile <high|medium|low> | 모델+effort 프로필 — llm.yaml 의 profile 에 저장 (프로필 매트릭스 열 선택). legacy 값 max 도 입력으로 받아 high 로 정규화 |
--model-policy <high|medium|low> | legacy 성능 티어 — llm.yaml 의 performance_tier 에 저장 (profile 부재 시 별칭으로 읽힘) |
bash
# 새 폴더에 초기화
moai init my-app
# 현재 디렉터리에 초기화
moai init .
# 방법론 지정
moai init --mode tdd
# 카탈로그 전체 배치 (slim 모드 우회)
moai init --all
# 비대화형 (CI 등)
moai init . --non-interactive --language go| 명령어 | 설명 |
|---|---|
moai update | 초기화된 프로젝트의 템플릿 동기화 |
moai status | 초기화 상태 확인 |
moai doctor | 초기화 후 환경 검증 |