Claude Code를 24/7 개발 팀으로 탈바꿈시킨 6가지 레이어

나는 모든 아키텍처 결정을 기억하고, 에이전트를 병렬로 실행하며, 요청하지 않아도 내 규칙을 강제하는 Claude Code 설정을 만들었다. 이 모든 것은 월 20달러짜리 Pro 플랜과 오픈 소스 조각들로 돌아간다.

내 CLAUDE.md 파일

프로젝트 루트에 위치한다. 모든 세션 시작 시 읽힌다. 건너뛰지 마라. 가장 유용하다.

# CLAUDE.md

## project
- stack: next.js 14, typescript, tailwind, postgres via prisma
- deployed on vercel, staging branch auto-deploys
- monorepo: /apps/web, /apps/api, /packages/shared

## conventions
- all components in PascalCase
- API routes return { data, error } format
- no default exports except pages
- tests live next to source files, named *.test.ts
- commits follow conventional commits (feat:, fix:, chore:)

## architecture decisions
- chose prisma over drizzle (dec 2024): type safety priority
- chose zustand over redux (jan 2025): less boilerplate
- auth via clerk, not next-auth: better DX for our team size

## current focus
- migrating payment system from stripe checkout to stripe elements
- performance audit on /dashboard (target: LCP < 2s)

## rules
- never mass edit more than 3 files without showing me the plan first
- always run existing tests before writing new ones
- if a task takes more than 5 steps, create a plan document first

규칙은 사소한 잔소리를 없애준다. 결정 사항들은 Claude가 선택을 번복하지 않게 한다. 규칙은 채팅에서 계속 수정하던 것들을 인코딩한다.

하지만 CLAUDE.md는 정적이다. 성장하는 메모리를 위해서는 다음 레이어가 필요하다.

세션을 넘어서는 메모리

세 가지 요소가 함께 작동한다.

지식 베이스로서의 Obsidian. Claude가 읽고 쓸 수 있는 구조화된 위키:

/vault
  /decisions      — every architecture decision with context
  /errors         — bugs we hit and how we fixed them
  /patterns       — code patterns that work in our codebase
  /sessions       — summaries of what happened each day
  /stack          — documentation for every tool we use
  Memory.md       — who I am, what I'm building, my preferences
  index.md        — master index of everything in the vault

이 구조는 Andrej Karpathy의 대규모 언어 모델 위키 개념에서 왔다. 지식은 재발견되는 대신 축적된다. https://github.com/karpathy/llm-wiki

claude-mem은 각 세션을 다음 세션으로 이어지는 영구 저장소로 압축한다.

claude-subconscious는 백그라운드 에이전트를 실행하여 세션을 지켜보고 프롬프트 없이 수동적으로 메모리를 기록한다.

Claude는 이미 내가 금요일에 결제 웹훅의 레이스 컨디션을 디버깅했고, 폴링에서 웹소켓으로 전환했으며, 테스트 업데이트가 여전히 필요하다는 것을 알고 있다.