lat.md: 코드베이스를 위한 마크다운 기반 지식 그래프

기존의 단일 문서 방식(예: AGENTS.md)은 코드베이스가 커질수록 유지보수가 어렵고, 핵심 설계 결정이나 비즈니스 로직이 누락되어 AI 에이전트가 잘못된 맥락을 추론하는 문제를 야기한다.

lat.md는 프로젝트 루트의 lat.md/ 디렉토리에 상호 연결된 마크다운 파일들을 생성하여 코드베이스의 도메인 지식을 지식 그래프(Knowledge Graph) 형태로 압축한다. 위키 링크([[link]])를 통해 문서 간을 연결하고, 소스 코드 내에 // @lat: 주석을 추가하여 구현체와 개념을 직접 연결한다.

이 도구는 다음과 같은 이점을 제공한다:

• 에이전트 작업 속도 향상: 에이전트가 단순 검색(grep) 대신 지식 그래프를 탐색하여 설계 결정과 제약 사항을 빠르게 파악한다.
• 개발자 워크플로우 개선: 코드 변경 사항을 검토하기 전, lat.md/에 기록된 의미론적 변화를 먼저 확인하여 변경의 의도를 쉽게 이해할 수 있다.
• 지식 유지 및 보존: 에이전트가 작업 중 습득한 맥락을 그래프에 기록함으로써, 다음 세션에서도 처음부터 다시 학습할 필요 없이 전체 맥락을 유지한다.
• 테스트 명세 강제: 테스트 케이스를 마크다운으로 기술하고 코드와 연결하여, lat check 명령어로 구현과 명세 사이의 일관성을 검증한다.

lat CLI를 통해 환경을 초기화(lat init)하고, 임베딩 기반의 시맨틱 검색(lat search)을 수행하며, MCP(Model Context Protocol) 서버를 실행하여 에디터와 통합할 수 있다.