MemoryCustodian 가이드: 사용법, 최적의 프롬프트 및 활용 사례 (2026)

요약 (TL;DR): 이 MemoryCustodian 가이드는 이 도구가 무엇을 하는지, 5분 만에 설정하는 방법, 그리고 Claude Code, Codex, Gemini가 세션 사이에서 프로젝트를 잊어버리지 않도록 지속적이고 저장소 네이티브(repo-native)한 메모리를 제공하기 위해 어떻게 사용하는지를 다룹니다.

MemoryCustodian이란 무엇인가? (그리고 왜 모두가 이야기하는가)

MemoryCustodian은 개발자 Zekun Wang이 제작하여 오늘 Product Hunt에 출시된 무료 오픈 소스 도구입니다. 이 도구는 AI 코딩 에이전트 — Claude Code, OpenAI Codex, Gemini 및 일반적인 에이전트 워크플로우(agent workflows) — 에 내구성이 있는 프로젝트 수준의 메모리를 제공합니다. 컨텍스트를 호스팅된 데이터베이스에 저장하거나 계속 커지는 지침(instructions) 파일에 밀어 넣는 대신, MemoryCustodian은 메모리를 저장소(repo) 내부의 일반 Markdown 파일로 유지합니다. 결정 사항, 제약 조건, 거부된 접근 방식 및 프로젝트 컨텍스트는 여러분이 이미 사용 중인 동일한 Git 워크플로우를 통해 검토, 버전 관리 및 공유가 가능한 코드베이스의 일부가 됩니다.

**코딩 에이전트(coding agent)**를 사용해 본 적이 있다면, 이 도구가 해결하려는 문제를 이미 알고 있을 것입니다. 모든 새로운 세션은 아무것도 모르는 상태에서 시작됩니다. 아키텍처, 명명 규칙(naming conventions), 이미 시도했다가 거부한 라이브러리 등을 설명하지만, 다음 세션에서 에이전트는 그 모든 것을 잊어버립니다. 팀들은 결국 똑같은 컨텍스트를 반복해서 설명하거나, 매 프롬프트마다 점점 더 비대해지는 지침을 붙여넣게 되는데, 이는 토큰을 낭비하고 에이전트의 집중력을 흐트러뜨립니다.

이 MemoryCustodian 튜토리얼은 이 도구가 출시된 지 24시간이 채 되지 않았고 아직 포괄적인 리소스가 없기 때문에 작성되었습니다. 이 도구는 이미 Product Hunt의 일일 리더보드 3위에 올라 있으며, 이 도구가 해결하는 고충인 '에이전트 건망증(agent amnesia)'은 AI 에이전트로 개발하는 개발자 커뮤니티에서 가장 흔한 불만 중 하나입니다.

MemoryCustodian의 핵심 메커니즘은 매니페스트 (manifest) 시스템입니다. 경량화된 매니페스트는 들어오는 각 작업 — 계획 (planning), 구현 (implementation), 아티팩트 작업 (artifact work), 또는 유지보수 (maintenance) — 을 분류하며, 해당 카테고리와 관련된 메모리 파일만을 결정론적으로 (deterministically) 로드합니다. 메모리는 모든 프롬프트에 과도한 정보를 채우지 않으면서도 프로젝트의 규모에 따라 확장됩니다. 로컬 우선 (local-first) 방식이자 에이전트 간 호환 (cross-agent) 방식이기 때문에, 오늘 Claude Code를 사용하다가 내일 Codex로 전환하더라도 문제없이 작동합니다. 메모리는 특정 도구나 벤더 (vendor)가 아닌 리포지토리 (repo)와 함께 이동합니다.

MemoryCustodian은 누구를 위한 것인가요?

MemoryCustodian은 동일한 코드베이스를 대상으로 반복적인 AI 코딩 에이전트 세션을 실행하면서, 매번 컨텍스트 (context)를 다시 설정하는 것에 지친 모든 사람을 위해 구축되었습니다. 특히 프로젝트가 충분히 복잡해져서 "그냥 다시 설명하면 돼"라는 말이 5초짜리 비용이 아니라 실제 생산성 저하로 이어지기 시작할 때 매우 가치가 있습니다.

