r/ClaudeCode•5개월 전•16•17

코드베이스를 위한 자동 업데이트 위키

Self-updating wiki for your codebase

핵심 요약

AI 코딩 에이전트가 과거 결정 사항을 기억하도록 돕는 자동 업데이트 위키 도구 'Almanac'을 소개합니다.

자동 업데이트 위키 — 코드베이스, 커밋, AI 세션 정보를 바탕으로 위키가 자동으로 최신 상태를 유지함.
마크다운 기반 저장 — 리포지토리 내부에 마크다운 파일로 저장되어 특정 도구에 종속되지 않음.
에이전트 최적화 — 개발자뿐만 아니라 코딩 에이전트가 직접 읽고 쿼리할 수 있도록 설계됨.
오픈 소스 공개 — 누구나 무료로 사용할 수 있는 오픈 소스 프로젝트로 제공됨.

지난주에 내린 결정이나 특정 기능이 왜 그렇게 구현되었는지에 대해 Claude에게 계속 상기시켜야 하는 상황에 지쳤습니다.

그래서 Almanac을 만들었습니다.

이 도구는 코드베이스를 위한 자동 업데이트 위키를 에이전트에게 제공합니다.

위키는 코드베이스, 커밋, 그리고 Claude/Codex 세션으로부터 정보를 받아 업데이트됩니다. 직접 확인할 수도 있지만, 주 사용자는 코딩 에이전트입니다.

리포지토리 내부에 마크다운 형태로 저장되므로 특정 도구에 종속되지 않으며, 어떤 코딩 에이전트든 이를 읽거나 쿼리할 수 있습니다.

무료이며 오픈 소스입니다.

여기서 사용해 보세요: https://github.com/AlmanacCode/codealmanac

원문

커뮤니티 목록

r/ClaudeCode•5개월 전•16•17

코드베이스를 위한 자동 업데이트 위키

Self-updating wiki for your codebase

핵심 요약

AI 코딩 에이전트가 과거 결정 사항을 기억하도록 돕는 자동 업데이트 위키 도구 'Almanac'을 소개합니다.

자동 업데이트 위키 — 코드베이스, 커밋, AI 세션 정보를 바탕으로 위키가 자동으로 최신 상태를 유지함.
마크다운 기반 저장 — 리포지토리 내부에 마크다운 파일로 저장되어 특정 도구에 종속되지 않음.
에이전트 최적화 — 개발자뿐만 아니라 코딩 에이전트가 직접 읽고 쿼리할 수 있도록 설계됨.
오픈 소스 공개 — 누구나 무료로 사용할 수 있는 오픈 소스 프로젝트로 제공됨.

지난주에 내린 결정이나 특정 기능이 왜 그렇게 구현되었는지에 대해 Claude에게 계속 상기시켜야 하는 상황에 지쳤습니다.

그래서 Almanac을 만들었습니다.

이 도구는 코드베이스를 위한 자동 업데이트 위키를 에이전트에게 제공합니다.

위키는 코드베이스, 커밋, 그리고 Claude/Codex 세션으로부터 정보를 받아 업데이트됩니다. 직접 확인할 수도 있지만, 주 사용자는 코딩 에이전트입니다.

리포지토리 내부에 마크다운 형태로 저장되므로 특정 도구에 종속되지 않으며, 어떤 코딩 에이전트든 이를 읽거나 쿼리할 수 있습니다.

무료이며 오픈 소스입니다.

여기서 사용해 보세요: https://github.com/AlmanacCode/codealmanac

주요 댓글

r/claudecode

에이전트 전용 위키라는 컨셉은 흥미롭지만, 기존 docs/ 폴더와의 통합이나 사람이 읽기 편한 형태에 대한 사용자들의 피드백과 개발자의 답변이 오가는 중.

이거 진짜 좋은 아이디어네. 나도 문서화하라고 시키고 claude.md에 언급까지 했는데도 안 해주는 문제 겪어봐서 공감됨.

진짜 좋은 아이디어네. 한참 이런 거 찾고 있었는데.

claude.md랑 뭐가 다른 거임? 완전 똑같은 거 아님?

민감한 정보는 어떻게 처리함? secrets가 wiki에 커밋될까 봐 좀 걱정되는데.

인정

레이어를 나누는 게 좋을 듯. CLAUDE.md는 테스트 실행 방법이나 프로젝트 컨벤션 같은 안정적인 운영 규칙에 적합하고, repo wiki는 모듈 존재 이유나 리뷰를 거친 결정 사항 같은 프로젝트 사실을 기록하는 데 더 나음. 모든 세션 노트를 자동으로 올리는 건 실패하기 딱 좋음. 커밋이나 PR, 명확한 결정 사항이랑 연결된 페이지만 canonical하게 만들고, 오래된 페이지는 쉽게 삭제되게 하는 게 좋을 듯.

다들 docs/ 폴더에 외부 공개용 문서를 두니까, 이건 에이전트가 참고하는 용도로 만든 거임. 그래도 docs/에 같이 있는 게 나을지 궁금하긴 하네. almanac serve 실행하면 위키 호스팅이랑 열람도 개쉬움!

글쎄, 그냥 LLM이 주요 변경 사항마다 docs를 업데이트하게 해서 한곳에 다 몰아넣는 게 낫지 않나? LLM 전용 섀도우 위키를 따로 만드는 게 무슨 이득임? 그리고 almanac serve로 mkdocs처럼 정적 HTML 출력도 가능함?

따로 만든 이유는 Almanac이 사람이 읽는 게 아니라 에이전트 검색에 최적화돼서임. 인덱싱 레이어랑 SQLite DB가 있어서 에이전트가 프로그래밍 방식으로 위키를 검색할 수 있음. 예를 들어 파일 읽을 때 almanac search --mentions src/foo.ts, almanac search "checkout retry bug", almanac search --topic auth 이런 식으로 특정 파일이나 서브시스템에 대한 문서, 결정 사항, 주의점을 바로 가져옴. 에이전트 메모리 중 Claude나 Codex한테 유용한 정보가 많지만 너무 노이즈가 심해서...

원문r/ClaudeCode