안드레아 카파시(Andrej Karpathy)가 정리한 '나중에 다시 고칠 필요 없는 코드를 작성하기 위한 10가지 규칙 ?

Karpathy의 내부 CLAUDE.md 파일이 유출되었다고 합니다. 10가지 규칙이 있다고 하는데, 아직 확인은 못 했습니다. 18만 3천 개의 별을 받은 이 저장소는 커뮤니티에서 만든 것입니다. Forrest Chang은 자신의 불만을 4가지 규칙으로 요약했는데, 그 저장소는 그의 것이 아닙니다. 4가지 규칙은 코드 작성 방법을 다루고, 10가지 규칙은 읽기 우선, 실패 테스트, 그리고 '키친 싱크'처럼 명명된 실패 모드를 추가합니다. 코딩하기 전에 저장소를 읽으세요. 수정하기 전에 실패 테스트를 작성하세요. 유출이 가짜라도 체크리스트는 훔쳐 쓰세요. 링크는 답글에 있습니다.

 

 

 

 

 

 

< 주요 10가지 수칙 >

 

1. 쓰기 전에 읽기 (Read Before You Write)
   • 기존 코드베이스를 충분히 읽고 패턴을 파악하세요. 단순히 AI가 주는 코드를 복사하지 말고, 프로젝트의 기존 스타일과 라이브러리를 따르세요.
2. 코딩 전 생각하기 (Think Before You Code)
   • 입력 전에 무엇을 할지 명확히 정의하세요. 모호한 점이 있다면 넘겨짚지 말고 질문을 통해 명확히 해야 합니다.
3. 단순성 (Simplicity)
   • 현재 문제를 해결하는 최소한의 코드만 작성하세요. "나중에 필요할까 봐" 만드는 추상화는 오버 엔지니어링입니다.
4. 정밀한 수정 (Surgical Changes)
   • 변경 사항(diff)은 가능한 작게 유지하세요. 요청받지 않은 부분은 건드리지 말고, 포맷 변경 등으로 본질적인 수정 사항을 가리지 마세요.
5. 검증 (Verification)
   • 작동하는 코드와 내가 작동한다고 '생각하는' 코드 사이의 간극을 테스트로 메우세요. 실패하는 테스트를 먼저 만들고 이를 해결하는 식으로 수정해야 합니다.
6. 목표 중심 실행 (Goal-Driven Execution)
   • 코드를 짜기 전 성공 기준을 정하세요. 여러 단계의 작업이라면 먼저 계획을 세우고 진행 상황을 확인받으세요.
7. 디버깅 (Debugging)
   • 추측하지 말고 조사하세요. 에러 메시지와 스택 트레이스 전체를 읽고, 문제를 재현한 뒤 하나씩 수정하세요.
8. 의존성 관리 (Dependencies)
   • 모든 외부 라이브러리는 내가 제어할 수 없는 영구적인 코드입니다. 꼭 필요한지 자문하고, 추가할 때는 명확한 이유를 남기세요.
9. 소통 (Communication)
   • 단순한 코드 블록이 아니라 '무엇을 왜 했는지' 설명하세요. 불확실한 부분은 솔직하게 알리고 검증을 요청해야 합니다.
10. 공통 실패 모드 (Common Failure Modes)

1. • 과도한 리팩토링, 잘못된 추상화, 예외 상황 무시 등 자주 발생하는 실수 패턴을 경계하세요.

---

한 줄 요약: AI에게 코딩을 맡길 때도 "최소한의 변경, 철저한 읽기, 명확한 검증"이라는 기본 원칙을 지키는 것이 핵심입니다.

 

 

 

 

 

https://www.aitimes.com/news/articleView.html?idxno=212236

'카르파시 AI 코딩 지침' 확산…"프롬프트에서 루프 시대로 진화" - AI타임스

 

 

https://www.youtube.com/watch?v=UNnsS03whx0