이상적인 사용자층은 다음과 같습니다:

• 서로 다른 AI 에이전트를 사용하여 여러 사이드 프로젝트를 병행하는 1인 개발자 및 인디 해커 (indie hackers)
• 인간 개발자와 코딩 에이전트 간에 작업을 전달하는 엔지니어링 팀
• Claude Code나 Codex를 기반으로 구축된 개발 숍 (dev shops)과 같은 AI 네이티브 에이전시 (AI-native agencies)로서 여러 클라이언트 리포지토리를 관리하는 경우
• 프로젝트 전반에 걸쳐 클라이언트별 제약 사항을 명확히 유지해야 하는 프리랜서
• 이번 주에 "그건 이미 해봤으니 다시 제안하지 마세요"라고 한 번 이상 타이핑해 본 사람이라면 누구나

MemoryCustodian의 주요 기능

리포지토리 네이티브 (Repo-Native), 평문 (Plain-Text) 메모리

호스팅된 서비스도, 불투명한 데이터베이스도 없습니다. 메모리는 리포지토리 내에 마크다운 (Markdown) 파일로 존재합니다. 이는 풀 리퀘스트 (pull request)에서 검토가 가능하고, 디프 (diff)를 비교할 수 있으며, 휴대 가능하다는 것을 의미합니다. 즉, 계정이 아닌 리포지토리와 함께 이동합니다.

매니페스트를 통한 선택적 로딩 (Selective Loading)

프로젝트의 전체 이력을 모든 프롬프트에 주입하는 대신, MemoryCustodian의 매니페스트는 작업 카테고리를 특정 파일에 매핑합니다. 계획 및 구현 작업은 기본적으로 decisions.md, constraints.md, do-not-use.md를 로드하며, 가벼운 작업은 추가적인 컨텍스트를 완전히 건너뜁니다.

에이전트 간 호환성 (Cross-Agent Compatibility)

MemoryCustodian은 Codex, Claude Code, Gemini 및 일반적인 코딩 에이전트 (coding-agent) 워크플로우를 명시적으로 지원합니다. 프로젝트 중간에 도구를 전환하더라도 메모리가 유지되므로, 특정 벤더의 컨텍스트 시스템에 종속되지 않습니다.

명시적 망각 및 수정 (Explicit Forgetting and Correction)

메모리는 쓰기 전용이 아닙니다. 이 시스템은 엔트리(entry)를 업데이트, 수정 및 안전하게 제거하는 것을 지원하므로, 오래된 결정이 남아 이후의 세션을 혼란스럽게 만드는 일을 방지합니다.

5분 만에 MemoryCustodian 시작하기

1. 설치하기. 공식 GitHub 저장소의 설정 지침을 따라 MemoryCustodian을 클론(clone)하거나 프로젝트에 추가하세요 (GitHub에서 "MemoryCustodian GitHub"를 검색하거나 제작자 Zekun Wang의 계정에서 찾을 수 있습니다).
2. 메모리 구조 초기화하기. 이를 통해 핵심 마크다운 (Markdown) 파일인 decisions.md, constraints.md, do-not-use.md와 작업 유형을 파일에 매핑하는 매니페스트 (manifest)가 생성됩니다.
3. 첫 번째 엔트리 기록하기. "중요한" 결정을 기다리지 마세요. 명명 규칙 (naming conventions), 거부된 라이브러리, 환경적 특이 사항 등을 기록하세요. 에이전트가 가장 빨리 잊어버리는 것은 바로 이런 사소한 것들입니다.
4. 에이전트가 매니페스트를 참조하도록 설정하기. Claude Code, Codex 또는 Gemini를 실행하든 상관없이, 새로운 작업을 시작하기 전에 매니페스트를 확인하도록 에이전트에게 지시하세요.
5. 실제 작업을 수행하고 수정하기. 에이전트가 프로젝트 전체 이력 대신 관련 메모리 파일만 로드하는 것을 확인하세요. 당신이 수행하는 모든 수정 사항은 다음을 위한 새로운 메모리 엔트리가 되며, 시스템은 복리로 쌓여갑니다.

