vercel-labs/lat.md

해결하는 문제

AI 에이전트를 위한 코드베이스 문서화에 단일 평면 파일(예: AGENTS.md)을 사용하는 것의 확장성 문제를 해결합니다. 프로젝트가 커짐에 따라 거대한 문서(monolithic documents)는 비실용적이게 되며, 이는 설계 결정 사항의 매몰, 문서화되지 않은 비즈니스 로직, 그리고 누락된 컨텍스트로 인한 에이전트의 환각 현상으로 이어집니다.

작동 방식

이 도구는 lat.md/ 디렉토리에 저장된 상호 연결된 마크다운 파일들로 구성된 지식 그래프를 생성합니다. 특정 연결 시스템을 사용하여 마크다운 섹션이 [[wiki links]]를 통해 서로를 연결하거나 특정 소스 코드 심볼을 연결합니다. 반대로, 소스 코드 파일은 // @lat: 주석을 사용하여 지식 그래프로 다시 연결됩니다. CLI 도구는 그래프를 초기화하고, 참조 일관성을 검증(lat check)하며, 로컬 WebAssembly 기반 임베딩 모델 또는 OpenAI와 같은 호스팅 제공업체를 사용하여 의미론적 검색을 수행하는 유틸리티를 제공합니다.

대상 사용자

이 도구는 세션 간에 컨텍스트가 유지되도록 코드베이스 내의 아키텍처, 비즈니스 로직 및 테스트 사양을 추적할 수 있는 구조화되고 유지 관리 가능한 방법을 필요로 하는 개발자와 AI 코딩 에이전트를 위해 설계되었습니다.

주요 특징

• 양방향 연결: 고수준 문서화를 소스 코드의 구현 세부 사항과 직접 연결합니다.
• 강제된 일관성: lat check 명령은 깨진 링크나 필수 테스트 사양에 대한 누락된 코드 참조를 표시합니다.
• 오프라인 의미론적 검색: API 키가 필요 없는 검색을 위해 번들로 포함된 로컬 임베딩 모델(all-MiniLM-L6-v2)을 제공합니다.
• 에이전트 최적화 워크플로우: 에이전트가 프롬프트에서 참조를 해결할 수 있도록 돕는 lat expand와 같은 CLI 명령과 에디터 통합을 위한 MCP 서버를 제공합니다.