"한 번 만든 CLAUDE.md는 살아 있는 문서입니다. 한 달에 한 번, 책상이 아니라 규칙 자체를 정리하세요."

30일 챌린지 끝낸 다음 날, 다시 파일을 열었습니다

캡스톤 데모를 마치고 다음 날 아침, 저는 커피 한 잔을 들고 다시 CLAUDE.md를 열었습니다.

낯설었습니다. 분명 제가 한 줄 한 줄 적어 넣은 파일인데, 절반은 왜 여기 있는지 기억이 안 나는 규칙이었습니다. "절대 하지 말 것" 섹션엔 같은 의미의 줄이 두 개 있었고, 한 달 동안 단 한 번도 안 발동된 규칙이 7줄이나 자리를 차지하고 있었습니다.

그날 깨달았습니다. 시리즈가 끝났다고 일이 끝난 게 아닙니다. 진짜 일은 그때부터 시작입니다.

한 번 만든 CLAUDE.md는 살아 있는 문서입니다. 한 달에 한 번, 책상이 아니라 규칙 자체를 정리하세요.

첫 달은 추가, 두 번째 달은 정리

첫 30일은 추가의 시간이었습니다. 사고가 터질 때마다 한 줄, 새 도구가 늘 때마다 한 줄. 챕터 4에서 약속한 대로 50~150줄 안에서 시작했지만, 한 달이 지나면 어느새 200줄에 가까워져 있습니다.

문제는 이겁니다. 두 번째 달부터는 추가보다 정리가 중요해집니다. 안 그러면 CLAUDE.md가 컨텍스트세(context tax) 폭탄으로 자랍니다. 세션을 열 때마다 안 쓰는 규칙까지 매번 다 읽혀서, 정작 오늘 작업에 쓸 토큰 예산이 줄어듭니다.

규칙을 늘리는 사람은 많지만, 규칙을 지우는 사람은 드뭅니다. 챕터 13이 다루는 건 정확히 그 빈 자리입니다.

트랜스크립트 마이닝 — 같은 말 5번 한 항목을 찾아라

가장 강력한 기법은 Eugene Yan이 트랜스크립트 마이닝(Transcript Mining)이라 부른 방법입니다.

지난 한 달 동안 AI에게 보낸 메시지 중, 같은 교정을 몇 번이나 반복했는지 세어 보세요. "can you also…", "did you check…", "still wrong" 같은 표현이 자주 나오는 패턴이 곧 룰로 옮길 후보입니다.

비개발자 버전은 이렇습니다. ChatGPT, Claude, Cursor 어디에 있든 지난 30일 채팅 로그를 한 번 통독하면서, 내가 같은 말을 5번 이상 한 항목을 형광펜으로 표시합니다. 그 5개가 다음 달 CLAUDE.md의 새 규칙 후보입니다.

검색어 예시: "again", "still", "또", "다시", "아니 그게 아니라", "방금 말한"

이 한 줄짜리 검색만 돌려도, 보통 한 달치 채팅에서 옮겨야 할 룰 3~7개가 그대로 드러납니다. 채팅창에 또 적었다면, 오늘 그 한 줄은 CLAUDE.md로 올라가야 합니다. 챕터 4에서 했던 약속을 한 달마다 한 번 갱신하는 의식입니다.

비개발자 사례 3개

사례 1 — PM. 회의록 자동 요약 운영자 박 매니저님은 첫 30일 후 채팅 로그를 통독했습니다. "마스킹" 관련 같은 교정을 12번 반복하고 있었습니다. 그 한 줄이 CLAUDE.md로 올라가자, 이후 한 달간 같은 교정이 0회로 떨어졌습니다.

사례 2 — 1인 빌더. 이 빌더님의 CLAUDE.md는 30일 만에 220줄로 부풀었습니다. 줄당 "이게 없으면 무슨 일이 나는가" 점검을 거쳐 71줄로 줄였더니, 새 세션 첫 응답 속도가 체감 30% 빨라졌습니다. 토큰 사용량도 일주일 평균 18% 감소.

사례 3 — 마케터. 김 매니저님의 feature_list.json엔 30일 이상 blocked로 묶인 항목이 7개 있었습니다. 전부 삭제하고 나니, AI가 "오늘 활성 항목"을 답하는 데 걸리는 시간이 짧아졌습니다. 죽은 항목은 살아 있는 뼈대의 가장 큰 무게였습니다.

3가지 정리 기법

(1) 중복 제거 — 한 규칙은 정확히 한 곳에 산다

CLAUDE.md 안에 "외부 발송 전에 사람 승인"이라는 규칙이 3절(하드 제약)과 8절(휴먼 체크포인트) 두 곳에 있으면, 한 곳으로 합치세요. 두 곳에 있으면 둘 다 흐려집니다.

(2) 충돌 해소 — 모순을 명시화하라