MemoryCustodian의 7가지 최적 활용 사례

1. 개인 개발자의 컨텍스트 스위칭 (Context Switching)

동일한 코딩 에이전트를 사용하여 세 개의 사이드 프로젝트를 오가며 작업하는 경우, MemoryCustodian을 사용하면 프로젝트를 전환할 때마다 각 프로젝트의 아키텍처를 처음부터 다시 설명할 필요가 없습니다.

2. 팀 인수인계 (Team Handoffs)

에이전트가 시작한 작업을 이어받는 팀원은 Slack 스레드나 오래된 채팅 로그에서 추론 과정을 재구성하는 대신, 무엇이 왜 결정되었는지 정확하게 읽을 수 있습니다.

3. 거부된 접근 방식 추적 (Rejected-Approach Tracking)

이것은 아마도 가장 높은 레버리지(leverage)를 가진 단일 유스케이스(use case)일 것입니다. 에이전트가 3번의 세션 전에 이미 시도했다가 포기한 라이브러리나 패턴을 다시 제안하는 것을 방지하는 것입니다.

4. 에이전시를 위한 클라이언트 프로젝트 메모리 (Client Project Memory for Agencies)

여러 클라이언트의 리포지토리(repository)를 운영하는 에이전시(Agencies)는 클라이언트별 제약 사항 — 컴플라이언스(compliance) 규칙, 브랜드 보이스(brand voice), 기술 스택(tech stack) 제한 — 등을 코드와 함께 버전 관리할 수 있어, 클라이언트 간에 정보가 뒤섞이는 것을 방지할 수 있습니다.

5. 신입 엔지니어 온보딩 (Onboarding New Engineers)

신규 입사자는 "왜 이렇게 구축되었나요?"를 이해하기 위해 다섯 명에게 메시지를 보내는 대신 decisions.md를 읽을 수 있습니다. 이는 에이전트에 의해 유지 관리되는 살아있는 아키텍처 문서(architecture doc)가 됩니다.

6. 멀티 에이전트 워크플로우 (Multi-Agent Workflows)

Claude Code와 Codex는 동일한 리포지토리 내에서 동일한 메모리 파일을 공유할 수 있으므로, 프로젝트 중간에 도구를 전환하더라도 컨텍스트(context)가 초기화되지 않습니다.

7. 장기 리팩토링 (Long-Running Refactors)

에이전트 세션이 몇 주간 이어지는 리팩토링(refactor) 과정에서 부분적인 진행 상황과 근거를 추적하여, 인간이든 AI든 중간에 흐름을 놓치는 일이 없도록 합니다.

MemoryCustodian을 위한 5가지 복사-붙여넣기 프롬프트 (Prompts)

실제 메모리 파일을 빠르게 구축할 수 있는 가장 좋은 MemoryCustodian 프롬프트 5가지를 소개합니다. 이를 코딩 에이전트에 직접 붙여넣으세요.

프롬프트 1: 결정 로그 부트스트랩 (Bootstrap Your Decisions Log)

이 리포지토리의 코드베이스(codebase), 커밋 히스토리(commit history), 그리고 기존의 README나 문서들을 스캔하세요.
MemoryCustodian을 위한 `decisions.md` 파일을 생성하여, 당신이 추론할 수 있는 모든 주요 아키텍처 결정 사항 — 프레임워크 선택, 폴더 구조, 상태 관리(state management) 등 — 을 나열하세요.
...

프롬프트 2: 제약 사항 파일 부트스트랩 (Bootstrap Your Constraints File)

MemoryCustodian을 위한 `constraints.md` 파일을 생성하세요. 이 프로젝트의 타협할 수 없는 규칙들 — 코딩 스타일, 보안 요구 사항, 절대 사용하지 않을 라이브러리, 성능 예산(performance budgets) — 에 대해 저에게 인터뷰를 진행하세요. 한 번에 하나씩 질문하고, 각 답변을 ... 에 추가하세요.

