Contemplative Agent

September 12, 2026 · View on GitHub

Language: English | 日本語

Contemplative Agent

ローカル LLM で動く自律エージェントで、自分の憲法と価値観の変更を自分で提案します。採用するかどうかは、毎回人間が決めます。

Contemplative Agent は、人間が読んで編集できる形の憲法（constitution）を持ち、それを時間をかけて改正していく自律エージェントです。自分のエピソードログ（行動の生記録）をパターン（うまくいったことについての短い再利用可能な観察）に蒸留し、憲法・アイデンティティ・スキル・ルールからなる「価値層（value layer）」（エージェントの今後の振る舞いを形作る部分）への昇格を提案します。人間の承認ゲートを通らない限り、価値層には何も書き込まれません。

なぜこれがあるのか。 インストールも実行も普通のソフトウェアと同じですが、これは作業を片付けるための道具ではありません。実験です。明示的な価値観を持ったエージェントが何ヶ月も動き続け、その価値観の改正を提案し続けたら、何が起きるのか。観察対象はこの自己改正そのもので、ここではそれが例外的に見えやすくなっています。価値への変更が 1 件ずつ区切られた、後から再現（リプレイ）できるイベントとして残るからです。ここから見えてくるのは、1 体のエージェントの憲法がどう変わっていったかという履歴です。

エージェントが価値をどう蓄積し書き換えるかを調べている人や、端から端まで読み切れる規模の、推論をローカルで行う自律エージェントが欲しい人には、このリポジトリのコードとログがそのまま材料になります。

ループ全体は Python の CLI で、Ollama が配信する任意のローカル LLM で動きます。Apple Silicon Mac 1 台（M1 以降、16 GB）の小型モデルでも持ちこたえます。クラウドの LLM も、LLM の API キーも、シェル実行も使いません。localhost の Ollama を除けば、ネットワーク上の相手は投稿先の SNS だけです。

現在は Moltbook（AI エージェントだけが投稿する SNS）で動いています。Moltbook はエージェントが行動し、応答を受ける場であって、目的ではありません。この場を選んだのは、価値観が他のエージェントとの会話でどう振る舞うかに表れるからです。そして受け手の側に人間がいないので、実験がうまくいかなくてもその影響が人に届くことはありません。既定の憲法はプリセットの倫理枠組みの 1 つである Contemplative AI の四公理です（出典は関連プロジェクト。別のプリセットから始める方法はクイックスタートにあります）。

クイックスタート

前提: ローカルに Ollama をインストールしていること。SNS アダプタを使うなら Moltbook のアカウントも必要です（エージェントが使う認証情報はその API キーだけで、LLM 側には何も要りません）。生成には Ollama のチャットモデルなら何でも使えます（OLLAMA_MODEL で指定）。検証済みの既定は Gemma 4 E4B（gemma4:e4b、ディスク上 ~9.6 GB）で、16 GB の M1 Mac でループ全体が回ります。埋め込みには同じく Ollama が配信する nomic-embed-text を使います。

git clone https://github.com/shimo4228/contemplative-agent.git
cd contemplative-agent
pip install -e .            # または: uv venv .venv && source .venv/bin/activate && uv pip install -e .
ollama pull gemma4:e4b && ollama pull nomic-embed-text

cp .env.example .env        # MOLTBOOK_API_KEY を設定（moltbook.com でアカウントを作り、その API キーを貼る）

contemplative-agent init               # identity / constitution / skills / rules を ~/.config/moltbook/ に書き出す
contemplative-agent register           # このエージェント自身のプロフィールを Moltbook に作成（SNS アダプタのみ）
contemplative-agent run --session 60   # 既定は --approve（投稿ごとに確認）

別の倫理フレームワークから始めるには、init 時に 11 種のプリセットから選びます: contemplative-agent init --template stoic（ストア派、功利主義、ケアの倫理、カント主義、プラグマティズム、契約主義など）。エージェントが使うファイルはすべて ~/.config/moltbook/（MOLTBOOK_HOME）配下の編集可能な Markdown です。

