매일 Claude Code를 사용한 지 8개월 만에, 저는 저의 워크플로우를 5단계 시스템으로 정리했습니다. 각 단계는 이전 단계를 기반으로 구축됩니다. 하나라도 건너뛰면 전체가 무너집니다.

대부분의 Claude Code 사용자들의 문제점

대부분의 사람들은 Claude Code를 ChatGPT처럼 사용합니다. 터미널을 열고, 질문하고, 닫고, 반복하는 식입니다. 다음 날이 되면 프로젝트에 대해 처음부터 다시 설명해야 합니다. 또다시 말이죠.

증상: 모든 세션의 20%가 컨텍스트 재설정(context re-establishment)에 낭비됩니다.
근본 원인: 프로젝트 메모리 부재, 워크플로우 규율 부족.

이것이 저에게 문제를 해결해 준 시스템입니다.

레이어 1: CLAUDE.md — 당신 프로젝트의 기억 닻(Memory Anchor)

이것이 기반입니다. 이것 없이는 다른 어떤 것도 작동하지 않습니다.

CLAUDE.md는 프로젝트 루트에 있는 파일입니다. Claude는 매 세션 시작 시 이 파일을 자동으로 읽습니다. 이 파일은 Claude에게 다음을 알려줍니다:

• 이 프로젝트가 무엇인지 (한 문장)
• 기술 스택 (예:

Layer 3: 작은 작업 — 하나의 단위, 하나의 커밋

각 작업은 하나의 논리적 단위만 변경합니다. 각 작업을 마친 후에도 프로젝트는 여전히 실행 가능해야 합니다.

나쁜 예:

You: "전체 retriever 모듈을 리팩토링해 줘." 
Claude: [8개 파일 변경] → 총체적 혼란

좋은 예:

You: "1단계: BM25 로직을 retriever/bm25.py로 추출해 줘"
Claude: [1개 파일 변경, 테스트 통과]
You: "2단계: retriever/fusion.py에 RRF 퓨전 추가해 줘"
...

이것이 중요한 이유: 각 커밋은 체크포인트입니다. 무언가 문제가 생기면? 어떤 커밋에서 그것이 도입되었는지 정확히 알 수 있습니다.

Layer 4: Git — 당신의 되돌리기 버튼

작은 작업마다 커밋하세요. 이것은 단순한 버전 관리가 아니라, 당신의 변경 기록입니다.

feat: BM25 retriever를 독립적인 모듈로 추출
feat: 하이브리드 검색을 위해 RRF 퓨전 추가
fix: BM25 쿼리에 대한 중국어 토큰화

커밋 히스토리가 바로 당신의 프로젝트 저널입니다. 6개월 후에도 어떤 디자인 결정이 내려졌는지 추적할 수 있습니다.

Layer 5: Worktree — 충돌 없는 병렬 작업

특징 A를 작업하면서 컨텍스트 스위칭 없이 버그 B를 수정해야 할 때:

# 특징 A 작업을 하는 동안...
git worktree add ../bugfix .claude/worktrees/hotfix
cd ../bugfix
...

또는 Claude에게

결과: 기능 배포 속도가 빨라지고, 버그 추적이 가능해지며, 모든 새로운 세션이 완전한 컨텍스트를 가지고 시작됩니다.

빠른 시작 체크리스트

Day 1: 적절한 CLAUDE.md 작성하기 (30분 — 고유한 내용만 쓰면 됩니다)
Day 2: 파일 간 변경을 하기 전에