CLAUDE.md 가 안 지켜지는 이유 — 90KB 를 굴려보고 알게 된 것
규칙을 두 곳에 뒀는데 둘 다 안 걸렸다. 조건부로 내린 규칙은 한 번도 안 실렸다. 크기를 재보니 문서에 적힌 값이 낡아 있었다.
클로드 코드
6편 발행 · 18편 예정규칙을 적어놨는데 안 지켜질 때. 그 자리와 처방.
- CLAUDE.md 가 안 지켜지는 이유 — 90KB 를 굴려보고 알게 된 것
규칙을 두 곳에 뒀는데 둘 다 안 걸렸다. 조건부로 내린 규칙은 한 번도 안 실렸다. 크기를 재보니 문서에 적힌 값이 낡아 있었다.
2026-08-11 · 6분 - 매번 다시 물었다 — 문서가 아니라 화면이 답해야 하는 것
커밋까지 끝냈는데도 세션 꺼도 되나 또 물었다. 상태 표시줄에 판정 한 줄을 붙인 기록
2026-08-08 · 8분 - 「나중에 사람이 한다」고 적어둔 단계는 아무도 안 한다
자동 발행은 성공했는데 글이 없었다. 큐를 채우는 단계 담당이 「사람」이었다.
2026-08-06 · 4분 - 요약을 고쳤더니 원본이 낡았다
같은 사실이 여러 문서에 베껴져 있으면, 고칠 때 몇 곳인지 모른다
2026-08-01 · 2분 - 일괄 치환이 조용히 깨뜨린 세 가지
이름 3개를 한꺼번에 바꿨다. 조사가 어긋나고 개명 이력이 지워졌고, UI 라벨이 결정 라벨로 바뀔 뻔했다.
2026-07-30 · 3분 - 프로젝트를 옮기면 AI가 처음 만난 사람이 된다
같은 사고를 두 번 냈다. 기록을 게을리해서가 아니라 적어둔 자리가 틀려서였다.
2026-07-29 · 2분 - 내가 만든 규칙을 내가 안 걸었다 — 같은 날 두 번
- 규칙 두 개가 서로 반대를 말하고 있었다
- 사실을 알려줬는데 AI가 무시했다 — 지시가 사실을 이긴다
- 그 밖에 15편이 큐에 있다. 소재가 마르면 발행을 멈춘다.
버그와 함정
4편 발행 · 31편 예정에러 문구로 검색해서 온 사람이 답을 찾아가는 자리.
- 메일 607통을 지웠는데 화면은 1통 줄었다
삭제는 저장공간을 18% 줄였지만 눈에 보이는 건 그대로였다. 축을 잘못 잡았다.
2026-08-11 · 2분 - 주석 처리한 코드는 안 돌아온다 — 되살리는 방법까지 적어둬도
6주 전 주석이 증거였다. 지시받은 주석 처리를 조건부 노출로 바꾼 이유.
2026-08-10 · 3분 - 도구가 준 답이 내 질문에 대한 게 아니었다
whois가 5개 도메인을 전부 「등록됨」이라 답했다. 사실은 질문 자체가 닿지 않았다.
2026-08-02 · 3분 - Next.js 16에서 middleware가 조용히 꺼졌다
middleware.ts는 에러 없이 무시된다. 관리 페이지가 열린 채 배포될 뻔했다.
2026-07-31 · 3분 - 함수를 대체할 때, 그 함수가 몰래 하던 일까지 세어야 한다
- httpOnly 라서 안전하다고 적었다 — 같은 값이 DB 에 평문으로 있었다
- 규칙을 사람이 지키게 하면 두 번은 샌다 — 시간대 버그
- 그 밖에 28편이 큐에 있다. 소재가 마르면 발행을 멈춘다.
제품 만들기
2편 발행 · 15편 예정혼자 서비스를 만들며 겪은 것. 설계·화면·데이터.
- AI 리뷰 둘이 9건을 잡았다 — 10번째는 사용자가 잡았다
코드가 코드를 배신하는 자리는 리뷰가 찾는다. 코드가 현실을 배신하는 자리는 못 찾는다
2026-08-09 · 4분 - 거짓말을 안 하려고 넣은 표시가 거짓말이 됐다
빈 링크를 「만드는 중」으로 표시했는데, 넷 중 셋은 만드는 중이 아니었다
2026-08-05 · 3분 - 「누적 101」이 전부 내 방문인가 — 나를 빼려다 남을 지울 뻔한 이야기
- AI 모델을 바꾼 이유가 원가가 아니었다 — 재보고 나서야 보인 것
- 내가 만든 건 제품이 아니라, 제품이 뱉는 결과물 한 장이었다
- 그 밖에 12편이 큐에 있다. 소재가 마르면 발행을 멈춘다.
파는 일
1편 발행 · 7편 예정이름 짓기 · 판매 페이지 · 값 정하기 · 남의 주장 검증하기.
- AI 이미지는 법에 안 걸렸다. 그래서 괜찮은 게 아니었다
같은 날 정리한 유튜브 두 개가 정반대 증언이었다. 법을 확인하다 판단이 두 번 뒤집혔다.
2026-08-04 · 5분 - 표본 두 개를 시장의 천장으로 읽었다
- 「무료로 풀렸다」와 「그걸로 돈 벌어도 된다」는 다른 층이다
- 버튼이 없는 게 아니라, 내가 볼 때 아직 없었던 것이다
- 그 밖에 4편이 큐에 있다. 소재가 마르면 발행을 멈춘다.
써본 도구
1편 발행직접 써보고 나서 쓴다. 발표만 보고는 안 쓴다.