프롬프트 3: 거부된 접근 방식 기록 (Log a Rejected Approach)

우리는 방금 [이유] 때문에 [접근 방식/라이브러리/패턴]을 사용하지 않기로 결정했습니다. 무엇이 거부되었는지, 왜 거부되었는지, 그리고 대신 무엇을 사용하고 있는지를 설명하는 항목을 `do-not-use.md`에 추가하여, 향후 어떤 세션에서도 이를 다시 제안하지 않도록 하세요.

프롬프트 4: 작업 카테고리 매니페스트(Task-Category Manifest) 생성

각 작업 카테고리(기획(planning), 구현(implementation), 산출물 작업(artifact work), 유지보수(maintenance))를 해당 카테고리가 로드해야 하는 메모리 파일과 매핑하는 MemoryCustodian 매니페스트를 생성하세요. 각 매핑에 대한 논리적 근거를 설명하세요.

프롬프트 5: 세션 종료 시 메모리 업데이트

이 세션을 종료하기 전에, 발생한 새로운 결정 사항, 제약 조건(constraints), 또는 거부된 접근 방식(rejected approaches)을 요약하세요. 이를 적절한 형식의 MemoryCustodian 항목으로 작성하고, 각 항목이 정확히 어떤 파일에 속해야 하는지 알려주세요.

MemoryCustodian vs. Cursor/Claude Code 내장 메모리: 무엇을 사용해야 할까요?

Claude Code나 Cursor와 같은 도구들은 점점 더 자체적인 프로젝트 지침(project-instructions) 파일(예: CLAUDE.md 스타일의 컨텍스트 파일)을 제공하고 있습니다. 이러한 방식은 정적이고 최상위 수준의 규칙을 적용하는 데는 괜찮지만, 관련성 여부와 상관없이 모든 프롬프트에 붙여넣어지는 하나의 거대한 파일이 되는 경향이 있습니다. 이는 바로 MemoryCustodian이 해결하기 위해 만들어진 '비대화(bloat)' 문제입니다.

MemoryCustodian은 이러한 파일들을 대체하는 것이라기보다, 그 위에 구축된 더 구조화되고 선택적으로 로드되는 계층에 가깝습니다. 결정 사항, 제약 조건, 거부된 접근 방식들은 각각 고유한 파일에 저장되며, 작업 카테고리가 요구할 때만 로드됩니다. 프로젝트 규모가 작다면 단일 지침 파일이 여전히 더 간단할 것입니다. 하지만 복잡하고 장기적으로 유지되는 코드베이스(codebase)를 대상으로 여러 에이전트(agents)를 운영하게 되면, 매니페스트 기반의 접근 방식이 그 가치를 발휘하기 시작합니다.

MemoryCustodian으로 수익을 창출하는 방법

1. 설정 가이드 또는 템플릿 팩 판매

지금 보고 있는 것과 같은 세련된 가이드와 함께 바로 사용할 수 있는 decisions.md, constraints.md, do-not-use.md 템플릿을 묶어 9~19달러 상당의 디지털 제품으로 판매하세요. 메모리 스키마(memory schema)를 처음부터 설계하고 싶지 않은 개발자들은 빠른 시작을 위해 기꺼이 비용을 지불할 것입니다.

2. 서비스로서의 "에이전트 메모리 감사(Agent Memory Audits)" 제공

$150–$500의 비용으로 고객이나 팀의 코딩 에이전트 (coding-agent) 워크플로우를 검토하고, 그들의 실제 기술 스택 (stack) 및 제약 조건에 맞춰 조정된 MemoryCustodian 구조를 설정해 줍니다. 이는 이미 AI 에이전트 컨설팅을 수행하고 있는 에이전시에게 자연스러운 업셀 (upsell) 기회가 됩니다.

3. 스택 특화 스타터 키트 (Stack-Specific Starter Kits) 구축

