hey-recon – AI 에이전트가 컨텍스트를 잃지 않도록 저장소용 실시간 CONTEXT.md 생성하기
요약
AI 에이전트가 코드베이스의 컨텍스트를 즉시 파악할 수 있도록 CONTEXT.md 파일을 자동으로 생성해 주는 도구인 hey-recon을 소개합니다. 저장소 스캔과 LLM 합성을 통해 파일 구조, Git 히스토리 등을 요약하며, Git 훅을 통해 실시간 동기화를 지원합니다.
핵심 포인트
- AI 에이전트의 세션 간 컨텍스트 유실 문제 해결
- 파일 구조, Git 히스토리, package.json 등을 분석하여 요약
- CONTEXT.md, CLAUDE.md, .cursorrules 등 다양한 형식 지원
- Git 훅을 통한 커밋 시 자동 업데이트 기능 제공
여기서 확인해 보세요 HERE
저는 Claude Code와 Cursor를 사용하여 개발해 왔는데, 매번 똑같은 벽에 부딪혔습니다. 모든 새로운 세션이 제로(zero) 상태에서 시작된다는 점입니다. 에이전트는 저장소(repo)가 무엇인지, 우리가 어떤 컨벤션(conventions)을 따르는지, 혹은 우리가 방금 무엇을 작업하고 있었는지 전혀 알지 못합니다. 저는 매 세션마다 수동으로 컨텍스트(context)를 붙여넣어야 했습니다.
hey-recon은 단 한 번의 명령어로 이 문제를 해결합니다. 이 도구는 파일 구조, git 히스토리, package.json, 엔트리 포인트(entry points), 최근 커밋(commits) 등 저장소를 스캔한 뒤, LLM을 호출하여 어떤 AI 에이전트에게도 코드베이스를 설명할 수 있는 CONTEXT.md를 합성(synthesize)합니다. 또한 git 훅(hook)을 설치하여 매 커밋마다 파일이 자동으로 동기화되도록 유지합니다.
다음 세 가지 형식으로 출력됩니다:
- CONTEXT.md (범용)
- CLAUDE.md (Claude Code용)
- .cursorrules (Cursor용)
제가 필요해서 하루 만에 만들었습니다. MIT 라이선스입니다. 합성된 결과물이 실제로 유용한지, 아니면 제가 저장소에서 잘못된 신호(signals)를 포착하고 있는 것인지에 대한 피드백을 환영합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기