AI 코딩 에이전트 메모리: 마크다운 파일로 Claude Code 대화 유지

핵심 방법: 채팅 창 대신 파일에서 대화하기

개발자는 Claude Code를 사용하지만 표준 채팅 인터페이스를 피합니다. 대신 에이전트에게 {topic}_LOG.md 파일을 생성하도록 지시하여 모든 중요한 논의가 진행되고 저장되도록 합니다. 채팅 창에서는 /response만 입력하여 Claude에게 현재 논의 파일을 확인하고 거기에 응답하도록 지시하며, 채팅은 지속성이 필요하지 않은 사소한 부가 질문을 위해 예약합니다.

파일 구조와 주석

응답은 일반적으로 일반 채팅처럼 LOG 파일 하단에 추가되지만, 특정 지점에 응답하기 위해 인라인으로 주석을 삽입할 수도 있습니다. 이는 프로젝트 계획 중 병렬적으로 명확히 하는 데 특히 유용합니다. 재독 시 명확성을 유지하기 위해 모든 인간의 의견은 Claude의 기여와 구분하기 위해 C:로 표시됩니다.

이중 메모리 시스템 아키텍처

LOG 파일 외에도 Claude는 {topic}_SUMMARY.md 파일을 생성하고 유지하도록 지시받습니다. 이 요약에는 LOG가 메모리에 맞지 않을 정도로 커지는 경우가 많기 때문에 줄 번호와 함께 원본 LOG에 대한 참조가 포함됩니다. 요약은 고수준 선언적 메모리 역할을 하고, LOG는 상세한 절차적 메모리 역할을 합니다.

에이전트 시작 및 메모리 관리

새 에이전트가 시작되거나 압축 후 프로세스는 다음과 같습니다:

사용자가 컨텍스트 제공: "당신의 작업은 {topic} 대화를 계속하는 것입니다. 우리는 X에 집중할 것입니다."
에이전트는 {topic}_SUMMARY.md를 읽어 중요한 내용을 이해합니다
요약은 X가 논의된 위치를 나타냅니다 (예: LOG의 100-200줄과 500-800줄)
에이전트는 해당 특정 LOG 줄과 최근 컨텍스트를 위한 마지막 백 줄을 로드합니다
에이전트는 요약에 언급된 세부 사항을 언제 조회할지 자율적으로 결정할 수 있습니다

유지 관리 및 품질 관리

간단한 서브에이전트가 주기적으로 요약을 스캔하여 해당 로그와의 적절한 동기화를 보장합니다. 다양한 주제의 요약에는 적절한 경우 상호 참조가 포함되어 모든 작업 에이전트가 추가 세부 사항을 조회할 수 있는 인프라를 제공합니다. 에이전트는 또한 해결되지 않은 C: 주석을 플래그하여 놓친 질문을 방지합니다.

폴백 및 문서화 이점

토큰 비용에 관계없이 최대 신뢰성을 위해 새 에이전트는 전체 LOG 파일을 재독하도록 지시받을 수 있으며, 이는 Python 파일 읽기나 웹 브라우징과 같은 다른 작업을 제외하므로 원래 논의보다 적은 메모리가 필요합니다. 추가로 LOG 파일은 동일 프로젝트에서 작업하는 다른 사람들을 위한 철저한 문서 역할을 합니다.

📖 전체 원문 읽기: r/ClaudeAI