Cadastre

自分が持っているインフラ、物が属する場所、適用されるルールを把握する。

Cadastre は、サーバー、サービス、ネットワーク、ドメイン、リポジトリ、デプロイメントポリシーのためのアドレス帳でありルールブックです。人や AI エージェントに、次のような質問への答えを一箇所で提供します。

• このアプリケーションはどこで実行できるか？

• プライベートに保つ必要があるか、それとも公開してもよいか？

• そのポートやホスト名はすでに使用されているか？

• それを所有しているパイプラインとリポジトリはどれか？

• その答えは最新か、検証済みか、それとも異議があるか？

Cadastre はそれらの事実をまとめ、各回答の出所を説明し、提案されたデプロイメントファイルをルールに照らしてチェックします。

これは地図であり、コントロールパネルではありません。Cadastre はワークロードのデプロイ、DNS や VPN の変更、コンテナの運用、シークレット値の公開を行いません。Cadastre を更新すると地図だけが更新されます。稼働中のインフラが変更されることは決してありません。

なぜ使うのか？

インフラに関する知識は通常、設定ファイル、ダッシュボード、ツール、そして人々の記憶に分散しています。それは、新しい人や AI アシスタントが安全な判断を下す必要が出るまでは機能します。

Cadastre は、その散在する知識を、出所が明確な回答と、情報が古い、未検証、または異議がある場合の明確な警告に変えます。推測する代わりに、呼び出し側は適切な選択肢、拒否された選択肢、関連するルール、そしてその根拠となる証拠を得ることができます。

平易な言葉での説明と例については、Cadastre の機能 をお読みください。

Related MCP server: codegraph-mcp

Docker によるクイックスタート

プロジェクトイメージで空の永続カタログを作成します:

docker run --rm \
  -v cadastre-data:/var/lib/cadastre \
  ghcr.io/thedancingdeveloper-org/cadastre:main \
  init --data-dir /var/lib/cadastre --empty

次に、準備ができたことを確認します:

docker run --rm \
  -v cadastre-data:/var/lib/cadastre \
  ghcr.io/thedancingdeveloper-org/cadastre:main \
  status --data-dir /var/lib/cadastre

main イメージは、最新の成功した main ブランチのビルドに追従します。本番デプロイでは、リリースパイプラインが公開する署名付きイミュータブルダイジェストを固定する必要があります。パッケージが Docker クライアントから見えない場合は、ghcr.io に認証するか、イメージをローカルでビルド してください。

ライブカタログを作成せずに探索するには、リポジトリをクローンして架空の例をクエリします:

uv tool install cadastre
cadastre --catalog examples/catalog brief
cadastre --catalog examples/catalog context-for \
  "an internal application that needs a GPU"

カタログのセットアップ、一般的なコマンド、コレクター、リモートアクセスについては、Cadastre の使用 に進んでください。

オプション: Manifest 作業台帳

Cadastre には、何が未処理か、何が最も重要か、そして出荷されたか に答えるオプトインモジュールも同梱されています。作業項目、イニシアチブ、フォージの issue やプルリクエストへのリンクを記録し、ローカルの Markdown タスクリスト、Git チェックアウト状態、GitHub の issue/PR の証拠を収集し、宣言とフォージの不一致を報告します。フォージに書き込むことは決してありません。

これは、カタログが modules.yaml で有効にしない限りオフです。そのようなファイルがない場合、スキーマ、OpenAPI ドキュメント、CLI ヘルプ、HTTP ルート、MCP ツールリストは、その存在を知らないビルドと同一です。有効にする方法は Cadastre の使用 を、設計については MANIFEST.md を参照してください。

AI エージェント向けに設計

このリポジトリと製品は、明示的に AI フレンドリーです。

Cadastre は、構造化された MCP、HTTP、CLI JSON、JSON Schema、OpenAPI インターフェースを提供します。回答には出所と信頼状態が含まれ、context-for は 1 つの決定に関連する事実と除外事項を返し、check はデプロイ前に提案された成果物をレビューします。AGENTS.md は、コーディングエージェント向けのリポジトリレベルの指示を提供します。

この設計により、Cadastre をインフラのコントロールプレーンに変えることなく、エージェントに有用なグラウンドトゥルースを提供します。

詳細情報

ライセンス

Cadastre は MIT ライセンス の下で利用可能です。