Cranot/roam-code

해결하는 문제

Roam-code는 AI 코딩 에이전트를 위해 로컬 코드베이스 인텔리전스 레이어를 제공하여 코드베이스 탐색 및 이해와 관련된 턴 수, 토큰 수, 비용을 줄입니다. 에이전트가 편집을 시작하기 전에 사전 해결된 코드 그래프 사실을 제공함으로써 여러 번의 grep과 같은 비용이 많이 드는 반복 검색 작업을 방지합니다.

작동 방식

Roam-code는 로컬 리포지토리를 SQLite 기반의 심볼, 호출, 임포트 및 Git 히스토리 그래프로 인덱싱하며 28개의 언어를 지원합니다. "Task Compiler"는 에이전트가 묻는 질문 유형을 인식하고 답변(예: 호출자 목록, 필터링된 Git 히스토리)을 직접 프롬프트에 삽입합니다.

또한, 각 편집 후에 실행되는 검증 루프를 구현하여 네이밍 규칙 위반, 임포트 환각, 구문 오류, 복잡도, 비밀 누출, 알고리즘 패턴을 검사합니다. Claude Code, Cursor, Continue와 같은 도구를 위한 MCP 서버로 통합될 수 있습니다.

대상

AI 코딩 에이전트를 사용하면서 LLM 비용과 지연 시간을 줄이고, 변경 사항이 안전하고 병합 가능하도록 로컬에서 인증 정보 없이 분석하고자 하는 개발자를 위한 솔루션입니다.

주요 특징

• Task Compiler: 리포지토리 사실을 사전 해결하여 에이전트 턴 수(벤치마크에 따라 최대 83% 감소)와 입력 토큰을 줄입니다.
• Local-First: API 키나 클라우드 로그인 없이도 소스 파싱 및 인덱싱이 모두 로컬에서 이루어집니다.
• Tamper-Evident Evidence: 서명된 ChangeEvidence 패킷을 생성하여 변경의 컨텍스트, 위험 및 검증을 문서화합니다.
• Verification Gate: 편집 후 자동으로 환각, 비밀, 구조적 문제를 검사합니다.
• Broad Language Support: SQLite 기반 코드 그래프를 사용하여 28개의 언어를 지원합니다.