인기 있는 스택 — Next.js + Supabase, Django, 특정 SaaS 보일러플레이트 (boilerplate) — 을 위한 사전 작성된 메모리 템플릿을 $15–$29의 애드온 (add-on) 팩으로 판매합니다. 완전히 새로운 도구에 대한 선점자 가이드는 아직 다른 대안이 존재하지 않기 때문에 검색 순위가 높고 판매가 잘 되는 경향이 있습니다.

MemoryCustodian에 관한 자주 묻는 질문 (FAQ)

MemoryCustodian은 무료인가요?
네. MemoryCustodian은 무료이며 오픈 소스(open source)로, GitHub에서 이용 가능합니다. 호스팅되는 서비스나 구독 모델은 없으며, 메모리는 사용자의 자체 리포지토리 (repo) 내에 마크다운 (Markdown) 파일 형태로 로컬에 저장됩니다.

MemoryCustodian은 사용하기 안전한가요?
메모리가 사용자의 자체 리포지토리 내에 일반 텍스트 파일로 저장되기 때문에, 저장되는 내용에 대해 완전한 가시성과 제어권을 가집니다. 제3자 호스팅 데이터베이스로 아무것도 전송되지 않으므로, 데이터 민감도에 대한 우려가 있는 팀에게 적합합니다.

MemoryCustodian은 어떤 용도에 가장 적합한가요?
동일한 코드베이스 (codebase)를 대상으로 반복적인 AI 코딩 에이전트 세션을 실행하면서, 매 세션마다 아키텍처 (architecture), 제약 조건, 과거의 결정 사항들을 다시 설명하는 것에 지친 개발자와 팀에게 가장 적합합니다.

MemoryCustodian은 단일 CLAUDE.md 또는 지침 (instructions) 파일과 비교했을 때 어떤 차이가 있나요?
단일 지침 파일은 관련성 여부와 관계없이 모든 프롬프트 (prompt)에 붙여넣어지며, 프로젝트가 커짐에 따라 컨텍스트 (context)를 비대하게 만듭니다. MemoryCustodian의 매니페스트 (manifest)는 각 작업 카테고리에 관련된 메모리만 선택적으로 로드하므로, 규모가 더 크고 장기적인 프로젝트에서 더 잘 확장됩니다.

초보자도 MemoryCustodian을 사용할 수 있나요?
네. 핵심 워크플로우 — 메모리 파일 초기화, 몇 가지 항목 입력, 에이전트를 매니페스트로 지정 — 는 약 5분 정도 소요되며, 이 가이드에 포함된 복사-붙여넣기용 프롬프트가 대부분의 설정 작업을 대신 처리해 줍니다.

최종 결론

MemoryCustodian은 거의 모든 AI 코딩 에이전트(AI coding agent) 사용자가 겪어본 문제, 즉 세션이 종료되는 순간 에이전트가 모든 것을 잊어버리는 문제를 해결합니다. 메모리를 저장소(repo) 내부에 버전 관리되는 일반 Markdown 형식으로 유지하고, 모든 프롬프트에 한꺼번에 쏟아붓는 대신 선택적으로 로드함으로써, 프로젝트의 암묵적 지식(tribal knowledge)을 Git으로 추적 가능하면서도 동시에 에이전트가 읽을 수 있는 형태로 변환합니다.

이 도구는 무료이며 오픈 소스(open source)이고, 설정하는 데 약 5분 정도 소요됩니다. 만약 여러분이 Claude Code, Codex 또는 Gemini를 사용하여 한 번 이상 다루게 되는 코드베이스(codebase)를 작업하고 있다면, 아직 새로운 단계인 지금 바로 시도해 볼 가치가 있습니다.

MemoryCustodian 프롬프트 팩 전체와 수익화 플레이북(monetization playbook)을 원하시나요? 10개의 복사-붙여넣기용 프롬프트, 7가지 활용 사례(use cases) 전체 매핑, 그리고 단계별 수익화 플레이북이 포함된 전체 가이드를 준비했습니다. Gumroad에서 $9에 확인하기 →

발행일: 2026-07-29 | 수정일: 2026-07-29