AI 개발을 위한 '제2의 뇌' 패턴은 새로운 게 아니지만, 제대로 구현한 사람은 거의 없음. 제대로 구현하면 어떤 모습인지 보여줌.

Karpathy를 비롯한 AI 연구계 인사들이 예전부터 입이 닳도록 말하던 게 있지. LLM은 설계상 상태가 없는(stateless) 놈들이라, 외부의 영구적인 메모리가 필수라고. 이 개념 자체는 이제 논란의 여지도 없어. 근데 진짜 문제는 다들 CLAUDE.md 파일에 대충 세 줄 적어놓고 끝내는 게 아니라, 이걸 실제로 돌아가는 시스템으로 구현하는 놈들이 거의 없다는 거지.

나는 몇 달 전부터 Claude Code를 메인 개발 파트너로 삼아서 실제 서비스 중인 SaaS를 만들고 있어. 초반에 바로 깨달은 게 있는데, 병목 현상의 주범은 모델 성능이 아니라 '컨텍스트 손실'이더라고. 그래서 아예 구조화된 메모리 시스템을 직접 구축했지. 실제로 어떻게 돌아가는지 보여줄게.

아키텍처는 단층이 아니라 계층형이야.

대부분은 그냥 파일 하나에 다 때려 박는데, 그렇게 하면 확장성이 전혀 없어. 제대로 하려면 다음 세 가지 계층으로 나눠야 해.

• Global memory: 세션이나 프로젝트를 불문하고 항상 로드되는 메모리야. 내가 누군지, 어떻게 일하는지, 어떤 툴을 쓰는지, 그동안 AI한테 어떤 피드백을 줬는지 같은 것들. 이건 거의 안 바뀌어.

• Project memory: 해당 프로젝트를 할 때만 로드되는 메모리야. 현재 상태, 내린 결정들, 해결해야 할 질문들 같은 거. 이건 몇 세션마다 계속 바뀌지.

• Wiki: 영구적인 지식 베이스야. 새로 발견한 개념, 깨달은 패턴, 기억해둘 가치가 있는 버그 같은 걸 페이지로 정리해. 단순히 사실만 적는 게 아니라, 왜 그런 결론이 나왔는지 '이유'까지 같이 적는 게 핵심이야.
  마지막 이 부분이 다들 빼먹는 건데, 사실 이게 제일 중요해.

이유가 빠진 사실은 금방 잊히지만, 이유가 담긴 지식은 시간이 갈수록 쌓이거든.

"Supabase 조인할 때 T를 unknown으로 써라"라고 적어두는 건 딱 한 번밖에 못 써먹어. 근데 "왜 Supabase의 PostgREST 타입이 엄격한 TypeScript 환경에서 배열로 조인되는지, 언제 문제가 터지는지, 어떻게 알아채는지"를 설명한 페이지가 있다면? 그건 AI가 새로운 상황에서도 스스로 응용할 수 있는 지식이 되는 거야.

내 위키에는 지금 개념, 엔티티, 패턴을 통틀어 64개 페이지가 있어. 주제도 Supabase RLS 정책 구조부터 Stripe Connect 웹훅 라우팅, Next.js 스트리밍 패턴, 프로젝트 진행하면서 내린 비즈니스 결정까지 아주 다양해. 세션 끝날 때마다 새로운 페이지가 생기고 기존 페이지는 업데이트되지.

세션 종료 루틴이 이 시스템을 복리로 성장하게 만드는 핵심이야.

의미 있는 세션이 끝날 때마다 나는 종료 명령어를 실행하는데, 여기서 다음 작업들이 자동으로 돌아가:

• 아직 페이지가 없는 논의된 개념 추출

• 승인된 개념에 대한 새로운 위키 페이지 작성 (대충 적는 게 아니라 정의, 영향, 연관 관계, 미해결 질문까지 꽉 채워서)

• 세션 로그 업데이트 (추가만 가능, 수정 불가)

• 현재 상태를 반영한 프로젝트 메모리 업데이트

• 커리어 포트폴리오 업데이트 (작업 로그랑 링크드인에 바로 올릴 수 있는 성과 정리, 자동 관리됨)
  커리어 포트폴리오 부분은 다들 간과하는데 이거 진짜 꿀이야. 기술적인 작업들을 할 때마다 영어로 바로바로 기록이 남거든. 6개월 전에 내가 뭘 했는지 기억하려고 애쓸 필요가 없어.

이게 실제로 뭘 바꾸냐고?

이 시스템을 로드하고 시작하는 세션은 '0'에서 시작하지 않아. AI는 이미 프로젝트 아키텍처를 알고 있고, 3개월 전에 왜 그런 결정을 내렸는지, 어떤 패턴이 잘 먹혔는지, 뭘 절대 하지 말라고 했는지 다 알고 있어. 마치 몇 달 동안 이 프로젝트를 같이 해온 팀원처럼 움직이는 거지. 컨텍스트 측면에서는 실제로 그러니까.

8개월 동안 프로덕션 앱을 13단계까지 배포하면서, 이 '뇌'가 프로젝트에서 가장 가치 있는 자산이 됐어. 코드베이스보다 더 가치 있을 때도 많아. 코드는 '뭘 만들었는지'만 보여주지만, 이 뇌는 '왜 만들었는지'를 보여주거든.