AI 에이전트에 필요한 건 기억이 아니라 문서다
Agents don't need memory, they need documentation

메모리 플러그인은 대화를 분석해 1,000개의 스니펫을 벡터 DB에 넣고, 매 프롬프트마다 유사한 5개를 주입한다. 하지만 이는 프로젝트를 이해시키는 게 아니라 RAG 복권에 가깝다. 유사성 검색은 정확성이나 맥락을 보장하지 못하고, 과거를 진실로 취급하며, 에이전트는 자신이 모르는 것을 검색할 수 없다. 저자는 대안으로 문서 기반 메모리 시스템인 Operator Memory를 제안한다. 에이전트가 작업 전 Markdown 두뇌를 참고하고 작업 후 업데이트하는 방식으로, 에이전틱 루프를 '프롬프트 → 빌드 → 망각'에서 '프롬프트 → 참고 → 빌드 → 업데이트'로 바꾼다.
에이전트는 기억이 필요 없다. 문서가 필요하다.
HN 토론
210- Garlef
결정론적 피드백이 훨씬 더 필요하다고 생각해요.
최근에 다음 아이디어에 기반한 접근법을 시도해봤는데 정말 놀라웠습니다 - 오류 메시지에 문제 해결 방법에 대한 설명이 포함된 Lint 규칙이요.
예를 들어 IOSP(통합 작업 분리 원칙)를 장려하는 데 사용하고 있습니다.
- spike021
어떤 걸 쓰든 간에, 작성된 내용을 강제할 방법이 필요하다고 생각해요.
내가 "json 파싱하는 python 스크립트 작성 대신 jq를 써"라고 하면, 절대 즉석에서 python 스크립트를 작성해서 json을 파싱하면 안 되죠. 그런데도 저한테는 계속 그런 일이 벌어집니다.
- gregwebs
동의합니다, 그리고 이게 더 나아 보이네요.
제 생각은 항상 에이전트 전용 문서를 만들고 싶지 않다는 거였어요.
저는 mattpocock/skills를 사용하는데, 이게 ADR(아키텍처 결정 기록)을 생성합니다. 여기서는 스킬만 사용하고, AGENTS.md에 몇 가지 포인터를 작성하는 설정 스킬도 포함되어 있습니다. 저는 항상 개발 흐름을 문서화하는 CONTRIBUTING.md와 CODING_STANDARDS.md를 가지고 있어요. 이것들과 README.md, 아키텍처 문서, 커밋 메시지 사이에서 에이전트가 문서를 찾아 사용하고 최신 상태로 유지하는 것 같습니다. 또한 많은 스펙을 작성해서 Github 이슈에 넣고 있습니다.
- atworkc
그냥 `workbench`라는 간단한 폴더로 정착했는데, 왜인지 새로운 모델들이 그게 뭔지 정확히 알고 있습니다. Git ignore 처리되어 있어요.
유일한 "프롬프트"는 AGENTS.md에 이게 존재한다는 것과 map.md <- 에이전트가 거기에 저장하는 것에 대한 한 줄짜리 참조가 있다는 정도입니다.
그리고 보통 새로운 기능을 다루다가, 어느 시점에 괜찮다 싶으면(그리고 메모리에 저장할 필요가 있으면) workbench에 메모를 적어두라고 시킵니다.
이렇게 하면 좋은 지점에서 다른 에이전트를 쉽게 생성할 수 있고, 그냥 workbench에 있다고 알려주면 됩니다.
토큰 비용도 괜찮아 보이고, 목적이 일시적이니 언제든지 거기 있는 걸 삭제할 수 있습니다.
- b-karl
우리 회사에서는 Claude Code를 사용하는데, 메모리가 시간이 지나면 낡아지고 컨텍스트를 오염시킨다는 데 동의합니다. 특히 외부에서 상태가 변할 때요. 예를 들어 누군가 리팩터링을 하거나 패턴을 도입했는데 제가 개발에 참여하지 않아서 로컬 메모리가 맞춰지지 않는 경우죠.
가장 최근 예는 문제 패치 계획에 계속 추가되던 몇몇 deprecated되고 archived된 저장소들이었습니다.
우리는 내부 플러그인과 스킬을 위한 private Claude 플러그인 마켓플레이스를 사용하는데, 저는 정기적으로 메모리를 정리하고 관련 있는 것들을 적절한 곳(마켓플레이스의 스킬, 저장소나 Notion의 문서 등)으로 옮기며 오래된 정보를 제거하려고 합니다.
- isaachinman
여러 회사를 컨설팅하면서 많은 반복 끝에 이걸 작성했습니다. 문서는 한 자릿수 밀리초 단위로 쿼리 가능하고, append only 로그 등등. 제 프로젝트에서 매우 잘 작동했습니다.
- bushido
최근에 시작한 건 메모리 대신 원칙을 작성하는 것이었습니다.
본질적으로 에이전트가 항상 생각해야 하는 패턴들이죠. 또한 코드에 있는 모든 주석에서 인용해야 하는 원칙에 버전 관리 시스템을 구현했습니다. 그렇게 하면 내 원칙이 발전할 때 코드도 함께 발전합니다.
친구들과 공유할 수 있게 패키징도 했습니다 [0]. 시스템은 아직 발전 중이지만, 지난 두 달 정도 사용하면서 정말 정말 잘 작동했습니다. 최신 모델에서는 더욱 좋았고요.
이 기법에 대해 에이전트들이 놀라울 정도로 잘 따랐습니다.
- alienbaby
집에서 '메모리'와 물건을 추적하기 위해 비슷한 걸 만들어본 경험을 말하자면, 데이터 양이 늘어나기 시작하면 읽기와 업데이트를 모두 처리할 때 토큰을 빠르게 소모할 수 있습니다. 오래된 정보를 관련성 있게 유지하는 것도 그렇고요. 작은 작업도 문서를 읽고, 업데이트하고, 대조하고, 새로 고치는 등의 과정에서 토큰 비용이 커질 수 있습니다.
하지만 제 홈 인프라, 서비스, CI/CD 설정, 호스트, 스토리지, 네트워킹 등에 대한 견고한 참조를 유지하는 것은 정말 놀라운 효과가 있었습니다. 홈 인프라 조각들을 사용해 테스트/배포/인수 테스트 등을 할 것으로 예상되는 프로젝트 전반에 공유할 '메모리' 세트로서요.