2026년 11월 20일 직접 시험 · Claude Code 2.1.326 · sonnet · auto mode · 대상: 이 채널 작업 저장소의 CLAUDE.md · AGENTS.md · 스킬 4개(글 파일만 뽑은 복사본) · 1회 · 명령 설명은 공식 문서(code.claude.com/docs/en/memory) 기준
CLAUDE.md에 규칙을 계속 쌓다 보면, 어느 순간 규칙끼리 부딪히는데 본인은 잘 모릅니다. 클로드 코드의 /doctor prompt-audit는 지시 파일들을 한꺼번에 읽고 낡은 지시 · 없는 파일 참조 · 서로 모순되는 규칙을 찾아 주는 명령이에요. 저희가 매일 쓰는 실제 규칙 파일에 돌려 봤습니다.
/doctor prompt-audit는 무엇을 검사하나요?
지시 파일을 모아서 옛 모델용 지시, 없는 파일이나 명령을 가리키는 줄, 서로 모순되는 파일을 찾고 수정안을 내놓습니다. 공식 문서에 따르면 대상은 CLAUDE.md · CLAUDE.local.md · AGENTS.md와 .claude/ · ~/.claude/의 규칙 · 스킬 · 명령 · 서브에이전트 · 출력 스타일이고, 경로를 주면 그 파일만 봅니다.
- 클로드 코드 v2.1.283 이상, 별칭
/checkup - 번들 스킬
/claude-api를 거쳐 도니까 그 스킬을 꺼 두면 안 됩니다 - 요청하기 전엔 파일을 바꾸지 않습니다
어떻게 돌렸나요?
저장소에서 글 파일만 뽑아 시험 폴더에 복사하고(비밀 폴더 · .env 제외), 경로를 지정해 한 줄로 돌렸어요.
/doctor prompt-audit CLAUDE.md AGENTS.md .claude/skills

처음엔 경로 없이 돌렸는데, 사용자 전역 폴더(~/.claude)까지 찾으려다 허락 창에서 멈춰 있었습니다. 프로젝트 파일만 보고 싶다면 경로를 붙이는 편이 깔끔해요. 경로를 붙인 두 번째 실행은 2분 48초(화면 표시) 동안 도구를 14번 쓰고 끝났고, 끝에 "파일은 수정하지 않았습니다"라고 적었습니다.
무엇이 나왔나요?
문제 8건, 확신도 높음 3 · 중간 3 · 낮음 2였습니다.

| # | 확신도 | 위치 | 문제 |
|---|---|---|---|
| 1 | 높음 | shorts 스킬 | '하루 2개 · 자정 예약'이 실제 공개 시각 설정 · run_day.py 상한과 다름 |
| 2 | 높음 | promo 스킬 | 같은 파일 안에서 음악 규칙이 앞뒤로 충돌 |
| 3 | 높음 | 스킬 명령들 | 무거운 작업 명령에 heavy.py가 없어 훅에 막힘 |
| 4 | 중간 | AGENTS.md | CLAUDE.md의 'PC 부하' 절이 통째로 빠짐 |
| 5 | 중간 | daily-videos 스킬 | 규칙 사이에 사건 이력이 쌓임 |
| 6 | 중간 | CLAUDE.md | '한두 줄 · 3줄' 같은 숫자 상한 |
| 7 | 낮음 | CLAUDE.md ↔ 스킬 | '이미지 읽지 말 것' vs 검수 때 시트 보기 |
| 8 | 낮음 | 경로 | 없는 파일 · 폴더 참조 몇 개(복사본에 안 옮긴 폴더 포함) |
높음 3건은 모두 '부딪힘'이었어요. 규칙을 고칠 때 한 파일만 고치고 다른 파일은 그대로 둬서 생긴 문제입니다. 8번은 복사본에 음악 · 광고 폴더를 옮기지 않아 생긴 것도 섞여 있어서, 실제 저장소에서는 더 줄어들 수 있습니다.
가장 아팠던 발견은?
4번이었습니다. AGENTS.md는 CLAUDE.md 앞부분을 복사해 둔 파일인데, 나중에 CLAUDE.md에 넣은 'PC 부하'(무거운 작업은 대기열로) 절이 빠져 있었어요. 이 파일을 읽는 다른 에이전트는 그 규칙을 모르게 됩니다.

제안은 어떻게 적용하나요?
보고서에 붙은 diff 중 하나를 골라 "그것만 적용해 줘"라고 하면 됩니다. 같은 대화를 이어서 "diff 2만 적용해 줘(AGENTS.md에 PC 부하 절 추가). 다른 파일은 건드리지 마"라고 했더니 18초 만에 AGENTS.md에 5줄을 붙였어요(복사본에만).

해 보니 규칙을 더 쓰는 것보다, 이미 있는 규칙끼리 부딪히는 곳을 먼저 찾는 게 효과가 컸습니다. 숫자 상한(6번)처럼 '거절해도 되는 항목'이라고 스스로 적어 둔 제안도 있어서, 하나씩 골라 적용하는 게 좋아요.
한 번에 정리
/doctor prompt-audit 경로…— 지시 파일의 낡은 지시 · 없는 참조 · 충돌을 찾아 수정안(diff)까지- 우리 규칙 파일(복사본): 2분 48초, 문제 8건(높음 3 · 중간 3 · 낮음 2), 파일 수정 0
- 경로를 안 주면 사용자 전역 폴더까지 보려다 허락 창에서 멈출 수 있음
- 제안은 하나씩 골라 "그것만 적용해 줘" — 우리는 18초에 1건 적용
출처: Claude Code 공식 문서 Memory — Audit your instruction files https://code.claude.com/docs/en/memory · Commands https://code.claude.com/docs/en/commands · 직접 시험 기록(2026-11-20, 작업 저장소 글 파일 복사본, 1회).
영상으로 보기: AItoZ 유튜브 쇼츠 '클로드 코드 명령 하나, 내 규칙 파일에서 문제 8개'
