Show HN: CodeAlmanac – 대화 내용을 기반으로 한 Karpathy 스타일의 코드베이스 위키

AI 코딩 에이전트가 코드 자체만으로는 파악하기 어려운 설계 의도, 과거 장애 이력, 주요 불변성(invariants), 파일 간 워크플로우 등의 맥락을 학습할 수 있도록 돕는 CodeAlmanac이 공개되었습니다.

주요 특징은 다음과 같습니다:

• 자동 관리형 위키: 코드베이스 내에 Plain Markdown 형태로 존재하며, AI 에이전트가 대화 내용을 스캔하여 유용한 지식을 위키에 자동으로 업데이트합니다.
• 로컬 실행 및 보안: 모든 위키 작업과 스케줄링 작업(Sync, Garden, Update)은 로컬 환경에서 실행되며, Git을 통해 코드 변경 사항처럼 리뷰할 수 있습니다.
• 지원 도구: 현재 macOS 환경에서 Codex 또는 Claude Code를 사용하는 환경을 지원합니다.
• 자동화 프로세스:
  • Sync: 최근 AI와의 대화에서 유용한 지식을 추출하여 위키에 큐잉합니다.
  • Garden: 위키의 내용이 오래되었거나, 중복되었거나, 연결이 부실한 부분을 검토합니다.
  • Update: CLI 업데이트를 안전하게 확인하고 설치합니다.