SECTION · ADVANCED
上級学習

トークノミクス概論
トークノミクス(Token Economics)はMoAI-ADK v3.0の第一の柱です。トークン単価が下がっても、エージェント的開発はトークンを大量に消費す …
トークン予算管理と安全な中止
トークノミクス4層構造のD層である予算防御(Budget defense)を深掘りします。エージェントがコンテキストウィンドウの限界に達したとき、セッションが停 …
3層エージェントアーキテクチャ (No-Haiku)
MoAI-ADK v3.0はHaikuをルーティングモデルセットから除外し、作業の性格に合わせた3層構造で作業を分散します。この設計はDeepSWEリーダーボー …
プロファイルマトリクス
MoAI-ADK は、維持されるエージェント 11 個を 1 つの プロファイルマトリクス を通じてそれぞれの {model, effort} ペアにマッピング …
ハーネス自己進化
ハーネス競争力の中核は自己改善の設計にあります。Lilian Wengの「Harness Engineering for …
カンバンモード
NEW · v3.1 カンバンモード (Kanban Mode) 情報 属する価値: エージェンティックループエンジニアリング · マルチセッションオーケストレ …
ハーネス学習表面
NEW · v3.1 ハーネス(エージェントを取り巻く品質検証の自動装置)がセッションを重ねるうちに良くなるのは、モデルの重みではなくハーネスのコードと指針が変 …
自律連続ループ
エージェント的ループの核心の問いは「いつ止まり、いつ続くか」です。MoAI-ADKは/moai goalと/moai loopの2つの連続ループプリミティブを提 …
スキルガイド
MoAI-ADKスキルシステム — プログレッシブ・ディスクロージャー(progressive disclosure)で必要な知識だけを必要な瞬間にロードする知識レイヤー。
自律性ティア (MOAI_AUTONOMY_TIER)
MoAI-ADKは、ユーザーがターンごとに承認を受ける半自律モードから、条件が整えば人の介入なしにタスクを最後まで押し進める完全自律モードまで、3つの自律性ティ …
manager-kanban 階層型チーム
NEW · v3.1 情報 所属価値: エージェンティックループエンジニアリング · エージェンティックハーネス 規模の大きなSPEC(要件仕様書)1つを実装し …
エージェントガイド
MoAI-ADK v3.0の11個のコアエージェントカタログ — 役割、フェーズ範囲、計画-監査の分離原則。
マルチモデル監査収束
NEW · v3.1 情報 所属価値: エージェンティックハーネス · エージェンティックループエンジニアリング マルチモデル監査収束(multi-model …
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ルーティング v3から/moaiのデフォルトルーティングはAnalyze-Firstです。英語キーワードを合わせて見るのではなく、リ …
settings.json ガイド
Claude Code の設定ファイル体系を詳しく案内します。エージェントに実行権限を委任するハーネスで settings.json はその委任の境界線を引くフ …
設定セクションリファレンス
.moai/config/sections/ の主要設定ファイル(handoff/delegation/llm/statusline/security) キーリファレンス。
セキュリティノート
MoAI-ADK セキュリティ強化の変更事項 (v3.0.0 導入、v3.0 系列で現行有効) — CWE-732/214/345 マッピング、ユーザー自己点検手順
ハーネスプロファイルと評価システム
すべての変更に同じ深さの検証を適用するとトークンが浪費され、検証を浅く統一すると品質が漏れます。MoAI-ADK の答えは 適応型検証 — SPEC の複雑度に …
Statusline システム — 3-line レイアウト完全ガイド
Claude Code と moai-adk-go の統合のための カスタム statusline システム です。トークノミクスは測定から始まります — コン …
CLAUDE.md ガイド
Claude Code の核心指針ファイル体系を詳しく案内します。CLAUDE.md は毎セッション常にロードされるファイルなので、このファイルの 1 行 1 …
カタログシステム
トークノミクスはトークンだけに適用される原則ではありません。プロジェクトに配布されるテンプレートファイル一つひとつも、結局はセッションがロードすることになるコン …
MoAI Web Console
5 つの領域(概要・カンバン・SPEC・モニター・設定)で構成されたローカル運用コンソール — リアルタイム更新、読み取り専用の観測、設定編集。情報所属バリュー: トークノミクス · エージェンティック・ループ・エンジニアリング · エージェンティック・ハーネス

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 タグ | エージェント間のコンテキスト・不変契約・危険領域のインライン注釈 |
| セキュリティノート | 権限スタックとサンドボックス |
情報各ドキュメントは独立して読めます。ただし全体アーキテクチャを体系的に理解したい場合は、スキルガイド → エージェントガイド → ビルダーエージェント の順をお勧めします — 知識モジュールから実行者へ、実行者からジェネレーターへとつながる流れが、ハーネスの再帰構造をそのまま示しているからです。