r/ClaudeCode•5개월 전•18•13
AI 코딩 에이전트를 위한 로컬 코드베이스 위키를 만들었습니다
I built a local codebase wiki for AI coding agents
핵심 요약
AI 에이전트가 코드의 히스토리와 맥락을 이해하도록 돕는 로컬 코드베이스 위키 'Almanac'을 개발했습니다.
- 코드베이스 맥락 — AI가 코드의 히스토리와 의사결정 과정을 파악하도록 지원함
- 로컬 위키 저장 — 코드베이스 내 마크다운 파일로 운영되어 보안과 접근성이 뛰어남
- 오픈소스 프로젝트 — 누구나 무료로 사용할 수 있는 오픈소스 도구로 공개됨
- 에이전트 효율성 — 반복적인 탐색 작업을 줄여 토큰 소모와 시간을 절약함
여러분 안녕하세요,
AI 코딩 에이전트를 점점 더 많이 사용하면서, 계속해서 같은 문제에 부딪혔습니다.
에이전트는 눈앞의 코드는 읽을 수 있지만, 보통 그 히스토리는 알지 못합니다.
왜 이상한 우회 코드가 존재하는지 모릅니다.
누군가 checkout/auth/billing을 건드렸을 때 무엇이 고장 났었는지 모릅니다.
3주 전의 오래된 채팅 기록에 담긴 불변성(invariant)에 대해 모릅니다.
매번 새로운 세션은 반복적인 탐색 작업으로 시작됩니다. 이는 레포지토리의 컨텍스트에 이미 포함되어 있어야 할 코드베이스 파일들을 다시 학습하느라 시간과 토큰을 낭비하게 만듭니다.
저는 이 문제를 해결하기 위해 Almanac을 만들었습니다.
Almanac은 AI 코딩 에이전트를 위한 로컬 우선 코드베이스 위키입니다. 코드만으로는 알 수 없는 의사결정, 흐름, 불변성, 사고 기록, 주의사항 등을 저장합니다. 우리는 이를 레포지토리 내부의 마크다운 페이지로 저장합니다.
무료 오픈소스이니 피드백 주시면 감사하겠습니다. 감사합니다!
