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
카탈로그 전체 배치 (core + 선택 팩 + 하네스 생성물). 기본값은 core-only slim 모드
--force
기존 프로젝트 재초기화 (현재 .moai/ 를 백업)
--no-hooks
git 훅 설치 생략
프로젝트 기본값
플래그
설명
--root <dir>
프로젝트 루트 (기본: 현재 디렉터리)
--name <name>
프로젝트 이름 (기본: 디렉터리명)
--language <lang>
주 프로그래밍 언어
--framework <name>
프레임워크 (기본: 자동 감지 또는 none)
--mode <ddd|tdd>
개발 방법론 (기본: tdd)
--non-interactive
대화형 마법사 생략 — 플래그와 기본값만 사용
마법사 질문 플래그
플래그
설명
--project-mode <personal|team>
프로젝트 모드 (기본: personal)
--enable-lsp
LSP 통합 활성화 (기본: true)
--enforce-quality
품질 게이트 강제 (기본: true)
--enable-design
디자인 워크플로우 활성화 (기본: true)
Git / 모델 정책
플래그
설명
--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
