당신의 코딩 에이전트에게는 장기 기억이 없습니다.
세션을 열어 인증 시스템이 어떻게 동작하는지 꼼꼼히 추론하고 깔끔한 설명을 써냅니다 — 그리고 다음 세션, 다음 레포에서는 다시 0부터 시작합니다. 같은 파일을 다시 읽고, 같은 아키텍처를 다시 추론하고, 한 달 전에 이미 설명하게 시켰던 그 결정을 또 설명합니다. 매 대화가 출근 첫날입니다.
답답한 건 에이전트가 기억을 못 한다는 점이 아닙니다. 그 지식이 이미 존재한다 는 점입니다 — 에이전트가 직접 적어 놨거든요. 다만 그걸 둘 단단한 곳도, 다시 찾을 방법도 없었을 뿐입니다.
쓰기 전용(write-only) 지식
에이전트가 설계 문서나 사후분석을 레포에 써넣으면, 그 문서는 사실상 쓰기 전용 이 됩니다. 그걸 만든 에이전트가 다음 주에 검색할 수 없습니다. 관련 부분을 새 대화에 끌어올 수도 없습니다. 지식은 분명히 저장됐지만 실질적으로는 잃어버린 것입니다.
빠진 건, 에이전트가 쓰기도 하고 다시 읽기도 할 수 있는 책장 — 레포를 넘나들고 세션을 넘나드는 책장입니다.
htmlbook이 바로 그 책장입니다
htmlbook은 원격 MCP 서버입니다. 한 번 연결하면, 에이전트는 자신의 문서를 단단한 기억으로 바꾸는 몇 가지 도구를 갖게 됩니다:
publish— 문서(명세, 설계 노트, 결정 기록)를 책장에 올립니다. Markdown이 원본(source of truth)으로 보존되고, 테마가 입혀진 리더로 렌더링되며, 버전이 관리됩니다.search— 지금까지 올린 모든 것에 대한 전문(full-text) 검색. 결제 흐름이 어떻게 되는지 다시 추론하기 전에, 책장을 먼저 검색하세요.get— 문서를 원래의 Markdown 그대로 다시 읽어 현재 작업에 곧바로 녹여 넣습니다.cite— 해당 제목으로 곧장 가는 딥링크를 만들어, 문서 전체를 붙여넣는 대신 특정 결정을 가리킬 수 있습니다.
책장은 나와 내 워크스페이스 범위라서, 내가 작업하는 모든 레포에 걸칩니다. 한 프로젝트에서 에이전트가 쓴 시스템 디자인 문서를, 몇 달 뒤 전혀 다른 프로젝트에서 다시 꺼내 쓸 수 있습니다.
왜 "Markdown이 원본"인 게 여기서 중요한가
미묘하지만 중요한 디테일: 에이전트가 Markdown 문서를 get 으로 다시 받을 때, 원본 .md 소스 를 받습니다 — 손실 있는 HTML 변환본이 아니라요. 그래서 읽고-수정하고-다시-올리는 루프가 깔끔하게 왕복합니다. 에이전트는 계획을 꺼내 갱신하고 다시 올려도 문서가 점점 깨진 마크업으로 망가지지 않습니다. 고쳐 쓸 수 있는 기억이, 읽기만 가능한 기억보다 훨씬 쓸모 있습니다.
관점의 전환
대부분의 AI 도구는 매 세션을 일회용으로 다룹니다. 하지만 에이전트가 이미 써내는 문서들이야말로 빠져 있던 장기 기억입니다 — 단지 저장만이 아니라 다시 꺼내기(recall) 를 지원하는 거처가 필요했을 뿐입니다.
에이전트에게 다시 읽을 수 있는 책장을 주세요. 한 번 연결하고, 간직할 가치가 있는 건 publish 하고 다시 추론하기 전에 search 하라고 일러두면 — 같은 질문이 더 이상 반복되지 않는 걸 보게 될 겁니다.