初期設定

MoAI-ADK のインタラクティブな設定ウィザードで最初の設定を完了しましょう。言語、モデルポリシー、レポート形式、品質・ワークフロー設定を開発環境に合わせて構成します。ここで決めた値はすべて .moai/config/sections/ 配下の YAML ファイルに保存されるので、後からいつでもファイルを直接直したりウィザードを再実行したりして変更できます。

新しいプロジェクトを作成しながら初期化するには:

moai init my-project

このコマンドは my-project フォルダを作成し MoAI-ADK を初期化します。

既存プロジェクトに MoAI-ADK をインストールするには、該当フォルダに移動して実行してください:

cd my-existing-project
moai init

情報

moai init は現在のフォルダにそのままインストールします。新規プロジェクトは moai init <プロジェクト名> で作成してください。

初期化ウィザードは常に同じ固定された 3 ページの流れで動作します — 質問範囲を広げたり狭めたりするモードフラグは存在せず、すべてのユーザーに同じ質問セットが表示されます。

moai init my-project

情報

Git 自動化モード・プロバイダーはウィザードでは尋ねません。moai init はリポジトリに既に設定されている Git リモートから自動検出します。後から Git 設定を変更するには moai update -c (--config) を実行してください — このパスでのみ別の Git 質問セット (自動化モード、プロバイダー、認証情報) が表示されます。

Claude が応答する言語を選択します。以降のすべての質問がこの言語で表示されます。

? 会話言語を選択してください:
▸ English
  Korean (한국어)
  Japanese (日本語)
  Chinese (中文)

この設定は .moai/config/sections/language.yaml に保存されます。

設定ファイルに使われるユーザー名です。Enter を押してスキップできます。

? 名前を入力: [名前]

この設定は .moai/config/sections/user.yaml の user.name フィールドに保存されます。

プロジェクトの名前です。デフォルト値は現在のディレクトリ名です。

? プロジェクト名を入力: [my-project]

エージェントに割り当てる AI モデルティアを選択します — トークノミクスの核心設定です。

? パフォーマンスティアを選択:
▸ Medium - Opus 5 (high~low) + Sonnet (low, single-shot rows only)
  High - Opus 5 (max~medium) + Sonnet (low, single-shot rows only)
  Low - Opus 5 (medium~low) + Sonnet (low, docs/e2e/single-shot rows)

この設定は .moai/config/sections/llm.yaml の performance_tier フィールドに保存され、profile フィールド(プロファイルマトリクス列)の legacy エイリアスとして読み込まれます。--profile high|medium|low フラグで直接指定すると profile フィールドに保存されます。プロファイル別のエージェント model+effort マッピングは プロファイルマトリクス ページを参照してください。

レポートを HTML+Markdown で生成するか、Markdown のみで生成するかを選択します。

? レポート形式を選択:
▸ HTML + Markdown (推奨) - ブラウザで閲覧できる HTML レポートと Markdown を両方生成
  Markdown のみ - Markdown レポートのみ生成 (軽量、diff フレンドリー)

この設定は .moai/config/sections/report.yaml の report.format フィールドに保存されます。

run ステップで言語サーバー診断を有効化するか選択します。デフォルト値は 有効 (Yes) で、無効にしたい場合は No と答えて opt-out できます。

この設定は .moai/config/sections/lsp.yaml の lsp.enabled フィールドに保存されます。

TRUST 5 品質ゲートの強制有無を選択します。

• Enforce quality gates (デフォルト値: Yes) — 品質ゲート失敗時に実装の進行を遮断

この設定は .moai/config/sections/quality.yaml の constitution.enforce_quality フィールドに保存されます。

プロジェクトの協業モードを選択します。

? Select project mode:
▸ Personal (Recommended) - Solo developer
  Team - Multi-developer setup

この設定は .moai/config/sections/project.yaml の project.mode フィールドに保存されます。

MoAI デザインパイプラインと Claude Design 連携を有効化するか選択します。

• Enable design workflow (デフォルト値: Yes)
• Enable Claude Design integration (デフォルト値: Yes、design 有効化時のみ表示)

これらの設定は .moai/config/sections/design.yaml の design.enabled / design.claude_design.enabled フィールドに保存されます。

フラグですべての値を指定するとウィザードなしで初期化できます:

moai init my-project \
  --non-interactive \
  --project-mode personal \
  --profile medium \
  --enable-lsp=false \
  --enforce-quality

すべてのステップを完了すると設定ファイルが生成されます:

graph TD
    A[".moai/"] --> B["config/"]
    A --> C["specs/"]
    A --> D["memory/"]
    B --> E["sections/"]
    E --> F["user.yaml"]
    E --> G["language.yaml"]
    E --> H["quality.yaml"]
    E --> I["llm.yaml"]
    E --> J["git-strategy.yaml"]

インストールがスキルミラーを配備するときは、シンボリックリンクを優先します。リンクを作れない環境ではコピーで代用配備され、そのときは moai init の完了要約に代用の事実が併記されます — 知っておくべきは、コピーはリンクと違って元が変わっても自分では追従しない、その一点です。

# ユーザー設定
vim .moai/config/sections/user.yaml

# 言語設定
vim .moai/config/sections/language.yaml

# モデルポリシー (パフォーマンスティア)
vim .moai/config/sections/llm.yaml

# 品質設定
vim .moai/config/sections/quality.yaml

設定ウィザードを再実行して構成を変更できます:

# 設定ウィザードの再実行 (推奨)
moai update -c

情報

moai update -c コマンドは既存の設定を維持しながら変更したい項目だけを選択的に再設定できます。

設定が正しく構成されているか確認しましょう:

moai doctor

このコマンドは Git のインストール有無、プロジェクト構造 (.moai/ フォルダ)、設定ファイル、言語別の開発ツールを検証します。--verbose で詳細を確認できます。

設定が完了したら クイックスタート ガイドに従って最初のプロジェクトを作成してみましょう。

moai --help