SECTION · ADVANCED
上級学習

トークノミクス概論
トークノミクス(Token Economics)はMoAI-ADK v3.0の第一の柱です。トークン単価が下がっても、エージェント的開発はトークンを大量に消費す …
トークン予算管理と安全な中止
トークノミクス4層構造のD層である予算防御(Budget defense)を深掘りします。エージェントがコンテキストウィンドウの限界に達したとき、セッションが停 …
3層エージェントアーキテクチャ (No-Haiku)
MoAI-ADK はルーティングモデルのセットから Haiku を外し、残ったモデルを作業の性格に合わせて 3 段階に分けて使います。このページは、友人にこう説 …
プロファイルマトリクス
MoAI-ADK は、維持されるエージェント 12 個を 1 つの プロファイルマトリクス を通じてそれぞれの {model, effort} ペアにマッピング …
ハーネス自己進化
ハーネス競争力の中核は自己改善の設計にあります。Lilian Wengの「Harness Engineering for …
カンバンモード
NEW · v3.1 カンバンモード (Kanban Mode) 情報 属する価値: エージェンティックループエンジニアリング · マルチセッションオーケストレ …
ハーネス学習表面
NEW · v3.1 ハーネス(エージェントを取り巻く品質検証の自動装置)がセッションを重ねるうちに良くなるのは、モデルの重みではなくハーネスのコードと指針が変 …
ファクトリーモード
NEW · v3.2 ファクトリーモード (Factory Mode) 情報 属する価値: マルチセッションオーケストレーション · トークノミクス ファクトリ …
自律連続ループ
エージェント的ループの核心の問いは「いつ止まり、いつ続くか」です。MoAI-ADKは/moai goalと/moai loopの2つの連続ループプリミティブを提 …
スキルガイド
MoAI-ADKスキルシステム — プログレッシブ・ディスクロージャー(progressive disclosure)で必要な知識だけを必要な瞬間にロードする知識レイヤー。
自律性ティア (MOAI_AUTONOMY_TIER)
MoAI-ADKは、ユーザーがターンごとに承認を受ける半自律モードから、条件が整えば人の介入なしにタスクを最後まで押し進める完全自律モードまで、3つの自律性ティ …
manager-lead リードコーディネーター
NEW · v3.1 manager-lead リードコーディネーター (Lead Coordinator) 情報 所属価値: エージェンティックループエンジニ …
エージェントガイド
MoAI-ADK v3.0の11個のコアエージェントカタログ — 役割、フェーズ範囲、計画-監査の分離原則。
マルチモデル監査収束
NEW · v3.1 情報 所属価値: エージェンティックハーネス · エージェンティックループエンジニアリング マルチモデル監査収束(multi-model …
Codex デュアルハーネス — AGENTS.md・エージェント二重公開・フックアダプター
codex-cli が MoAI-ADK を読めるようにする 4 つの成果物 — ルート AGENTS.md standing contract、エージェント TOML の二重公開、.agents/skills スキルミラー、internal/codexadapter フックアダプターライブラリ。
BAS Navigator 3段階コードマップ同期化
コードは変わり続けるのに文書は足踏みしているプロジェクトは少なくありません。BAS Navigator(コードマップを青写真の錨で結び止めておく同期化レイヤー) …
ビルダーエージェントとハーネス v4
エージェンティック・ハーネスの最後のピースは再帰です — ハーネスがハーネスを作ります。Harness v4 Builder は、自然言語のリクエストひと言でプ …
動的ワークフローと Ultracode
エージェント 100 個を順次委任すると、先にコンテキストが崩壊します。動的ワークフローは計画を Claude のコンテキストではなく スクリプト変数 に置くこ …
Harness v4 Builder 深掘りガイド
Harness v4 Builderの4フェーズワークフロー(ANALYZE/PLAN/GENERATE/ACTIVATE)、Manifestスキーマ、Runnerプリミティブの動作ルール。
Hooks ガイド
Claude Code の Hooks システムと MoAI-ADK の基本 Hook スクリプトを詳しく案内します。エージェンティックハーネスでプロンプトは「 …
意思決定メモリシステム
エージェンティックループエンジニアリングの出発点は観察です — ループが回るたびに観察が積み重なり、積み重なった観察が学習の原料になります。意思決定メモリはその …
Hooks イベントリファレンス
Claude Code のフックシステムは 30 個のイベントタイプ、5 種類のフックタイプ、イベント別マッチャー、スマート動作 をサポートします。フックはエー …
@MX TAGシステム
@MX TAGはコードレベルのアノテーションであり、AIエージェントが開発セッションをまたいで コンテキスト・不変量・危険ゾーン を伝達する標準手段です。プロン …
MX スキャナ内部構造
moai mx スキャナはコードベースを読み取って @MX: タグと結合したインデックスを作成し、複数のタイミングで検証を行います。本ドキュメントは、タグ文法の …
Analyze-Firstルーティング
Analyze-Firstルーティング エージェント (自ら働く AI ツール) オーケストレーターが最初にすることは、「このリクエストをどこへ送るか」を決め …
settings.json ガイド
Claude Code の設定ファイル体系を詳しく案内します。エージェントに実行権限を委任するハーネスで settings.json はその委任の境界線を引くフ …
設定セクションリファレンス
.moai/config/sections/ の主要設定ファイル(handoff/delegation/llm/statusline/security/workflow/crosssession) キーリファレンス。
セキュリティノート
MoAI-ADK セキュリティ強化の変更事項 (v3.0.0 導入、v3.0 系列で現行有効) — CWE-732/214/345 マッピング、ユーザー自己点検手順
ハーネスプロファイルと評価システム
タイポ 1 行を直すのに全面セキュリティ監査を回せばトークンが漏れ、逆に決済システムに手を入れるのに軽い確認しか通さなければ事故が起きます。すべての変更に同じ深 …
Statusline システム — 3+1 行レイアウト完全ガイド
測定できなければ制御できません。エージェンティック開発はひとつのセッションで数十万トークンを使い、コンテキストウィンドウ(context window、モデルが …
CLAUDE.md ガイド
Claude Code の核心指針ファイル体系を詳しく案内します。CLAUDE.md は毎セッション常にロードされるファイルなので、このファイルの 1 行 1 …
カタログシステム
トークノミクスはトークンだけに適用される原則ではありません。プロジェクトに配布されるテンプレートファイル一つひとつも、結局はセッションがロードすることになるコン …
MoAI Web Console
6 つの領域(概要・カンバン・SPEC・モニター・設定・Todo)で構成されたローカル運用コンソール — リアルタイム更新、読み取り専用の観測、設定編集。
ホームディレクトリ衛生 (~/.moai)
NEW · v3.1.1 ホームディレクトリ衛生 (~/.moai) MoAI がプロジェクトの外に置く状態は、すべて ~/.moai の一箇所に集まります。プ …情報所属バリュー: トークノミクス · エージェンティック・ループ・エンジニアリング · エージェンティック・ハーネス

MoAI-ADK の内部構造を掘り下げたい開発者のためのセクションです。基本ワークフロー(plan → run → sync)に慣れたら、ここでハーネスが実際にどのように組み立てられているかを確認できます。
情報このセクションのドキュメントは、v3.0 の3つの核心 — トークノミクス (Token Economics)、エージェンティック・ループ・エンジニアリング (Agentic Loop Engineering)、エージェンティック・ハーネス (Agentic Harness) — のうち、主に3番目の要素の実装詳細を扱います。エージェントに良いコードを書かせる秘訣はモデルではなく、モデルを取り巻く環境設計にあります。
MoAI-ADK ハーネスは 7 つの構成要素が層をなして動作します。上から下へ行くほど、より動的な階層になります。
flowchart TD
CLAUDE["CLAUDE.md
プロジェクト憲法"] --> SETTINGS["settings.json
権限と環境設定"]
CLAUDE --> RULES[".claude/rules/
条件付きルール"]
SETTINGS --> HOOKS["Hooks
イベント自動化"]
SETTINGS --> MCP["MCP サーバー
外部ツール接続"]
RULES --> SKILLS["Skills
専門知識モジュール"]
SKILLS --> AGENTS["Agents
専門家エージェント"]
AGENTS --> BUILDERS["Builder Agents
拡張ジェネレーター"]CLAUDE.md がプロジェクトの憲法だとすれば、settings.json は権限の境界線であり、フックは決定的(deterministic)な制御ポイント、スキルとエージェントは実際に働く手です。そして Builder Agents はこの構造全体を再生成できます — ハーネスがハーネスを作る再帰構造です。
| トピック | 説明 |
|---|---|
| トークノミクス概要 | 単価が 98% 下がってもコストが 320% 上がる逆説とその解法 |
| トークン予算 | Token Circuit Breaker · verify ダイエット · コンテキストダイエット |
| No-Haiku 3 ティア | DeepSWE リーダーボードの根拠と 3 ティアポリシー |
| プロファイルマトリクス | 11 エージェント × {model, effort} 33 セルの単一プロファイル軸 |
| statusline | コンテキスト使用率・キャッシュヒット率・レート_limit の常時ダッシュボード |
| トピック | 説明 |
|---|---|
| 自己進化システム | 4 階層の学習はしご (観察 → ヒューリスティック → ルール → 自動アップデート) |
| 自律ループ | /moai goal · /moai loop 条件宣言型・診断ベースのループ |
| 意思決定メモリ | ユーザーの選択を学習する観測システム |
| ultracode ワークフロー | 動的ワークフローオーケストレーション (多数エージェントのファンアウト) |
| トピック | 説明 |
|---|---|
| スキルガイド | AI に専門知識を付与するスキルシステム |
| エージェントガイド | 専門化された AI 作業実行者の体系 |
| ビルダーエージェントガイド | スキル、エージェント、コマンド、プラグインの生成 |
| Harness v4 Builder | 自然言語ひと言でプロジェクト専用ハーネスを生成 |
| ハーネスプロファイルと評価システム | 3 階層の検証深度 + 4 次元スコアリング |
| カタログシステム | 3 階層マニフェストと slim init |
| トピック | 説明 |
|---|---|
| Hooks ガイド | イベント駆動の自動化スクリプト |
| Hooks リファレンス | MoAI-ADK が配布するフック一覧 |
| settings.json ガイド | Claude Code グローバル設定管理 |
| config セクション | .moai/config/sections/*.yaml の構成項目リファレンス |
| CLAUDE.md ガイド | プロジェクト指針ファイル体系 |
| @MX タグ | エージェント間のコンテキスト・不変契約・危険領域のインライン注釈 |
| セキュリティノート | 権限スタックとサンドボックス |
情報各ドキュメントは独立して読めます。ただし全体アーキテクチャを体系的に理解したい場合は、スキルガイド → エージェントガイド → ビルダーエージェント の順をお勧めします — 知識モジュールから実行者へ、実行者からジェネレーターへとつながる流れが、ハーネスの再帰構造をそのまま示しているからです。