recordant

Recordant

Recordant は、あらゆるホストソフトウェアシステム向けの、特許出願中の診断および意思決定台帳エンジンです。対象のリポジトリ、変更履歴、ログを指定すると、定期スキャンを実行して運用者向けブリーフを生成します。ブリーフには、変更点、問題の兆候、修正内容、優先順位付きの診断リストが含まれます。また、同じデータを扱うチャット対応の MCP コンソールも利用できます。

お好きな LLM をご用意ください（Anthropic、OpenAI、Gemini のいずれか。API キー、利用量、料金はご自身で管理します）。Recordant は特定のプロバイダーを前提としていません。

15 分でインストールして最初のブリーフを生成

1. パッケージと、利用する LLM プロバイダーの SDK（使用するものだけ）をインストールします。

   pip install "recordant[anthropic]"     # or [openai], [gemini], or [all]
   

2. recordant.example.toml を recordant.toml にコピーし、次の項目を設定します。

   • repo_root — 診断対象のリポジトリ
   • changelog_path — 通常は CHANGELOG.md（ファイルがない場合は git log にフォールバックします）
   • log_globs — ヘルススキャンの対象とするログファイル
   • [llm] — プロバイダー、モデル、api_key_env（API キーを格納する環境変数の 名前。API キー自体は指定しません）

3. API キーをエクスポートし、1 サイクルを実行します。

   export RECORDANT_LLM_KEY=sk-...
   recordant --config recordant.toml
   

   ブリーフのパスは標準出力に表示されます。ブリーフ、スナップショット、（任意の）意思決定台帳は、設定した output_dir の下に書き込まれます。

4. 設定ファイルの schedule_seconds の間隔に合わせて、cron、systemd タイマー、または独自のスケジューラーに登録します。

これで一連の処理は完了です。アダプターのアーキテクチャ、設定リファレンス、既知の制限事項については、ENGINE.md を参照してください。

MCP コンソール

Recordant は、チャット対応の MCP クライアントから利用できる、stdio 経由で 7 つのツールを公開する MCP サーバーとしても動作します。

ツール	用途
recordant_brief	前回のサイクル以降の最新の差分ブリーフ
recordant_status	現在のステータススナップショット（ヘルス、実行間隔、アクティブな台帳）
recordant_digest	未解決項目、受容リスク登録簿、リリース済みの修正、期限
recordant_open_items	経過期間、再発状況、根拠を含む、未解決の診断すべて
recordant_acknowledge	診断を確認済みにする（P0 項目は確認済みにできません）
recordant_accept_risk	診断を受容リスク登録簿に登録する
recordant_resolve	診断が解決済みであることを申告する（変更履歴と照合して監査されます）

トークン認証はデフォルトで有効で、匿名モードはありません。 サーバーは有効な RECORDANT_LICENSE_KEY を必要とし、ツールを 1 つも登録する前に起動時にライセンスサービスと照合します。短時間であっても、ライセンスなしでは動作しません。ライセンスサービスへの一時的なネットワーク障害には短いオフライン猶予期間が適用されますが、無効または期限切れと明示されたキーは直ちに拒否されます。

export RECORDANT_LICENSE_KEY=rk-...
recordant-mcp --config recordant.toml

MCP クライアント（Claude Desktop、Claude Code など）の設定に追加します。

{
  "mcpServers": {
    "recordant": {
      "command": "recordant-mcp",
      "args": ["--config", "/absolute/path/to/recordant.toml"],
      "env": { "RECORDANT_LICENSE_KEY": "rk-..." }
    }
  }
}

ライセンスと料金

Recordant はライセンス対象のソフトウェアであり、オープンソースではありません（LICENSE を参照）。キーの取得と最新の料金については、https://mentorsentinel.ai/markets-ai-governance.html をご覧ください。

Docker

Recordant はコンパイル済みのイメージとして提供されます。ビルド対象となるエンジンのソースコードはないため、docker build は顧客のワークフローには含まれません。ライセンス済みのイメージ（BUILD-RELEASE.md に従って公開）を取得して実行してください。

docker pull recordant/recordant:<version>
docker run -v $PWD/recordant.toml:/app/recordant.toml:ro \
           -v $PWD/target-repo:/app/target-repo:ro \
           -e RECORDANT_LLM_KEY \
           recordant/recordant:<version> --config recordant.toml

イメージには署名（cosign）が付与され、SBOM（syft）が同梱されているため、読み取り可能なエンジンのソースコードがなくても、依存関係や外部への通信など、その動作を監査できます。検証コマンドについては BUILD-RELEASE.md を参照してください。

MCP コンソールサービスを含む、Docker Compose を使ったセットアップについては docker-compose.example.yml を参照してください。

サポート

バグを見つけた場合や機能をリクエストする場合は、イシューを作成してください。.github/ISSUE_TEMPLATE/ を参照してください。ライセンスやアカウントに関するお問い合わせは、上記の料金ページをご利用ください。

特許

Recordant の推論ループと意思決定台帳のライフサイクルは特許出願中です（米国出願番号はご要望に応じてお知らせします）。「特許出願中」は、出願済みで未審査の仮出願を示すものであり、特許はまだ成立していません。