에이전트 코딩 · 2026년 10월 5일 ★★★

개발자 케빈 리아오가 10월 3일 블로그에서 코딩 에이전트에는 대화 조각을 검색하는 기억 플러그인 대신 읽고 고치는 마크다운 문서를 주자고 주장했고, 해커뉴스 댓글 210개가 붙었어요

리아오는 대화에서 조각을 뽑아 임베딩하고 프롬프트마다 비슷한 조각을 꺼내 붙이는 RAG 기억 플러그인이 다섯 가지 문제를 안고 있다고 봐요. 비슷하다고 맞는 건 아니고, 조각만 떼면 맥락이 사라지고, 코드가 바뀌면 낡은 정보가 남고, 에이전트는 모르는 것을 검색할 수 없고, 무엇이 기억됐는지 사람이 들여다보기 어렵다는 거예요. 대안으로 명세·지시·조사·인덱스를 문서로 두고 「프롬프트 → 문서 확인 → 구현 → 문서 갱신」 순서로 일하게 하자고 하며, 1년 넘게 써 왔다는 자기 플러그인 Operator Memory(BSD 3-Clause, 별 257개)를 소개했어요. 해커뉴스에서는 기억이 낡아 맥락을 더럽힌다는 데 동의가 많았지만, 어떤 문서를 읽을지 고르는 문제는 마크다운에도 그대로 남고 에이전트가 쓴 문서는 수백 줄로 불어나 틀린 내용까지 섞인다는 반론도 나왔어요.

용어 풀이
RAG
검색 증강 생성. 질문과 비슷한 자료를 찾아 모델 입력에 붙이는 방식
임베딩
글을 숫자 벡터로 바꿔 비슷한 정도를 계산할 수 있게 하는 것
AGENTS.md
코딩 에이전트에게 저장소 규칙을 알려 주는 마크다운 지침 파일
ADR
아키텍처 결정 기록. 설계 결정과 그 이유를 남기는 문서
운영자 인사이트

근거는 글쓴이 한 사람의 1년 사용 경험이고 글은 자기 플러그인 소개를 겸해요. 플러그인을 들이기 전에 지금 쓰는 AGENTS.md·ADR 같은 문서를 에이전트가 작업 전에 읽고 작업 뒤에 고치도록 규칙을 정하고, 문서가 불어나지 않게 누가 언제 정리할지도 함께 정해 두는 것부터 해 볼 만해요.

여러 관점으로 보기
  • 도구 저장소 Operator Memory 는 프로젝트용 .operator/, 팀 공유용 .operator-shared/, 개인 규칙용 ~/.operator/user/ 세 곳에 마크다운 문서를 두고 클로드 코드·코덱스·OpenCode·Pi 등을 지원한다고 적혀 있어요. GitHub
  • 해커뉴스 토론 기억이 낡아 맥락을 오염시킨다는 경험담과 함께, 읽을 문서를 고르는 문제는 그대로라는 반론, 에이전트가 쓴 문서가 부풀어 잡음이 된다는 지적, 짧은 AGENTS.md 와 린트 같은 결정적 도구로 충분하다는 의견이 나왔어요. Hacker News

원본 보기 (hn:top-stories)