dialogue（エージェント 2 体の対話）と meditate（瞑想シミュレーション）の各アダプタには外部アカウントは要りません（アダプタ参照）。CLI の全リファレンス、自律度（確認なしでどこまで動いてよいか）、スケジューリングは Configuration Guide にあります。

仕組み

graph TD
    EL["エピソードログ: 生の行動、追記のみ、信頼しない入力"]
    K["ナレッジ: 単一のパターンストア"]
    G{{"人間承認ゲート"}}
    EL -->|"distill（ゲートなし）"| K
    K -->|insight| G
    K -->|distill-identity| G
    K -->|amend-constitution| G
    subgraph VL["価値層: 書き込みは必ずゲートを通る"]
        Skills["スキル"] -.->|"family 昇格（ゲート付き・未実装）"| Rules["ルール"]
        Identity["アイデンティティ"]
        Constitution["憲法"]
    end
    G --> Skills
    G --> Identity
    G --> Constitution

要するに、distill はエピソードを 1 件ずつ読んでパターンを単一のナレッジストアに書きます。ここにゲートはありません。一方、価値層への書き込みはすべて人間が承認した昇格です:

コマンド	生むもの	ゲート
`distill`	ナレッジストアのパターン	なし
`insight`	スキル: パターンから取り出した、再利用できる行動の型	あり
（今は手書き）	ルール: 短い恒常的な規範。selector がいつも一緒に選ぶスキルの家族からの昇格は決定済みだが未実装（ADR-0097）	あり
`distill-identity`	アイデンティティ: 蒸留されたペルソナ	あり
`amend-constitution`	憲法の改正案	あり

View は、記憶のカテゴリ 1 つを定義する編集可能なテキストシードです（例: 自己省察）。ストアはクエリ時に view と照合して分類されるので、シードを書き換えれば取り込み直さずに検索結果が変わります（ADR-0019。ADR はこのプロジェクトの設計判断の記録です）。Markdown を手で編集することはいつでもでき、その場合はゲートを通りません。ゲートが管理するのは、エージェント自身が提案する変更です。

稼働中のエージェント

Contemplative Agent の 1 体が Moltbook で毎日稼働しています（v2.12.0、2026 年 9 月時点。生成はローカル Ollama の Gemma 4 E4B）。その憲法は稼働開始から同時点までにゲートを通って 3 回改正されており、憲法の変更履歴は公開されています。価値層全体と運用記録も公開しています。下の前半 4 件はゲートを通ったもの、後半 2 件はゲートを通らない記録です:

Identity: エージェントが自分について一人称で書いたペルソナ
Constitution: 現行の憲法本文
Skills: 1 スキル 1 ファイル。抽出日付きで、状況 / 問題 / 実践の構造を持ちます
Rules: スキルからの蒸留を生き残った、数少ない恒常的な規範
Daily reports: タイムスタンプ付きの対話記録（学術・非商用利用は自由）
Analysis reports: 行動の変化、憲法改正の実験

主な機能

判断を記録した項目には、末尾にその ADR を付けています。一覧は docs/adr/ にあります。

人間ゲート付きの価値層。 昇格のたびにゲートをどう通ったかの記録が残り、承認された値は蒸留時に焼き込まれるのではなく行動時にプロンプトへ読み込まれます（ADR-0012）。
エピソード単位の蒸留。 エンゲージメントのエピソード 1 件につき LLM を 1 回呼び、要約ではなくエピソード全体を読みます。ノイズは取り込み時ではなくクエリ時に view で濾します（ADR-0060）。
週次の staged insight。 パターンは毎日流入します。スキル候補は週に 1 回クラスタリングして承認待ちの列に入れるので、16 GB のホストで数千パターンになっても実用的な速度で回ります（ADR-0074）。
Markdown で貫通。 憲法・アイデンティティ・スキル・ルール・全パイプラインプロンプト・全 view シードは、MOLTBOOK_HOME 配下の Markdown ファイルです。プロンプトを編集すればパターンの抽出のされ方が変わり、シードを差し替えれば分類が変わります。カスタマイズ →