흔한 예시. "코드 주석은 영어로"와 "모든 문서는 한국어로"가 한 파일 안에 있습니다. 이건 충돌이 아니라 경계가 흐릿한 규칙입니다. "코드 주석은 영어, 마크다운 문서는 한국어"처럼 조건을 붙여 다시 적습니다.

(3) Lazy Loading — 가끔 쓰는 규칙은 분리

한 달에 1~2번만 발동된 규칙은 docs/auth.md, docs/payment.md 같은 주제별 가이드로 빼냅니다. CLAUDE.md에는 "인증 관련 규칙은 docs/auth.md를 먼저 읽으세요" 한 줄만 남깁니다. CLAUDE.md는 색인이지 사전이 아닙니다.

5분 리팩토링 의식 — 매월 1일에 30~60분

매월 1일에 캘린더에 박아두는 리팩토링의 날 의식입니다. 30~60분이면 충분합니다.

1. 지난 30일 progress.md를 한 번 통독합니다. 같은 막힘이 3번 이상 반복된 곳이 보입니다.
2. AI 채팅 로그에서 "같은 교정 5회 이상" 항목을 추출합니다. 트랜스크립트 마이닝.
3. feature_list.json을 점검합니다. 30일 동안 한 번도 active가 안 된 항목, 30일 이상 blocked로 묶여 있던 항목은 정리합니다. 죽은 항목은 지웁니다.
4. intent_sheet.md의 정지 규칙과 평가 지표를 갱신합니다. 한 달 사이 실제로 부딪힌 한계로 다시 적습니다.
5. CLAUDE.md를 줄당 한 번 더 점검합니다. 한 줄 한 줄 "이 줄이 없으면 어떻게 되는가?"를 묻습니다. 답이 "아무 일도 안 일어난다" 면, 그 줄은 그날 삭제 후보입니다.

세션 종료 체크리스트가 매일의 의식이라면, 이건 매월의 의식입니다.

리팩토링이 잘 되었는지 보는 3가지 지표

• 새 세션을 시작할 때 AI에게 다시 설명해야 하는 일의 횟수가 지난달보다 줄었는가? (목표: 줄어든다)
• CLAUDE.md가 늘어났는가, 줄었는가? 1~2개월차는 줄어드는 게 정상입니다. 늘기만 한다면 분리/삭제를 안 하고 있다는 신호입니다.
• 지난달에 잡았던 "같은 교정" 패턴이 이번 달에도 또 나타나는가? 같은 패턴이 두 달 연속 나타나면 룰이 틀린 위치에 있거나, 문장이 모호합니다.

세 지표 모두 숫자 한 개로 적어 progress.md의 월말 항목에 남겨두세요. 다음 달에 비교가 됩니다.

오늘의 5분 액션

이 글을 닫기 전에, 딱 다섯 가지만 해주세요.

1. 지난 30일 AI 채팅 로그에서 "같은 말을 5회 이상 적은 항목" 1개를 찾아냅니다.
2. 그 항목을 CLAUDE.md 또는 docs/ 어딘가에 룰로 한 줄 옮깁니다.
3. feature_list.json에서 30일 이상 죽어 있던 항목 1개를 삭제합니다.
4. CLAUDE.md에서 "이 줄이 없으면 아무 일도 안 일어나는" 줄 1개를 지웁니다.
5. 다음 달 1일을 "리팩토링의 날"로 캘린더에 박습니다. 30분 블록이면 충분합니다.

자가 점검 5문항

• ☐ 우리 CLAUDE.md를 지난 한 달 안에 단 한 번이라도 줄인 적이 있나요?
• ☐ 같은 교정을 5회 이상 반복하고도 룰로 옮기지 않은 항목이 있나요?
• ☐ feature_list.json에 30일 이상 죽은 항목이 있나요?
• ☐ 서로 모순되는 규칙 한 쌍을 발견하면 어떻게 처리하는지 한 문장으로 답할 수 있나요?
• ☐ 매월 1일에 리팩토링 의식이 캘린더에 박혀 있나요?

세 개 이상 아니오라면, 오늘 5분 액션이 정확히 다음 30일의 시작점입니다.

마무리 — 시리즈를 닫으며

다시 한번.

한 번 만든 CLAUDE.md는 살아 있는 문서입니다. 한 달에 한 번, 책상이 아니라 규칙 자체를 정리하세요.

챕터 1부터 12까지, 그리고 캡스톤, 이제 보너스 챕터 13까지. 12 + 캡스톤 + 13 = 시리즈 완결입니다. 하네스의 다섯 개 방을 다 채웠고, 한 달의 챌린지를 끝냈고, 이제 그 방을 매달 새로 정돈하는 의식까지 갖췄습니다.

마지막으로 한 문장만 남기겠습니다.

"AI와 일하는 것은 도구를 배우는 게 아니라, 동료 한 명을 한 번에 한 피드백씩 키우는 일입니다."

다음에 또 새 시리즈로 뵙겠습니다.

참고

• Eugene Yan, "How to Work and Compound with AI", eugeneyan.com/writing/working-with-ai/
• Anthropic, "Claude Code best practices: living context files" 공식 문서