무엇인가
LLM 코딩 함정을 막는 4원칙 지침(CLAUDE.md/스킬)
좋은 코딩 습관 4원칙
Andrej Karpathy가 관찰한 AI 코딩의 흔한 함정("모델은 확인 없이 잘못된 가정을 밀어붙이고, 코드를 과하게 복잡하게 만든다")을 막는 4가지 행동 규칙을 클로드에 심습니다. 65줄 남짓의 아주 가벼운 스킬입니다.
무엇인가
LLM 코딩 함정을 막는 4원칙 지침(CLAUDE.md/스킬)
핵심 원리
생각 먼저·단순함 우선·최소 수정·목표와 검증
설치 난이도
매우 쉬움 (의존성 0)
사용자 추천도 (참고)
★★★★☆ — 실제 코드 작업에 가볍게 유용
출처 · 라이선스
forrestchang(원본) · MIT · Karpathy 글에서 유래
적용 방식
자동 지침 주입(전용 명령 없음)
"모델의 가장 흔한 실수는 사용자를 대신해 잘못된 가정을 하고 확인 없이 밀고 나가는 것이다. 또한 코드와 API를 지나치게 복잡하게 만들고, 죽은 코드를 정리하지 않는다." — Andrej Karpathy
가정을 밝히고, 불확실하면 묻는다. 해석이 여럿이면 조용히 고르지 말고 제시한다. 더 단순한 방법이 있으면 말한다. → 눈치보며 넘겨짚기 대신 사전 확인.
문제를 푸는 최소 코드만. 요청 안 한 기능·추상화·"유연성" 금지. "200줄인데 50줄이면 되면 다시 써라." → 과설계 방지.
고쳐야 할 곳만 건드린다. 옆 코드·서식을 "개선"하지 않는다. 기존 스타일을 따른다. 바뀐 모든 줄은 사용자의 요청으로 설명돼야 한다. → 드라이브바이 리팩터·범위 확장 방지.
막연한 지시를 검증 가능한 목표로 바꾼다. "버그 고쳐"→"버그를 재현하는 테스트를 쓰고 통과시켜라". 다단계는 단계마다 "→ 검증: [확인]"을 붙인다. → 스스로 반복 검증 가능.
방법 A — 플러그인 마켓(권장)
/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skills@karpathy-skills
방법 B — CLAUDE.md 직접 내려받기(프로젝트별)
curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md
※ 링크로 받은 multica-ai/andrej-karpathy-skills는 원본(forrestchang)의 포크(사본)입니다. 내용은 같고, 설치 명령은 원본을 가리킵니다.
자동 적용입니다. CLAUDE.md로 두면 매 세션 규칙이 배경에서 적용되고, 스킬 형태면 코딩 작업 시 알아서 발동합니다(전용 슬래시 명령 없음).
> 사용자 전체를 내보내줘 [자동] 먼저 확인 — 페이지네이션? 민감정보 제외? 파일/API? > 이 빈 이메일 버그만 고쳐줘 [자동] 그 버그만 수정 — 정규식 "개선"이나 다른 검증은 건드리지 않음
아주 가볍고(65줄) 의존성 0·감사 쉬움. 실제로 자주 나는 실수를 정조준. 검증 가능한 목표 프레이밍으로 자가 검증. 지저분한 diff·불필요한 리팩터 감소. CLAUDE.md·플러그인·Cursor로 이식 가능.
"속도보다 신중"에 치우쳐 사소한 일엔 질문이 많아질 수 있음. 개발·테스트 맥락 중심(비코드 작업엔 덜 맞음). 강제가 아닌 지침 → 모델이 덜 지킬 수도. 기존 프로젝트 규칙과 병합·충돌은 사용자 책임.
쓰기 좋을 때: 실제 코드베이스에서 깔끔한 변경·최소 범위·유지보수가 중요할 때, 버그 수정·리팩터, 자꾸 과한 결과가 나올 때.
덜 필요할 때: 빠른 프로토타이핑·일회성 스크립트, 비코드·아주 사소한 작업(질문이 오히려 방해).