stele

Stele
AI エージェントのための、ガバナンスされた経験メモリ台帳です。うまくいったことと失敗したことを記録し、証拠を添えて、名前を明示した別の主体を通じてのみ教訓を昇格させることで、あらゆるエージェントが実体験に基づく確かなコンテキストを構築できます。

---

Stele とは？

Stele とは、後世の人々に向けて、出来事――功績、法律、警告など――を記録するために建てられた石碑です。Stele は、AI エージェントのための同じ発想、つまり タスク経験の集中型台帳 です。エージェントは各タスクでうまくいったことと失敗したことを記録します。ガバナンスゲートにより、名前を明示した別の主体が証拠を添えて昇格させるまで、それぞれの教訓は検索対象になりません。そして、今日のエージェントも将来のエージェントも、次のタスクに取りかかる前に、1つのプロトコルを通じて抽出された経験を取得できます。

ステータス：v18.16.4。 設計は stele_system_intent.yaml で確定しています。パッケージ：stele-core（ランタイム依存関係ゼロ。オプションの [mysql] を提供）＋ stele-mcp（stdio ＋ホスト型 HTTP）＋ stele CLI。

要するに、教訓は、証拠を添えて名前を明示した別の主体が昇格させるまで検索対象にならないエージェントメモリです。stele-ai.dev でホストされている Stele や、Stele という名前の他のプロジェクトとは関係ありません。

Stele を選ぶ理由（研究に基づく）

課題	根拠	Stele の対応
想起の成功 ≠ 行動の改善	MemoryArena（arXiv:2602.16313）	想起@kを宣伝するのではなく、タスク結果のハーネスを使用
自己省察は誤りを定着させる可能性がある	サーベイ（arXiv:2603.07670）	支持する証拠を添えて、名前を明示した別の主体が昇格させるまで隔離
あらゆるフレームワークがサイロ化している	memorywire（arXiv:2606.01138）	JSON Schema ＋プロジェクションヘルパー
事実は時間とともに変化する	LongMemEval（arXiv:2410.10813）	双時制の置き換え ＋ stale_policy

研究の詳細：docs/research/ · パターン：docs/patterns/。

インストール

pip install stele-core stele-mcp

Git からインストールする場合（コントリビューター向け）：

python3.11 -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt
pip install -e packages/stele-core -e packages/stele-mcp
make check   # ruff + mypy + pytest
make proof   # end-to-end PASS/FAIL proof

クイックスタート：docs/QUICKSTART.md · 比較：docs/COMPARISON.md。

クイックスタート（ライブラリ）

from pathlib import Path
from stele_core import Stele

s = Stele.open(Path(".stele-store"), store_id="demo", now="2026-08-20T12:00:00Z")
added = s.add({
    "layer": "failure_lesson",
    "title": "Pin cache keys to calendar buckets",
    "body": "Day-scoped keys prevent stale cross-day reads.",
    "scope": "project:demo",
    "temporal": {"valid_from": "2026-08-20T12:00:00Z", "last_verified": "2026-08-20T12:00:00Z"},
    "provenance": {
        "agent": "agent-a", "task": "cache-fix", "environment": "local",
        "subject_id": "subj-1", "source": "session:abc",
        "written_at": "2026-08-20T12:00:00Z",
    },
})
# → {"id": "se_…", "state": "quarantined"}  — not searchable yet

s.promote(added["id"], [{
    "type": "test_result", "issuer": "ci", "ref": "tests/test_cache.py",
    "observed_at": "2026-08-20T12:00:00Z", "verdict": "supports",
    "command": "pytest -q", "exit_status": 0,
}], actor="ci", ts="2026-08-20T12:00:00Z")

print(s.search("cache buckets", consumer_scope="project:demo"))
print(s.doctor(now="2026-08-20T12:00:00Z")["ok"])

CLI

