vercel-labs/lat.md

解決する課題

単一のフラットファイル（AGENTS.mdなど）を使用してAIエージェント向けにコードベースをドキュメント化する際の、スケーラビリティの問題に対処します。プロジェクトが成長するにつれて、モノリシックなドキュメントは非実用的になり、設計上の決定事項が埋もれたり、ドキュメント化されていないビジネスロジックが発生したり、コンテキストの欠如によるエージェントのハルシネーション（幻覚）を招いたりします。

仕組み

このツールは、lat.md/ディレクトリに保存された相互接続されたMarkdownファイルで構成されるナレッジグラフを作成します。特定のリンキングシステムを使用しており、Markdownセクションは[[wiki links]]を使用して、互像に他のセクションや特定のソースコードのシンボルにリンクします。逆に、ソースコードファイルは// @lat:コメントを使用してナレッジグラフにリンクを戻します。CLIツールは、グラフの初期化、参照の整合性チェック（lat check）、およびローカルのWebAssemblyベースの埋め込みモデルまたはOpenAIのようなホスト型プロバイダーを使用したセマンティック検索を実行するためのユーティリティを提供します。

対象ユーザー

セッションを越えてコンテキストを維持するために、コードベース内でアーキテクチャ、ビジネスロジック、およびテスト仕様を追跡するための、構造化され、メンテナンス可能な方法を必要とする開発者およびAIコーディングエージェント向けに設計されています。

ハイライト

• 双方向リンキング: 高レベルのドキュメントをソースコード内の実装詳細に直接接続します。
• 整合性の強制: lat checkコマンドは、壊れたリンクや、必要なテスト仕様に対する不足しているコード参照をフラグ立てします。
• オフライン・セマンティック検索: APIキーを必要とせずに検索を行うための、バンドルされたローカル埋め込みモデル（all-MiniLM-L6-v2）が含まれています。
• エージェント最適化ワークフロー: プロンプト内での参照を解決するためにエージェントを支援するlat expandのようなCLIコマンドや、エディタ統合のためのMCPサーバーを提供します。