Skip to main content

moai init 初期化

更新 2026-08-08 2分で読めます GitHub で編集 ↗

moai init は現在のディレクトリまたは新規フォルダに MoAI プロジェクトを初期化します。Claude Code 連携に必要な .claude/.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-hooksgit フックのインストールを省略

プロジェクトデフォルト

フラグ説明
--root <dir>プロジェクトルート (デフォルト: 現在のディレクトリ)
--name <name>プロジェクト名 (デフォルト: ディレクトリ名)
--language <lang>主なプログラミング言語
--framework <name>フレームワーク (デフォルト: 自動検出または none)
--mode <ddd|tdd>開発方法論 (デフォルト: tdd)
--non-interactive対話式ウィザードを省略 — フラグとデフォルトのみ使用

ウィザード質問フラグ

フラグ説明
--project-mode <personal|team>プロジェクトモード (デフォルト: personal)
--enable-lspLSP 統合を有効化 (デフォルト: 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.yamlprofile に保存 (プロファイルマトリクス列の選択)。legacy 値 max も入力として受け付け high に正規化
--model-policy <high|medium|low>legacy パフォーマンスティア — llm.yamlperformance_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初期化後の環境検証

関連ドキュメント