stele init ./.stele-store --store-id demo
stele doctor ./.stele-store --now 2026-08-20T12:00:00Z
stele hygiene ./.stele-store --now 2026-08-20T12:00:00Z
stele entangled ./.stele-store --source web_page --now 2026-08-20T12:00:00Z
stele forget-check ./.stele-store --scope project:demo --subject-id subj-x --probe-query secret --now 2026-08-20T12:00:00Z
stele schema --out docs/schemas/entry.schema.json
stele snapshot ./.stele-store /tmp/stele-backup --now 2026-08-20T12:00:00Z --actor ops

MCP（stdio）

Model Context Protocol Python SDK 1.x（mcp>=1.0,<2）が必要です。 mcp 2.x では mcp.server.fastmcp が削除されているため、このサーバーは起動しません。

デフォルト（stele-mcp）： 35 個のガバナンス付き台帳ツール――追加、昇格、検索、診断、エクスポートなど。

export STELE_STORE=./.stele-store
stele-mcp

{
  "mcpServers": {
    "stele": {
      "command": "uvx",
      "args": ["stele-mcp"],
      "env": { "STELE_STORE": "/absolute/path/to/.stele-store" }
    }
  }
}

書き込みのたびに ts を渡してください。ストアは時計を読み取りません。

完全な研究ライブラリ（PEFT／エージェントパターンのツール約2000個）：stele-mcp-full。

MCP（ホスト型 HTTP）

HTTPS 経由で同じツールを利用できます（SSE + ストリーミング HTTP）。独立した 2 つのツールサーフェスが、 同じプロセス、同じ認証、同じストアを使用します。

サーフェス	SSE	ストリーミング HTTP	ツール
フル	/sse	/mcp	2003（台帳 + PEFT／パターン調査ライブラリ）
コア（ガバナンス対象の台帳のみ）	/core/sse	/core/mcp	35 — 以下の一覧を参照

本番環境：

• URL： https://stele.leocelis.com/sse · コア：https://stele.leocelis.com/core/sse（Bearer が必要です。セルフサービスキーはありません。独自にホストする場合は deploy/README.md を参照してください）
• クライアントの設定：docs/integrations/CURSOR.md · CLAUDE_CODE.md · CLAUDE_DESKTOP.md
• エージェントルール：docs/cursor-rules/stele-hosted-mcp.mdc

ローカルで実行（開発）：

bash deploy/build.sh
STELE_API_KEYS=stl_local_dev STELE_AUTH_DISABLED=false \
  STELE_STORE=./.stele-store \
  python deploy/wsgi.py --port 8080

• GET /health — 認証不要。tool_counts: {full, core} を報告します
• /sse + /mcp（フル）と /core/sse + /core/mcp（台帳のみ）— どちらも STELE_API_KEYS による Bearer 認証を使用します
• ホスト型の永続的な SoT：STELE_STORE_DSN + TLS CA（DSN はファイルパスより優先されます）
• API キー、DSN、PEM をコミットしないでください

{
  "mcpServers": {
    "stele": {
      "url": "https://stele.leocelis.com/core/sse",
      "headers": { "Authorization": "Bearer YOUR_KEY_HERE" }
    }
  }
}

ガバナンス対象の台帳ツール 35 個（TECH_SPEC §7.1-7.9 — create_core_app() が公開するすべてのツール）： add · update · promote · supersede · delete · search · reflect · link · list_contested · resolve_contested · verify · reviewer_corrections · hydrate · export · record_outcome · pin · stale_report · reverify · related · stats · timeline · verify_pack · attach · snapshot · doctor · entry_schema · purge_by_provenance · diff_stores · add_batch · entangled_suspects · hygiene_candidates · forget_compliance · lineage · belief_at · conflict_surface

アーキテクチャ

docs/ARCHITECTURE.md を参照してください。プレーン：契約 · ツール · ガバナンス · 検索 · エクスポート · リビング台帳 · 運用。

ドキュメント	リンク
OSS ガイド（まずはこちら）	docs/OSS_GUIDE.md
クイックスタート	docs/QUICKSTART.md
PRD	docs/PRD.md
TECH_SPEC v1.1	docs/TECH_SPEC.md
エントリー JSON Schema	docs/schemas/entry.schema.json
インテント（C1–C8）	stele_system_intent.yaml

ライセンス

MIT · Copyright (c) 2026 Stele contributors