Skip to main content

設定セクションリファレンス

.moai/config/sections/ の主要設定ファイル(handoff/delegation/llm/statusline/security/workflow/crosssession) キーリファレンス。

更新 2026-10-27 14分で読めます GitHub で編集 ↗

MoAI-ADKのプロジェクト設定は .moai/config/sections/ 配下の複数のYAMLファイルに分割されています。settings.jsonガイドがClaude Codeランタイム設定を扱うのに対し、このページはMoAI-ADK自身の動作を制御する主要セクションファイルのキーを整理します。

情報
1行要約: settings.json はClaude Codeに何を許可するかを定義し、.moai/config/sections/*.yaml はMoAI-ADKがどのようにオーケストレーションするかを定義します。

handoff.yaml — 自動レジュームハンドオフ

セッション境界で保存されたハンドオフをどのように処理するかを制御します。

yaml
handoff:
    mode: manual   # manual | auto
    guide: false
キー値説明
modemanual (デフォルト)保存されたハンドオフを自動注入しない (opt-inベースラインUX)
modeauto/clear 時に保存されたハンドオフをセッションコンテキストに注入した後、audit-trailコピーに移動
guidefalse (デフォルト)true 時、non-/clear セッション開始(startup/resume/compact)で待機中ハンドオフがあるというbest-effort stderrヒントを出力。情報提供のみでセッションをブロックしない

関連: 自律継続ループ, moai handoff.

delegation.yaml — エージェントルーティングSSOT

/moai サブコマンド別のデフォルトスキル/エージェント割り当てマップです。オーケストレータが実行計画を構築する際(Analyze-First)、このマップを読み、どのエージェントをspawnし、どのスキルを注入するかを決定します。

yaml
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ロード)

関連: エージェントガイド, スキルガイド.

llm.yaml — バックエンド·GLM マッピング

ハーネスバックエンド、GLM 環境、GLM モデルマッピングを定義します。エージェントが動くモデルと effort はセッションレベルで決まります — サブエージェントはメインセッションのモデルと推論深度をそのまま引き継ぐため、このファイルがエージェント別モデル割り当てを担うことはなくなりました。かつてのプロファイルマトリクス系キー (profile、profiles、performance_tier、harness_agents、agent_overrides) は退いており、moai update が次回実行時にユーザーファイルからこれらのキーを取り除きます。メインセッションの推論強度は設定プロファイル (moai profile setup) から来ます — このファイルからではありません。

yaml
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_binClaude Code バイナリの明示ピン (任意; 環境変数 MOAI_CLAUDE_BIN が起動ごとに優先)
glm.base_urlZ.AI Anthropic互換プロキシエンドポイント
glm.modelsスロット別GLMモデルマッピング。GLMはClaudeの5段階effortを3個reasoning状態 (thinking-off / reasoning-high / reasoning-max) にcollapse

関連: プロファイルマトリクス, 3-ティアエージェントアーキテクチャ.

statusline.yaml — ステータスライン

ステータスラインテーマ、github セグメントが数えるホスティングサービス、そして16セグメントトグルを制御します。

yaml
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
forgegithub · gitlab · none のいずれか。github セグメントが開いている作業をどのホスティングサービスで数えるかを決めます。未指定なら origin リモートのホストで判定します — github.com なら gh、gitlab.com なら glab。セルフホストのインスタンスは名前に手がかりが無いため、そこでは明示的に指定します。認識できない値は判定へ戻らず何もレンダリングしないので、打ち間違いは誤った件数ではなくセグメントの不在として現れます
segments16セグメント個別トグル (唯一のランタイムレバー)。すべてデフォルトonで、非アクティブ状態はgraceful no-outputで処理

セグメントは3行に配置されます — 行1(モデル・バージョン・セッションメタ)、行2(コンテキストウィンドウ・API使用量バー)、行3(ディレクトリ・git・ワークフロー・PR)。

関連: Statuslineシステム & PRセグメント.

security.yaml — セキュリティ強化

組み込み DefaultSecurityPolicy パターンを拡張 (交換ではなく)する追加セキュリティ設定です。SOLIDの開放-閉鎖原則に従い、core修正なしでconfigで拡張します。

yaml
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_modetrue 時、bypassPermissionsモードのエージェントspawnを拒否
sandbox.requiredtrue 時、sandbox.justification なしの sandbox: none エージェントを拒否 (デフォルトfalse)
sandbox.network_allowlistデフォルト8ホストに追加される許可ネットワークホスト
sandbox.env_scrub_extraデフォルトscrubリストに追加されるenv変数名 (AWS_*, GITHUB_TOKENなど)
sandbox.docker_imagedockerバックエンドデフォルトイメージ

関連: セキュリティノート, settings.jsonガイド.

workflow.yaml — branch_guard

主チェックアウト(primary checkout)のブランチ状態を守る opt-in ガードです。1 つのチェックアウトを複数のセッションが同時に使うとき、片方が実行した git switch · git checkout · git reset --hard · git stash · git rebase は、もう一方のセッションの作業ツリーを何の合図もなく変えてしまいます。このガードはそれらのコマンドを主チェックアウトでのみ拒否します。

yaml
workflow:
    branch_guard:
        enabled: false   # 配布時の既定値
キー値説明
enabledfalse(既定)ガードは完全に不活性です。判定のための git rev-parse すら実行しないため、付随コストがありません
enabledtrue主チェックアウトでブランチ状態を変えるコマンドを拒否します。ワークツリー内ではこれまでどおり許可されます

既定が無効な理由。 このガードが防ぐ危険は、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 を参照してください。

workflow.yaml — drift_cache_fill

MoAI はセッション開始時に SPEC ライフサイクルのドリフト通知を表示します。この計算には 1 秒ほどかかり、セッション開始が待てる時間をはるかに超えるため、結果は現在のコミットに紐づけてキャッシュされます。コミットが変わるとキャッシュは合わなくなり、通知は表示するものを失います。

このキーが有効なとき、セッション開始ハンドラはキャッシュが合わない場合に短命なバックグラウンドプロセスを 1 つ起動してそこでドリフトを計算させ、待たずにすぐ戻ります。保存された結果は次のセッションが読み取り、通知が再び表示されます。

yaml
workflow:
    drift_cache_fill:
        enabled: true   # 配布時の既定
キー値説明
enabledtrue (既定)キャッシュが合わないとき、補充プロセスを 1 つ起動して待たずに戻ります。通知は次のセッションで再び現れます
enabledfalse補充プロセスを一切起動しません。通知はキャッシュに既にある内容だけで判断するため、コミット後は他の何かがキャッシュを埋めるまで現れないままになります

このキーだけが有効で出荷される理由。 このページの他のガードは、管理者が必要とするまで何もしないため無効で出荷されます。このキーは有効なとき実際に子プロセスを起動するので、何もしない既定ではなく、その費用を受け入れた既定です — 補充しなければコミット後にドリフト通知が二度と戻らないからです。子プロセスは短命で、自身の期限で区切られ、ロックにより同時に 1 つだけ動き、何も出力しません。

失敗したときの向き。 どの失敗経路もセッションに影響しません。子プロセスが起動できなくても、終われなくても、何も書けなくても、ハンドラはすでに戻っており通知はそのまま保たれます — 失敗した補充がセッション開始を遅らせたり壊したりすることはありません。

workflow.yaml — audit

クロスモデル監査バックエンド(codex_audit · glm_audit · audit_multi)が実際にどのモデルと effort で動くかを指定します。バックエンドごとに {model, effort} の 1 組で、配布時の既定値はすべて空です。

yaml
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 パネルでも編集できます。

workflow.yaml — todo

バックログキュー (todo) の案内表面を切るスイッチです。セッション開始時のキュー要約行、ステータスラインの TODO セグメント、自然言語リクエストの todo ワークフローへの推論ルーティング — この 3 つがこのキー 1 つで静かになります。

yaml
workflow:
    todo:
        enabled: false   # 明示的なオフ — キーがなければオンと読まれます
キー値説明
todo.enabled(キーなし、既定)オン。配布テンプレートにはこのブロックがそもそもなく、ほとんどのプロジェクトが置かれている状態です
todo.enabledfalseセッション開始時の要約・ステータスラインの TODO セグメント・スキルの自動ルーティングが切れます

切ってもコマンドは消えません。 moai todo CLI は登録されたまま全動詞が動作し、名前で直接呼んだ /moai todo もそのまま実行されます。この境界は意図されたものです — スイッチは「頼んでいない人にキューを見せる表面」だけを静かにし、キューを実際に使う人の経路には触れません。設定ファイルを読めない失敗経路でもオンと解釈されます (fail-open)。

小さな一回きりのプロジェクトで、セッションごとに出るバックログ要約がノイズに感じられるときにこのキーを使います。キュー自体の運用方法は moai todo のページにあります。

workflow.yaml — autonomy

SPEC の自律実行契約(contract.yaml)をどのように署名し、どこまで縛るかを決めます。契約を扱うコマンドは moai contract です。名前は似ていますが、自律性ティア(MOAI_AUTONOMY_TIER)とは無関係の設定です。

yaml
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 }
キー説明
modeguided(既定)または contract。レシートによる署名(--signer llm)は contract でのみ使えます
contract.batch_signtrue の場合、複数の SPEC を一度の確認で署名します。既定は false
contract.second_reviewrequired の場合、契約の review.second_model が none または空だと無効と判定します。advisory・off ではこの検査を行いません
contract.push_developfalse(既定)の場合、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)に戻し、どのキーを置き換えたかを警告で示します。

crosssession.yaml — セッション間メッセージ

自分の他の Claude Code セッションから届くメッセージを、このセッションがどう扱うかを決めます。moai cc · moai glm のランチャーが起動時にこれらの値を一時的な --settings ファイルへ移し、ウェブコンソールは設定 seam を通じてこのファイルを編集します。ランチャーを経由せず素の claude で起動したセッションは、このファイルを読みません。

yaml
crosssession:
  inbound: ""             # "" | accept | hold | refuse
  isolate_machines: false # デフォルト — マシン外へ出るメッセージに承認を求めない
  dialog_expiry: ""       # "" | 60s | 5m | 10m | never
キー値説明
inbound"" (デフォルト)2つのセッションの権限モードの種別から、Claude Code がメッセージごとに判断します
inboundacceptメッセージをそのまま配送します。人が見ていないワーカーセッションにメッセージを受け取らせるにはこの値が必要です
inboundholdメッセージごとに承認を待たせます。こうして保留したメッセージは期限切れにならず、後で accept が適用されたときに配送されます
inboundrefuseメッセージを破棄します
isolate_machinesfalse (デフォルト)このマシンの外のセッションへメッセージが出るとき、承認を求めません。 同じマシン内のセッション同士は値に関わらずマシンを離れませんが、マシンの外のセッションへ向かうメッセージは Anthropic のサーバーを経由します — その経路を無承認で許すという意味なので、デフォルトのままにするかどうかは判断して決めてください
isolate_machinestrueメッセージがマシンを離れる前に必ず明示的な承認を求めます(bypassPermissions モードでも)。どの設定スコープであれ1つでも true があれば適用されるため、リポジトリにチェックインされたプロジェクトファイルは要求を有効化できても無効化はできません — 無効化するには true を書いたスコープをすべて取り除きます
dialog_expiry"" (デフォルト)Claude Code の5分のデフォルトをそのまま使います
dialog_expiry60s · 5m · 10m · neverデフォルト判断で保留されたメッセージの承認ダイアログの期限です。never はセッションが終わるまで保留します。明示的な inbound: hold で保留したメッセージには適用されません

関連ドキュメント