設定セクションリファレンス
.moai/config/sections/ の主要設定ファイル(handoff/delegation/llm/statusline/security/workflow/crosssession) キーリファレンス。
MoAI-ADKのプロジェクト設定は .moai/config/sections/ 配下の複数のYAMLファイルに分割されています。settings.jsonガイドがClaude Codeランタイム設定を扱うのに対し、このページはMoAI-ADK自身の動作を制御する主要セクションファイルのキーを整理します。
情報1行要約:settings.jsonはClaude Codeに何を許可するかを定義し、.moai/config/sections/*.yamlはMoAI-ADKがどのようにオーケストレーションするかを定義します。
セッション境界で保存されたハンドオフをどのように処理するかを制御します。
handoff:
mode: manual # manual | auto
guide: false| キー | 値 | 説明 |
|---|---|---|
mode | manual (デフォルト) | 保存されたハンドオフを自動注入しない (opt-inベースラインUX) |
mode | auto | /clear 時に保存されたハンドオフをセッションコンテキストに注入した後、audit-trailコピーに移動 |
guide | false (デフォルト) | true 時、non-/clear セッション開始(startup/resume/compact)で待機中ハンドオフがあるというbest-effort stderrヒントを出力。情報提供のみでセッションをブロックしない |
関連: 自律継続ループ, moai handoff.
/moai サブコマンド別のデフォルトスキル/エージェント割り当てマップです。オーケストレータが実行計画を構築する際(Analyze-First)、このマップを読み、どのエージェントをspawnし、どのスキルを注入するかを決定します。
delegation:
version: 1
learning:
observe: routing-ledger
propose_via: harness-tier-ladder
auto_apply: false # Tier-4ゲート — ユーザー承認が必要
subcommands:
plan:
agents: [manager-spec, plan-auditor, Explore]
skills: [moai-workflow-spec, moai-foundation-thinking]
# run / sync / project / fix / loop / ...
domain_skills:
backend: [moai-ref-api-patterns, moai-domain-backend]
security: [moai-ref-owasp-checklist, moai-ref-llm-security, ...]
agents:
manager-spec: [moai-workflow-spec, moai-foundation-thinking]| ブロック | 説明 |
|---|---|
learning | ルーティング使用をappend-only元帳 (.moai/state/routing-ledger.jsonl, opt-in·fail-open) で管理し、ハーネス学習サブシステムが4-tier提案ラダーで更新提案。auto_apply: false — Tier-4変更は AskUserQuestion ユーザー承認が必要 |
subcommands | サブコマンド別 agents (spawnする13個retainedエージェント) + skills (spawn時注入するworkflowスキル)。0個割り当ても有効 (オーケストレータが直接実行) |
domain_skills | ミッションドメイン別注入スキル (spawn当たり0-3個)。ドメイン信号とマッチング |
agents | エージェント別conditionalスキル (トリガー発生時on-demandロード) |
ハーネスバックエンド、GLM 環境、GLM モデルマッピングを定義します。エージェントが動くモデルと effort はセッションレベルで決まります — サブエージェントはメインセッションのモデルと推論深度をそのまま引き継ぐため、このファイルがエージェント別モデル割り当てを担うことはなくなりました。かつてのプロファイルマトリクス系キー (profile、profiles、performance_tier、harness_agents、agent_overrides) は退いており、moai update が次回実行時にユーザーファイルからこれらのキーを取り除きます。メインセッションの推論強度は設定プロファイル (moai profile setup) から来ます — このファイルからではありません。
llm:
harness: "claude" # claude | gpt | both — 初期化時に選んだエージェントハーネス
team_mode: "" # glm なら z.ai バックエンドへ切替
glm_env_var: "GLM_API_KEY"
glm:
base_url: "https://api.z.ai/api/anthropic"
models:
high: "glm-5.3-flash" # 1M context — Opusスロット
medium: "glm-5.3-flash" # 1M context — Sonnetスロット
low: "glm-5.3-flash" # 1M context — 軽量スロット
fable: "glm-5.3-flash"| キー | 説明 |
|---|---|
harness | 初期化時にデプロイしたエージェントハーネス (claude がデフォルト、gpt は Codex 専用デプロイ) |
team_mode | 空なら Claude、glm ならセッションを z.ai バックエンドへ送ります |
claude_bin | Claude Code バイナリの明示ピン (任意; 環境変数 MOAI_CLAUDE_BIN が起動ごとに優先) |
glm.base_url | Z.AI Anthropic互換プロキシエンドポイント |
glm.models | スロット別GLMモデルマッピング。GLMはClaudeの5段階effortを3個reasoning状態 (thinking-off / reasoning-high / reasoning-max) にcollapse |
関連: プロファイルマトリクス, 3-ティアエージェントアーキテクチャ.
ステータスラインテーマ、github セグメントが数えるホスティングサービス、そして16セグメントトグルを制御します。
statusline:
theme: "catppuccin-mocha" # catppuccin-mocha | catppuccin-latte
# forge: gitlab # github | gitlab | none (未指定なら origin のホストで判定)
segments:
model: true
context: true
# ... 全16セグメント (すべてデフォルトon)
task: true
pr: true| キー | 説明 |
|---|---|
theme | 正確に2つのテーマが存在: catppuccin-mocha (デフォルト) または catppuccin-latte |
forge | github · gitlab · none のいずれか。github セグメントが開いている作業をどのホスティングサービスで数えるかを決めます。未指定なら origin リモートのホストで判定します — github.com なら gh、gitlab.com なら glab。セルフホストのインスタンスは名前に手がかりが無いため、そこでは明示的に指定します。認識できない値は判定へ戻らず何もレンダリングしないので、打ち間違いは誤った件数ではなくセグメントの不在として現れます |
segments | 16セグメント個別トグル (唯一のランタイムレバー)。すべてデフォルトonで、非アクティブ状態はgraceful no-outputで処理 |
セグメントは3行に配置されます — 行1(モデル・バージョン・セッションメタ)、行2(コンテキストウィンドウ・API使用量バー)、行3(ディレクトリ・git・ワークフロー・PR)。
組み込み DefaultSecurityPolicy パターンを拡張 (交換ではなく)する追加セキュリティ設定です。SOLIDの開放-閉鎖原則に従い、core修正なしでconfigで拡張します。
security:
extra_dangerous_bash_patterns:
- 'curl\s+.*\|\s*(ba)?sh'
extra_deny_patterns: []
extra_ask_patterns: []
permission:
strict_mode: true
session_rules: []
sandbox:
required: false
network_allowlist: []
env_scrub_extra: []
docker_image: "alpine:latest"| キー | 説明 |
|---|---|
extra_dangerous_bash_patterns | 組み込みdenyパターンに追加される危険Bashコマンド正規表現 (大文字小文字無視) |
extra_deny_patterns / extra_ask_patterns | 追加ファイルdeny/askパターン |
permission.strict_mode | true 時、bypassPermissionsモードのエージェントspawnを拒否 |
sandbox.required | true 時、sandbox.justification なしの sandbox: none エージェントを拒否 (デフォルトfalse) |
sandbox.network_allowlist | デフォルト8ホストに追加される許可ネットワークホスト |
sandbox.env_scrub_extra | デフォルトscrubリストに追加されるenv変数名 (AWS_*, GITHUB_TOKENなど) |
sandbox.docker_image | dockerバックエンドデフォルトイメージ |
関連: セキュリティノート, settings.jsonガイド.
主チェックアウト(primary checkout)のブランチ状態を守る opt-in ガードです。1 つのチェックアウトを複数のセッションが同時に使うとき、片方が実行した git switch · git checkout · git reset --hard · git stash · git rebase は、もう一方のセッションの作業ツリーを何の合図もなく変えてしまいます。このガードはそれらのコマンドを主チェックアウトでのみ拒否します。
workflow:
branch_guard:
enabled: false # 配布時の既定値| キー | 値 | 説明 |
|---|---|---|
enabled | false(既定) | ガードは完全に不活性です。判定のための git rev-parse すら実行しないため、付随コストがありません |
enabled | true | 主チェックアウトでブランチ状態を変えるコマンドを拒否します。ワークツリー内ではこれまでどおり許可されます |
既定が無効な理由。 このガードが防ぐ危険は、1 つのチェックアウトを複数セッションで共有するときにだけ生じます。1 人で使うリポジトリでは起こらない問題なので、配布版はガードを無効にしたまま出荷されます。複数セッションを同時に動かすリポジトリの管理者が、上のキーを自分で書いて有効にします。
適用範囲。 ガードは主チェックアウトとワークツリーを区別し、ワークツリー内のブランチ操作は妨げません。git status · git log · git diff · git fetch のような読み取りコマンドと、git stash list · git merge-base は有効時でも通過します。
例外と失敗の向き。 ブランチを作る必要のある git 担当エージェントは識別子で例外扱いされ、MOAI_BRANCH_GUARD_EXEMPT=1 環境変数でも回避できます。判定が不確実なとき(リポジトリでない、git rev-parse の失敗など)は拒否せず通し、監査ログだけを残します — 確かな根拠があるときにのみ拒否します。
ブランチを変える必要のある作業は、拒否させるのではなくワークツリーに移すのが定石です。手順は moai worktree を参照してください。
MoAI はセッション開始時に SPEC ライフサイクルのドリフト通知を表示します。この計算には 1 秒ほどかかり、セッション開始が待てる時間をはるかに超えるため、結果は現在のコミットに紐づけてキャッシュされます。コミットが変わるとキャッシュは合わなくなり、通知は表示するものを失います。
このキーが有効なとき、セッション開始ハンドラはキャッシュが合わない場合に短命なバックグラウンドプロセスを 1 つ起動してそこでドリフトを計算させ、待たずにすぐ戻ります。保存された結果は次のセッションが読み取り、通知が再び表示されます。
workflow:
drift_cache_fill:
enabled: true # 配布時の既定| キー | 値 | 説明 |
|---|---|---|
enabled | true (既定) | キャッシュが合わないとき、補充プロセスを 1 つ起動して待たずに戻ります。通知は次のセッションで再び現れます |
enabled | false | 補充プロセスを一切起動しません。通知はキャッシュに既にある内容だけで判断するため、コミット後は他の何かがキャッシュを埋めるまで現れないままになります |
このキーだけが有効で出荷される理由。 このページの他のガードは、管理者が必要とするまで何もしないため無効で出荷されます。このキーは有効なとき実際に子プロセスを起動するので、何もしない既定ではなく、その費用を受け入れた既定です — 補充しなければコミット後にドリフト通知が二度と戻らないからです。子プロセスは短命で、自身の期限で区切られ、ロックにより同時に 1 つだけ動き、何も出力しません。
失敗したときの向き。 どの失敗経路もセッションに影響しません。子プロセスが起動できなくても、終われなくても、何も書けなくても、ハンドラはすでに戻っており通知はそのまま保たれます — 失敗した補充がセッション開始を遅らせたり壊したりすることはありません。
クロスモデル監査バックエンド(codex_audit · glm_audit · audit_multi)が実際にどのモデルと effort で動くかを指定します。バックエンドごとに {model, effort} の 1 組で、配布時の既定値はすべて空です。
workflow:
audit:
codex:
model: "" # 例: gpt-6.1-terra — codex が提供できるモデル id
effort: "" # 例: xhigh — none | low | medium | high | xhigh | max
glm:
model: "" # 例: glm-5.3
effort: "" # 例: max — low | high | max(z.ai の reasoning 状態名)| キー | 説明 |
|---|---|
audit.codex.{model, effort} | codex 監査がセッション開始とレビューターンに載せる 1 組。model が空か、codex が提供できない id ならピンを捨てて、既存の SSOT 解決に戻ります |
audit.glm.{model, effort} | GLM 監査が z.ai リクエストに載せる 1 組。effort は z.ai の reasoning 状態名 low · high · max のみを受け付けます。それ以外の値では reasoning 指示を外し、モデルのピンだけを適用します |
| 両方の組が空 | このキーが存在する前とまったく同じ解決をします。ピンを書いたことのないプロジェクトは何も変わりません |
ピンが適用されるのは監査の入口だけです。タスク委任経路(codex_task · glm_task)のモデル解決には影響せず、同じフィールドはウェブコンソールの Audit パネルでも編集できます。
バックログキュー (todo) の案内表面を切るスイッチです。セッション開始時のキュー要約行、ステータスラインの TODO セグメント、自然言語リクエストの todo ワークフローへの推論ルーティング — この 3 つがこのキー 1 つで静かになります。
workflow:
todo:
enabled: false # 明示的なオフ — キーがなければオンと読まれます| キー | 値 | 説明 |
|---|---|---|
todo.enabled | (キーなし、既定) | オン。配布テンプレートにはこのブロックがそもそもなく、ほとんどのプロジェクトが置かれている状態です |
todo.enabled | false | セッション開始時の要約・ステータスラインの TODO セグメント・スキルの自動ルーティングが切れます |
切ってもコマンドは消えません。 moai todo CLI は登録されたまま全動詞が動作し、名前で直接呼んだ /moai todo もそのまま実行されます。この境界は意図されたものです — スイッチは「頼んでいない人にキューを見せる表面」だけを静かにし、キューを実際に使う人の経路には触れません。設定ファイルを読めない失敗経路でもオンと解釈されます (fail-open)。
小さな一回きりのプロジェクトで、セッションごとに出るバックログ要約がノイズに感じられるときにこのキーを使います。キュー自体の運用方法は moai todo のページにあります。
SPEC の自律実行契約(contract.yaml)をどのように署名し、どこまで縛るかを決めます。契約を扱うコマンドは moai contract です。名前は似ていますが、自律性ティア(MOAI_AUTONOMY_TIER)とは無関係の設定です。
workflow:
autonomy:
mode: guided # guided | contract
contract:
batch_sign: false # 複数の SPEC を一度の確認で署名
second_review: required # required | advisory | off
push_develop: false # 契約で push-develop 作業を許可
kickoff:
# decider: human | llm | llm+jev (省略時: guided は human、contract は llm)
jev_min_confidence: 0.50
escalation:
budget_default: { turns: 60, operations: 40, audit_retries: 2 }| キー | 説明 |
|---|---|
mode | guided(既定)または contract。レシートによる署名(--signer llm)は contract でのみ使えます |
contract.batch_sign | true の場合、複数の SPEC を一度の確認で署名します。既定は false |
contract.second_review | required の場合、契約の review.second_model が none または空だと無効と判定します。advisory・off ではこの検査を行いません |
contract.push_develop | false(既定)の場合、push-develop 作業を含む契約は無効と判定されます |
kickoff.decider | 着手を決める主体。human・llm・llm+jev。省略時はモードから導出されます。jev 単独は設定エラーで、レシート署名は拒否されます |
kickoff.jev_min_confidence | 着手レシートの発行側が Jev の判断を受け入れる最小信頼度として使うために予約された値。このリリースでは値を読み込んで形式を検査するだけで、署名と検証には影響しません。既定は 0.50 |
escalation.budget_default | 契約に budget がない場合に、署名時に補われる既定の予算 |
値が不正な場合。 キーがなければ上記の既定値を使います。mode・second_review・decider・jev_min_confidence に許可されていない値を書くと、より厳しい既定値(guided・required・human・0.50)に戻し、どのキーを置き換えたかを警告で示します。
自分の他の Claude Code セッションから届くメッセージを、このセッションがどう扱うかを決めます。moai cc · moai glm のランチャーが起動時にこれらの値を一時的な --settings ファイルへ移し、ウェブコンソールは設定 seam を通じてこのファイルを編集します。ランチャーを経由せず素の claude で起動したセッションは、このファイルを読みません。
crosssession:
inbound: "" # "" | accept | hold | refuse
isolate_machines: false # デフォルト — マシン外へ出るメッセージに承認を求めない
dialog_expiry: "" # "" | 60s | 5m | 10m | never| キー | 値 | 説明 |
|---|---|---|
inbound | "" (デフォルト) | 2つのセッションの権限モードの種別から、Claude Code がメッセージごとに判断します |
inbound | accept | メッセージをそのまま配送します。人が見ていないワーカーセッションにメッセージを受け取らせるにはこの値が必要です |
inbound | hold | メッセージごとに承認を待たせます。こうして保留したメッセージは期限切れにならず、後で accept が適用されたときに配送されます |
inbound | refuse | メッセージを破棄します |
isolate_machines | false (デフォルト) | このマシンの外のセッションへメッセージが出るとき、承認を求めません。 同じマシン内のセッション同士は値に関わらずマシンを離れませんが、マシンの外のセッションへ向かうメッセージは Anthropic のサーバーを経由します — その経路を無承認で許すという意味なので、デフォルトのままにするかどうかは判断して決めてください |
isolate_machines | true | メッセージがマシンを離れる前に必ず明示的な承認を求めます(bypassPermissions モードでも)。どの設定スコープであれ1つでも true があれば適用されるため、リポジトリにチェックインされたプロジェクトファイルは要求を有効化できても無効化はできません — 無効化するには true を書いたスコープをすべて取り除きます |
dialog_expiry | "" (デフォルト) | Claude Code の5分のデフォルトをそのまま使います |
dialog_expiry | 60s · 5m · 10m · never | デフォルト判断で保留されたメッセージの承認ダイアログの期限です。never はセッションが終わるまで保留します。明示的な inbound: hold で保留したメッセージには適用されません |
- settings.jsonガイド — Claude Codeランタイム設定
- ハーネスプロファイルと評価 — harness.yaml / evaluator-profiles
- moai doctor —
moai doctor configで結合設定検査