매 세션마다 AI에게 상황 설명하지 마세요. 제 바이브 코딩의 가장 큰 고통을 해결해 준 4개 파일 메모리 시스템.

저는 아누라그입니다. 50세의 비기술직 종사자이며 시카고에 거주합니다. 약 18개월 동안 바이브 코딩을 해왔고, Claude Code와의 대화만으로 실제 제품(33개 시장을 다루는 아시아 중심 스트리밍 발견 사이트, OTTASIA)을 완전히 구축했습니다. 코딩 경험은 전혀 없었습니다.

처음 6개월 동안 저는 반복되는 악몽에 시달렸습니다. 기능을 깊게 구현하다 보면 세션이 컨텍스트 제한에 도달했고, 다음 세션에서는 우리가 방금 결정한 내용을 전혀 기억하지 못했습니다. 실제 작업을 재개하기 전에 15~20분 동안 AI에게 상황을 다시 설명해야 했습니다. 더 나쁜 점은 중요한 아키텍처 결정들이 대화 기록에만 남아있어 사라져 버린다는 것이었습니다.

모든 것을 바꾼 해결책은 리포지토리에 체크인된 작은 마크다운 메모리 시스템이었습니다.

~/CLAUDE.md                              전역 프로필 + 작성 규칙
~/Code/<project>/CLAUDE.md               프로젝트 아키텍처 + 상시 규칙
~/Code/<project>/STATE.md                현재 진행 중인 작업
~/Code/<project>/journal/YYYY-MM-DD.md   세션별 기록
~/Code/<project>/BACKLOG.md              우선순위가 지정된 향후 작업
~/Code/<project>/FEATURES.md             출시된 기능 목록

실제 작동 방식은 다음과 같습니다:

1. 세션 시작 시, AI는 전역 CLAUDE.md, 프로젝트 CLAUDE.md, STATE.md, 그리고 최신 저널 항목을 자동으로 읽습니다. 다시 설명할 필요가 전혀 없습니다.
2. 세션 종료 또는 주요 마일스톤 달성 시, 저는 "체크포인트"라고 말하고 AI는 STATE.md를 업데이트하며 오늘의 저널(우리가 한 일, 결정한 내용, 시도했지만 실패한 내용)을 추가합니다.
3. 세션 도중 컨텍스트 제한에 도달하면, 새로운 세션이 STATE.md와 최신 저널을 읽고 우리가 중단했던 지점부터 정확히 작업을 이어갑니다.
4. 상시 규칙(저의 경우: "사용자에게 보이는 문구에 대시 사용 금지", "배포 전 Playwright로 확인", "로컬에서 npm run dev를 실행하지 않으므로 코드는 첫 시도에 정확해야 함")은 프로젝트 CLAUDE.md에 명시됩니다. AI는 매 세션마다 이를 읽고 절대 잊지 않습니다.

저널 파일은 숨은 공신입니다. 모든 배포에는 날짜가 적힌 섹션이 있습니다: 무엇을 배포했는지, 무엇을 시도했다가 실패했는지, 그리고 기억할 가치가 있는 교훈이 무엇인지 기록합니다. 6개월 후 "왜 예측기 크론이 이런 식으로 구조화되어 있지?"라고 물을 때, 제 저널에 평이한 영어로 답이 적혀 있습니다.

오늘 저는 약 2시간의 엔드투엔드 대화만으로 제품을 위한 영화 같은 창업자 스토리 페이지를 배포했습니다. 3개월 전이라면 같은 작업에 3번의 세션과 시작할 때마다 요약하는 과정이 필요했을 것입니다. 메모리 시스템이 그 차이를 만들었습니다.

실제 파일 템플릿과 동기화를 유지하기 위해 사용하는 프롬프트 패턴을 기꺼이 공유하겠습니다. 비기술직 창업자들에게 이것은 돌파구입니다. 병목 현상은 더 이상 AI의 능력이 아니라 컨텍스트 관리 능력입니다.