変える前に測る

パイプラインを変えるときの規則は 1 つです。先に読み取り専用の計器を建て、その読み値を見てから振る舞いを変えます。

どの機能も監査ログと一緒に出荷する。 外部 I/O、LLM 呼び出し、ヒューリスティックな判定を含む機能は、入力・判定・理由コード・結果を追記専用の JSONL に残す仕組みと同じ変更で入り、後からオフラインで再生できます。信頼しない入力は base64 とハッシュで保存し、判定を見送るときは必ず理由を残します（ADR-0075）。
読み値が介入より先。 contemplative-agent report --patterns | --skill-selection | --submolt-scope が保存データに対する読み取り専用の読み値を出します。view ごとのパターンの供給量と多様性、選択器の選択結果、submolt（Moltbook 内のトピック別コミュニティ）ごとの関連性の当たり率です。これまでに 2 つの振る舞いの変更が、勘ではなくこの読み値から出ました。蒸留時に生じていた自己相似な言い回しへの偏りの修理（ADR-0072）と、数週間にわたり本番に効かせず並走させた観測（shadow 読み値）を経てからのスキル選択の強制化（ADR-0081）です。
憲法改正はゲートの前に読み値を 2 つ余分に取る。 現行の憲法本文をモデルに見せずに、保存された憲法関連パターンから合成した影の憲法を現行と比較する読み値（ADR-0092）と、現行案と改正案がどれだけ協調的に振る舞うかを繰り返し囚人のジレンマで比べるベンチ（ADR-0090）です。どちらも人間の判断の材料であって判断そのものは決めず、ベンチで 2 つの憲法に差が出なくても、分かるのはジレンマでの振る舞いが同じということだけで、改正の他の性質については何も言えません。
行動 eval は、コメント経路が実際に何を生成するかを承認済みのベースラインと突き合わせます。プロンプトやモデルの変更は、印象ではなく判定の遷移として見えます（ADR-0089）。

セキュリティモデル

Security by absence（不在によるセキュリティ）。 危険な能力は最初から作っていません。シェル実行も、任意のネットワークアクセスも、ファイルトラバーサルもありません。接続先は moltbook.com と localhost の Ollama だけで、ランタイム依存は requests と numpy の 2 つです。他のエージェントの中で使うにあるオプションのアドオンはこれを緩めることがありますが、コアは緩めません。
1 プロセスにつき外部アダプタは 1 つ。外部との接点を増やすなら、別権限の別プロセスを増やします（ADR-0015）。
完全な脅威モデルは ADR-0007。セキュリティスキャン（2026-04-01）。

このリポジトリの URL を Claude Code などコードを読める AI に貼って、実行して安全かを聞いてみてください。コードが自分で答えます。

コーディングエージェント運用者への注意: エピソードログ（logs/YYYY-MM-DD.jsonl）は、フィルタされていないプロンプトインジェクションの入口です。代わりに蒸留済みの出力（knowledge.json、identity.md、reports/）を読んでください。Claude Code ユーザーは integrations/claude-code/ の PreToolUse hooks でこれを自動的に強制できます。

アダプタ

コアはプラットフォームに依存しません。アダプタは、プラットフォーム入出力の薄いラッパーです。

Moltbook: フィードエンゲージメント、投稿生成、通知への返信。稼働中のエージェントが使っているアダプタです。
Meditation（実験的。日常運用では使っていません）: "A Beautiful Loop" に着想を得た小さな瞑想シミュレーションで、エピソードログに対するオフライン実験としてだけ回します。
Dialogue（ローカル専用）: 2 つのエージェントプロセスが stdin/stdout パイプで対話します。約 150 行のアダプタ（adapters/dialogue/peer.py）で、ネットワークなしのテンプレートとしても使えます。contemplative-agent dialogue HOME_A HOME_B で憲法の反事実実験を駆動します。
自作アダプタ: 別のプラットフォームに向けるときは、コアには触らずアダプタを 1 つ書き足すだけです。プラットフォーム入出力をコアのインターフェース（メモリ、蒸留、憲法、アイデンティティ）に合わせて実装します。上の dialogue アダプタが、コピーして始めるいちばん小さな雛形です。コアのインターフェースは src/contemplative_agent/core/ に、その設計判断は docs/adr/ にあります。

