← 에디토리얼

바이브코딩 실험 · 2026.11.20 · 5분

클로드 코드 명령 하나, 내 규칙 파일에서 문제 8개

AItoZ 개발팀 · 2026.11.20 발행

클로드 코드 명령 하나, 내 규칙 파일에서 문제 8개 — 바이브코딩 실험

클로드 코드 사용방법 · CLAUDE.md 작성법 — /doctor prompt-audit 한 줄로 이 채널이 실제로 쓰는 CLAUDE.md · AGENTS.md · 스킬 4개(복사본)를 검사했더니 2분 48초 만에 문제 8건이 나왔어요. 서로 부딪히는 규칙, 통째로 빠진 절까지. 허락 전엔 파일을 안 바꾸고, 제안 하나를 골라 적용하는 데 18초 걸렸습니다.

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

/doctor prompt-audit 실행 화면

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

무엇이 나왔나요?

문제 8건, 확신도 높음 3 · 중간 3 · 낮음 2였습니다.

진단 결과 8건

# 확신도 위치 문제
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 부하'(무거운 작업은 대기열로) 절이 빠져 있었어요. 이 파일을 읽는 다른 에이전트는 그 규칙을 모르게 됩니다.

발견 4 — AGENTS.md에 PC 부하 절 없음

제안은 어떻게 적용하나요?

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

diff 2만 적용 — 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개'

다음 글바이브코딩 '다 됐어요', 만든 팀은 안 믿는다→