외부 메모리 — experiments.md 패턴
장기 자율 루프 에이전트가 컨텍스트 한계를 넘기 위해 사용하는 3종 파일 세트.
experiments.md가 단일 진실의 소스(SSOT)다.
정의
AI 코딩 에이전트가 며칠씩 굴러갈 때, LLM의 컨텍스트 윈도우는 곧 한계에 부딪힌다. 이를 보완하기 위해 루프 외부의 마크다운 파일에 진행 상태·계획·일시 메모를 분리 저장하는 패턴.
OpenAI Codex 내부 팀이 검증한 3종 세트:
| 파일 | 역할 | 수명 |
|---|---|---|
experiments.md | 단일 진실의 소스(SSOT) — 실험·시도·결과의 정본 기록 | 장기 (작업 종료까지) |
plan.md | 작업 계획 시각화 — 다음에 무엇을 할지 | 중기 (단계마다 갱신) |
experiments_note (scratchpad) | 일시적 사고 메모, 디버깅 노트 | 단기 (휘발 가능) |
왜 experiments.md가 핵심인가
- 분산된 LLM 호출은 서로의 상태를 모른다 → SSOT 1개로 동기화
- 새 루프 반복마다 이 파일을 읽고 시작 → 컨텍스트 손실에도 일관성 유지
- 결과·실패·가설이 누적되며 시행착오의 자산화 가능
운영 규칙
experiments.md는 append-only 권장 (과거 실험을 지우지 말 것)plan.md는 rewrite 허용 (현재 계획만 반영)- scratchpad는 매 루프마다 clear 가능
- 종료 조건과 체크리스트는
experiments.md최상단에 고정
다른 도구로의 이식
같은 패턴이 다음 도구에 그대로 적용된다:
- Claude Code (AGENTS.md 또는 CLAUDE.md 옆)
- Cursor (.cursorrules + 보조 md)
- Obsidian vault 안의 프로젝트 폴더
관련 개념
- goal-mode-자율루프
- 짧은-피드백-루프
- agent-memory-architecture
- AI-Memory-Organization
- Long-Term-Memory
- harness-engineering