Hacker News가 주목한 Cog, Claude Code용 plain-text memory architecture

왜 이 Show HN 글이 눈에 띄었나

2026년 3월 25일의 Show HN 글은 Cog를 Hacker News에 올렸다. Cog는 Claude Code를 위한 "cognitive architecture"를 거의 전부 plain text 규칙으로 구현하려는 시도다. 링크된 문서는 이것을 application이 아니라 규약의 묶음으로 설명한다. CLAUDE.md가 행동을 정의하고, markdown 파일이 memory를 담고, filesystem이 Claude가 grep, find, git diff 같은 Unix tools로 직접 읽고 점검할 수 있는 interface가 된다. 많은 persistent-memory 실험이 database나 vector store, 별도 runtime을 추가하는 것과 달리, Cog는 그 반대 방향을 택한다.

구조는 어떻게 되어 있나

프로젝트는 memory를 세 단계로 나눈다. "Hot" memory는 현재 우선순위만 짧게 유지하고 모든 session에서 읽힌다. "Warm" memory는 personal, work 같은 domain 폴더에 들어가고 관련 skill이 활성화될 때만 열리는 구조다. "Glacier"는 오래된 기록을 index 뒤로 보관해, prompt를 비대하게 만들지 않으면서도 다시 찾을 수 있게 한다. 여기에 더해 각 파일에는 L0/L1/L2 retrieval 힌트가 붙어 있어, Claude가 전체 파일을 열기 전에 요약과 section을 먼저 보고 필요한 범위만 읽도록 유도한다.

Cog를 단순한 폴더 템플릿 이상으로 만드는 것은 workflow 층이다. 문서는 /setup, /reflect, /housekeeping, /evolve, /foresight 같은 command를 제공한다고 설명한다. 이 흐름은 observation을 pattern으로 압축하고, 오래된 정보를 archive로 옮기고, index를 다시 만들고, 시간이 지나며 memory architecture 자체를 다듬는 역할을 맡는다. 중요한 점은 model이 진화하는 것이 아니라 규칙과 memory 파일이 바뀐다는 것이다. 그래서 agent state가 불투명한 내부 메모리 안에 숨지 않고 git log로 추적 가능하다.

왜 의미가 있나

Claude Code를 이미 쓰는 팀에게 Cog가 흥미로운 이유는 persistent agent behavior를 review 가능한 infrastructure로 다루기 때문이다. 따로 운영할 service가 없고, 숨겨진 memory layer를 디버깅할 필요도 없다. agent가 이상하게 행동하면 관련 markdown, permission 설정, 최근 diff를 바로 열어볼 수 있다는 주장이다.

• Plain-text 우선: memory 파일을 표준 도구로 읽고 수정할 수 있다.
• Workflow 명시화: reflection과 housekeeping이 암묵적 background job이 아니라 command로 드러난다.
• 감사 가능성: git log가 memory의 일부가 된다.

물론 tradeoff도 분명하다. file-based memory가 실제로 도움이 되려면 hot memory는 계속 짧아야 하고, 사실의 소유권도 명확해야 하며, 무엇을 persistent state로 승격할지 사람 쪽의 discipline도 필요하다. 그래도 Cog는 developer-agent workflow가 어디로 가는지 잘 보여준다. 숨겨진 orchestration은 줄이고, inspectable text는 늘리는 방향이다.

Community source: Hacker News discussion. Original project: marciopuga/cog와 project docs.