Insitu

Situated identity for agents. Who you are here.

Insitu は再利用可能なスタンザ（常時適用されるガイダンスのセクション）を保存し、現在いるプロジェクト向けのプロトコルに構成します。materialize はそのプロトコルを、ホストがセッション開始時に既に注入するファイルに書き込みます。作成は list_stanzas とサイズの要約を使って行います。エージェントは resolve_protocol を使って検査し、available スタンザを取得します。

これはリポジトリ、コンポーネント、システムの事実をモデル化するものではありません。それは開発コンテキストツール（参照セットアップでは ContextForge）の役目です。この2つは並行して実行されることを意図しています。

ステータス

設計は 2026-08-17 に確定しました（DESIGN.md v0.5）。読み取りパス、ロール（§6.1）、validate / where_used、materialize は実装済みです。ミューテーションツールは最初のドッグフーディングの後まで待機します。現在の次のステップ: STATUS.md。

インストール

Python 3.11+ と uv が必要です。

cd insitu
uv sync
uv run pytest
uv run insitu

uv run insitu は MCP サーバーを stdio で起動します。

ボールトのルート

プロセスごとに1つのボールトを、次の順序で使用します:

1. INSITU_HOME

2. --vault /path/to/vault

3. ~/.insitu

新しいボールトは、ディスク上のフォルダーだけです（stanzas/、projects/、任意の config/surfaces.yaml）。このリポジトリの examples/vault/ は、指定して試せる架空のサンプルです:

uv run insitu --vault examples/vault

個人用のボールトをこの公開リポジトリにコピーしないでください。

ホストに MCP サーバーを追加する

Cursor、Claude Code、Grok のスニペットについては install/mcp.json.examples.md を参照してください。典型的な形は次のとおりです:

{
  "mcpServers": {
    "insitu": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/insitu", "insitu"],
      "env": { "INSITU_HOME": "/path/to/your/vault" }
    }
  }
}

3つのルーターをコピーする（一度だけ、ユーザーグローバル）

ルーターはホストに Insitu が存在することを伝えます。これらはプロジェクトのプロトコルではありません。

任意: install/AGENTS.md を手動で基本規約ファイルに貼り付けてください。materialize は AGENTS.md、CLAUDE.md、CLAUDE.local.md を決して書き込みません。

config/surfaces.yaml（grok、claude、cursor）でボールト内のホストアダプターを有効にします。その後、プロジェクトのチェックアウトから materialize を呼び出します。これにより、PROTOCOL.md と、.grok/rules/、.claude/rules/、.cursor/rules/ 配下のアダプターファイルが書き込まれます。

想定される使用法

# you, after a vault or map change
materialize               # PROTOCOL.md + host adapters (.grok/.claude/.cursor rules)

# agent, live / on demand
resolve_protocol          # inspect weight, refresh, compare to the materialized header
get_stanza ...            # pull an available stanza

# you, registering a new project
list_stanzas              # what exists, and how heavy each piece is
link_stanza ...           # after the write path exists
get_project               # how heavy is this project's protocol?

開発

uv sync
uv run pytest
uv run insitu

Python 3.11+、FastMCP。このリポジトリで作業するエージェントは AGENTS.md を参照してください。

ライセンス

MIT。LICENSE を参照してください。