Lat.md: コードベースのためのマークダウンベースのナレッジグラフ

Lat.mdは、マークダウンファイルを使用してコードベースの知識グラフを構築するツールです。AGENTS.mdがスケールしない問題を解決します。プロジェクトが成長するにつれて、単一のフラットファイルを維持することは非現実的になり、設計判断が埋もれ、ビジネスロジックが文書化されず、AIエージェントがコンテキストを誤解する原因となります。

仕組み

ドメイン知識を、プロジェクトルートのlat.md/ディレクトリに保存された相互接続されたマークダウンファイルのグラフに圧縮します。セクションは[[file#Section#Subsection]]のような[[wikiリンク]]で相互にリンクし、マークダウンファイルは[[src/auth.ts#validateToken]]でコードにリンクし、ソースファイルはTypeScriptでは// @lat: [[section-id]]、Pythonでは# @lat: [[section-id]]のようなコメントを使用して戻りリンクします。lat checkコマンドは参照の一貫性を保証します。

主な機能

• エージェントのコーディングを高速化: コードをgrepする代わりに、エージェントは知識グラフを検索して、設計判断、制約、ドメインコンテキストを一貫して発見します。
• 人間のワークフローを高速化: エージェントはlatファイルを維持します。差分をレビューする際は、lat.md/内の意味的な変更から始めて、何がなぜ変更されたかを理解し、コードレビューを二次的にします。
• 知識の保持: エージェントは作業中にプロンプトからコンテキストと推論をグラフに取り込み、将来のセッションでは再発見する代わりに完全なコンテキストから始めます。
• 強制力のあるテスト仕様: テストケースは、require-code-mention: trueでマークされたlat.md/セクションで記述できます。各仕様はテストコード内の// @lat:コメントで参照されなければならず、lat checkはバックリンクのない仕様をフラグします。

CLIコマンド

• lat init: 人気のコーディングエージェントをフックと指示でセットアップし、latを最新かつ正確に保ちます。
• lat check: 参照の一貫性を強制します。エージェントは作業終了前に自動的に呼び出します。
• lat searchとlat section: エージェントはこれらを使用してプロンプトを理解し、グラフをナビゲートします。無限のgrep呼び出しの代わりになります。
• lat locate: 名前でセクションを検索します（完全一致またはあいまい一致）。
• lat refs: セクションを参照しているものを検索します。
• lat expand: エージェントのプロンプト内の[[refs]]を展開します。
• lat mcp: エディタ統合用のMCPサーバーを起動します。

インストールとセットアップ

npm install -g lat.mdでインストールし、リポジトリでlat initを実行してlat.md/ディレクトリをスキャフォールディングします。アーキテクチャ、ビジネスロジック、またはテスト仕様を記述したマークダウンファイルを書き、必要に応じてリンクします。

意味的検索（lat search）には、OpenAI（sk-...）またはVercel AI Gateway（vck_...）のAPIキーが必要です。キーは次の順序で解決されます：LAT_LLM_KEY環境変数（直接の値）、LAT_LLM_KEY_FILE環境変数（キーを含むファイルへのパス）、LAT_LLM_KEY_HELPER環境変数（10秒のタイムアウトでキーを出力するシェルコマンド）、またはlatによって保存された設定ファイル。