アーキテクチャ

依存の向きは一方向です: adapters/ が core/ を import し、逆方向は存在しません。これはテスト時に import-linter が機械的に強制します。手で保守するモジュールマップはありません。構造はコードそのもの（language server、grimp）から読み、設計理由は docs/adr/ が持ちます（ADR-0102）。設計はプロジェクトの外から 2 箇所で借りていて、出典は関連プロジェクトにあります。メモリ設計（エピソードログ・知識・価値層）は唯識（心の働きを 8 つの識に分ける仏教の古典理論）に沿い、パイプラインは Agent Knowledge Cycle（経験をスキルに変える 6 フェーズの方法）を実装しています。

他のエージェントの中で使う

Contemplative Agent はホストに依存しない CLI です。単体で使う（クイックスタート参照）ほか、任意のエージェントホスト（OpenClaw / Codex / MCP ホスト）に CLI ツールとして登録し、ホストからサブプロセスとして呼び出せます。外部との接点は別プロセスに隔離されたままです。MCP サーバーとしては公開していません。四公理（既定の憲法。関連プロジェクトに列挙）をホストのパーソナリティとして読み込むには、contemplative-agent-rules（同じ四公理を持ち運べるペルソナファイルとしてまとめた姉妹リポジトリ）の SOUL.md を、ホストのパーソナリティファイルの置き場にコピーしてください。ホスト統合のガイドは docs/CONFIGURATION.md にあります。

オプション: マネージド LLM API

ローカルホストで動かせる範囲を超える生成モデルが要る実験向けに、オプションの contemplative-agent-cloud アドオンが、全生成呼び出しを LLMBackend Protocol 経由で Anthropic Claude / OpenAI GPT にルーティングします。main リポジトリのコードは無改変のまま、埋め込みはローカル Ollama のままです。これは「クラウドの LLM を使わない」という性質（すべての LLM 呼び出しが localhost に留まること）を緩める、明示的な選択制（opt-in）の機能です。クラウドへのデータ送出が許容できない環境ではインストールしないでください。

オプション: ローカル MLX ランタイム（Apple Silicon）

Apple Silicon で対話的な生成を速くしたい場合、オプションの contemplative-agent-mlx アドオンが、同じ LLMBackend Protocol 経由で生成をローカルの mlx_lm.server にルーティングします（埋め込みは Ollama のまま）。クラウドバックエンドではなくローカルランタイムの差し替えなので、「クラウドの LLM を使わない」という性質は保たれます。16 GB ホストでの無人スケジュール運用には向かないため、本番は Ollama で動かしています（ADR-0067）。

機械可読の入口

AI エージェントとクローラー向け: graph.jsonld に公理・メモリ層・ADR・パイプライン対応の関係が正式な形でまとまっており、llms.txt がナビゲーション索引、llms-full.txt が統合リファレンスです。対話的な入口は DeepWiki です。

引用

Shimomoto, T. (2026). Contemplative Agent [Computer software]. https://doi.org/10.5281/zenodo.22724623

上の引用は v2.11.0 の version DOI を使っています。DOI バッジは 10.5281/zenodo.19212118 に解決されます。こちらは常に最新リリースへつながる代表 DOI（all-versions concept DOI）です。

BibTeX

@software{shimomoto2026contemplative,
  author       = {Shimomoto, Tatsuya},
  title        = {Contemplative Agent},
  year         = {2026},
  version      = {2.12.0},
  doi          = {10.5281/zenodo.22724623},
  url          = {https://github.com/shimo4228/contemplative-agent},
}

MIT ライセンスの対象はコードで、書いてあるとおりの意味です。フォークしても、部品取りしても、パイプラインを自分のエージェントに埋め込んでも、その上に商用プロダクトを作ってもかまいません。コードを使うだけなら引用も不要です。