Fable Mode

---

Fable Mode は、AI コーディングエージェント向けのオープンソースの制御プレーンです。

エージェントが慎重に判断し、証拠を提示し、敵対的なレビューを乗り越えてから 初めてワークスペースへの書き込みを許可されるようにします。ゲートは プロンプト上の助言ではなく、機械的に制御されます。タイマーがなければ、証明がなければ、書き込みアクセスはありません。

デモ

KERR // ORRERY

自己完結型の HTML ファイルが 1 つ。生の WebGL、ライブラリゼロ、外部アセットゼロ、 ビルド手順もありません。

https://github.com/user-attachments/assets/8287bbfe-e3ee-4dcf-ba0f-f9ff22ae79bd

_{最終版の前に 7 件のレンダリングを却下 · 2 件のバグを検出 · レッドチームのプローブ 10 件すべてに合格}

Fable Mode の概要

https://github.com/user-attachments/assets/27f4f8a2-b1bb-4398-a08c-bc9fd93d69d7

クイックスタート

セッションはロックされた状態で始まります。自信があってもロックは解除されません。

1. 以下のいずれかの方法で MCP サーバーをインストールします。
2. 完全なワークフローを使う場合は、オプションの Agent Skill を追加します。
3. エージェントに具体的なコーディングタスクを依頼し、時間の上限を指定して Fable Mode を使うよう指示します。

新しいセッションは実行がロックされた状態で始まります。

{
  "action": "create_session",
  "session_name": "demo-refactor",
  "objective": "Refactor the parser without changing public behavior",
  "time_budget_minutes": 2
}

その後、エージェントは証拠と不変条件を記録します。早すぎる unlock_execution リクエストは、権限タイマーと証明の前提条件を満たすまで拒否されます。 いつでも get_status を使って、アクティブなフェーズ、残り時間、証拠の 件数、ロック状態を確認できます。

同じゲートがすべてのフェーズを保護します。主張には証拠レシート、コードには 5 つのベクトルを使ったレッドチームスウォーム、検証内容には封印された記録を適用します。

1 つのパッケージ、2 つのエージェント環境

Fable は 1 つの PyPI パッケージとして配布されます。同じパッケージにランタイム、stdio MCP サーバー、完全な Agent Skill が含まれています。MCP サーバーのインストールによってワークスペースの指示が暗黙に有効にならないよう、セットアップは明示的に行います。

エージェントが作業するプロジェクトからセットアップを実行します。

uvx --from fable-engine==1.3.9 fable-mode setup --yes

これにより、分離された uv 環境で固定バージョンのパッケージが解決され、バンドルされたスキルが .agents/skills/fable-mode にコピーされます。プレビューするには --dry-run を、 別のスキルディレクトリを指定するには --target <dir> を使います。永続的にインストールするには、次を使います。

python -m pip install fable-engine
fable-mode setup --yes

次に、エージェント環境に合った呼び出し方法だけを選んでください。

ネイティブ MCP クライアント

fable-engine を stdio サーバーとして実行します。例：

// Claude Code: claude mcp add fable-engine -- uvx --from fable-engine==1.3.9 fable-engine
// Cursor or another JSON-configured client:
{
  "mcpServers": {
    "fable-engine": {
      "command": "uvx",
      "args": ["--from", "fable-engine==1.3.9", "fable-engine"]
    }
  }
}

インターネット接続可能なシェルサンドボックス、MCP ホストなし

同じパッケージは、直接 JSON トランスポートも提供します。fable-mode call に fable_session 引数オブジェクトを 1 つパイプで渡します。

printf '%s\n' '{"action":"create_session","session_name":"demo","objective":"Verify this change","time_budget_minutes":2}' \
  | uvx --from fable-engine==1.3.9 fable-mode call

このコマンドでは JSON Lines を使用します。入力行ごとに fable_session 引数オブジェクトを 1 つ、出力行ごとに JSON の結果を 1 つ渡します。権限のタイマーとセッションが同じ信頼されたランタイム内にとどまるよう、ワークフロー全体を通してプロセスを開いたままにしてください。1 行のパイプは、単一の確認呼び出しに便利です。各 uvx コマンドは分離された環境を解決できます。サンドボックスで呼び出し間も Python 環境が保持される場合は、pip install のほうが適しています。セッションデータは、その環境の外にある Fable のデータディレクトリに保持されます（FABLE_DATA_DIR で上書きできます）。

Python 3.10 以降、実行時の依存関係はありません。PyPI で fable-engine として公開されています。

スキルの有効化は引き続き明示的に行います

統一された方法は setup です。以前からある install-skill コマンドも、スキルのみをインストールする互換性のあるエイリアスとして引き続き利用できます。fable-engine も pip install fable-engine も、それだけでワークスペースに指示を書き込むことはありません。

仕組み

1. 思考 — 時間制限付きの検討を行います。タイマーが終了するまで、エージェントは書き込みできません。
2. 証明 — 主張には実際の証拠（ツールの受領記録、ハッシュ、不変条件）が必要です。
3. 攻撃 — レッドチームの群れがコードを破ろうとします。
4. 書き込み — その後に限り、ワークスペースのロックが解除されます。

オプション：AI による証拠の判定

セッション内の証拠は AI エージェントが記述するため、Fable ではオプションで、ワークスペースのロックを解除する前に外部のレビューモデルに証拠の監査を依頼できます。標準ライブラリのみを使用し、上限付きの HTTPS 呼び出しを 1 回行います。ローカルモデルは不要で、RAM の追加消費もほとんどありません。デフォルトでは無効で、適用時はフェイルクローズです。捏造された証明のコストを引き上げますが、欺瞞を不可能にするものではなく、機械的なゲートが引き続き主な権限を担います。設定方法と誠実な制約については、AI による証拠の判定をご覧ください。

これは何ではないか

• 完璧なコードを主張するものではありません。保証ではなく、検証可能なワークフローです。
• より大きなプロンプトではありません。ロックは文言ではなく、エンジンによって適用されます。
• フレームワークへのロックインではありません。MCP と連携し、現在のエージェントと並行して動作します。

ドキュメント

• まずはこちら：実践ガイド
• Agent Skill リファレンス
• V1 → V2 移行ガイド
• V2 アーキテクチャ
• System 3（実験的）
• AI による証拠の判定（オプション）

コントリビューション

イシューやプルリクエストを歓迎します。CONTRIBUTING.mdをご覧ください。

---