OpenAI의 공동 창립자이자 전 Tesla의 AI 디렉터인 Andrej Karpathy는 몇 달 만에 수동 코딩 비중을 80%에서 에이전트 코딩(Agent coding) 비중 80%로 전환한 후, 자신만의 현장 노트(field notes)를 게시했습니다. 그가 명명한 패턴은 다음과 같습니다: 모델이 잘못된 가정을 하고 그대로 실행해 버리거나, 단순한 수정을 지나치게 복잡하게 만들거나, 이해하지 못하는 코드를 조용히 건드리는 현상입니다.
누군가가 바로 이러한 관찰 내용들을 가져와 Claude Code를 위한 네 가지 강제 가능한 규칙(enforceable rules)으로 변환했습니다.
작동 원리: 일반적인 "깨끗한 코드를 작성해 주세요"라는 지침 대신, Karpathy가 실제로 설명한 실패 모드(failure mode) 각각에 직접 매핑된 네 가지 구체적인 행동 양식을 Claude가 스스로 점검하도록 합니다.
0달러로 얻을 수 있는 것:
→ 네 가지 원칙이 담긴 하나의 CLAUDE.md 파일, 프로젝트에 넣기만 하면 끝
→ 코딩 전 생각하기: 가정을 소리 내어 명시하고, 추측하는 대신 질문하기
→ 단순함 우선: 200줄로 할 수 있는 것을 50줄로 줄일 수 있다면 다시 작성하기
→ 정밀한 변경(Surgical changes): 모든 수정된 라인은 실제 요청 사항으로 추적 가능해야 함
→ 목표 중심 실행: "버그를 수정해"가 "실패하는 테스트를 작성한 다음, 이를 통과하게 만들어"로 변함
→ Claude Code 외부에서도 동일한 가드레일(guardrails)을 사용할 수 있는 Cursor 규칙도 함께 제공
교체되는 것들:
→ AI가 50줄짜리 수정을 조용히 300줄로 부풀리는 현상
→ 모호한 요청에 대해 빠른 확인 질문 대신 조용히 추측하는 행위
→ 아무도 요청하지 않은 관련 없는 "정리(cleanup)" 편집
설정 방법 (2분 소요):
- README에서 네 가지 원칙을 복사합니다.
- 프로젝트 루트(root)에 CLAUDE.md로 저장하거나 기존 파일에 추가합니다.
- 또는 플러그인으로 설치합니다: /plugin install andrej-karpathy-skills@karpathy-skills
- 이 방식은 주의(caution)를 기울이도록 편향되어 있으므로, 사소한 한 줄짜리 코드에는 판단력을 발휘하여 사용하세요.
솔직한 부분: 이 특정 리포지토리(repo)는 아주 새롭지만, 그 이면에 담긴 아이디어는 그렇지 않습니다. Karpathy의 노트는 1월의 것이며, 다른 개발자들은 지난 4월에 동일한 관찰 내용을 바탕으로 CLAUDE.md 파일들을 만들었고 일부는 큰 인기를 끌기도 했습니다. 이것은 이미 바이럴(viral) 모멘트를 가졌던 개념의 최신 포크(fork)일 뿐입니다.
161개의 스타(stars), MIT 라이선스, 무료 오픈 소스입니다.