Concept (개념)aidraftTue May 12
CLAUDE.md = 가드레일 (README 가 아닌 행동 규제 도구)
별칭: 가드레일 · guardrail · 행동 규제
#claudemd#guardrail#anti-readme#youtube-lecture#core-definition
정의
★ "CLAUDE.md 는 사람을 위한 README 가 아닙니다. Claude 가 같은 실수를 반복하지 않게 만드는 가드레일 입니다."
CLAUDE.md 의 근본 정체성 — 문서가 아닌 규제 도구. 사용자 발화·실벨 개발자 YouTube 강의의 한 줄 정의.
★ README ↔ 가드레일 비교
| 측면 | README | CLAUDE.md (가드레일) |
|---|---|---|
| 독자 | 사람 (개발자·외부) | AI (Claude Code) |
| 목적 | 프로젝트 소개·이해 | AI 가 실수 안 하게 |
| 작성 기준 | 읽기 좋게 | 행동 변화 일으키게 |
| 변화 주기 | 안정적 | 실수마다 갱신 |
| 어조 | 설명적 | 명령적 (IMPORTANT/YOU MUST) |
| 길이 | 자유 | 200 줄 이하 (Anthropic 권장) |
★ Anthropic 공식 4 작성 원칙 (재정의)
- 크기 (Size) — 200 줄 이하. 부풀려진 파일은 Claude 가 실제 지시 무시
- 구조 (Structure) — 마크다운 헤더·글머리. 조밀 단락 ❌
- 구체성 (Specificity) — 검증 가능 수준 ("2 칸 들여쓰기" > "코드 제대로 포맷")
- 일관성 (Consistency) — 충돌 → 임의 선택. 정기 검토
★ Karpathy 의 3 LLM 실패 모드 (영문 직접 인용)
가드레일이 왜 필요한가 의 근거:
- "The models make wrong assumptions on your behalf and just run along with them without checking."
- "overcomplicate code and APIs, bloat abstractions"
- "They still sometimes change/remove comments and code they don't sufficiently understand."
→ 3 가지를 막기 위한 가드레일. → 본 위키 lesson/karpathy-4-principles 의 4 원칙으로 제도화.
★ 디버깅 신호
- 규칙에도 불구하고 Claude 가 원하지 않는 작업 → 파일 너무 길어 규칙이 노이즈에 손실
- Claude 가 CLAUDE.md 답변된 질문 함 → 표현이 모호
"CLAUDE.md 를 코드처럼 취급 — 정기 정리, 변경 시 동작 변화 테스트." (Anthropic 공식)
강의 활용
- Ch3 — 본 카드의 직접 적용. 안티 패턴 표 + 5 분 운동.
- Ch4 — 4 작성 원칙 + 포함·제외 표.
- Ch5 — 실수 즉시 반영 워크플로우의 철학적 정당화.