일단 갖다붙였습니다. ㅋ

1. 원본 CLAUDE.md : https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md
2. 영상제작자가 커스텀한 CLAUDE.md : https://github.com/datajuny/andrej-karpathy-skills/blob/main/CLAUDE.md

이 영상은 안드레이 카파시(Andrej Karpathy)가 제안한 AI 코딩 원칙과 이를 한국어 개발 환경에 맞게 보완한 65줄짜리 CLAUDE.md 설정 파일에 대해 설명합니다. 영상의 핵심 내용은 다음과 같습니다.

1. AI의 3가지 고질병 (2:05)

* 잘못된 가정: 사용자의 의도를 묻지 않고 멋대로 해석하여 코드를 작성함.

* 코드 부풀리기: 간단한 기능도 필요 이상의 복잡한 클래스나 구조를 생성함.

* 멋대로 고치기: 요청하지 않은 주변 코드까지 임의로 수정하여 버그를 유발함.

2. 카파시의 4가지 원칙 (3:58)

* 코딩 전 먼저 생각하기: 가정하지 말고 명확하게 소통하며 의도를 파악함.

* 단순하게 먼저: 최소한의 코드로 문제를 해결하고 불필요한 추상화는 지양함.

* 외과수술처럼 정확하게: 요청받은 범위만 수정하고 기존 스타일을 준수함.

* 목표 중심으로 실행: 성공 기준을 명확히 하고 검증 가능한 테스트를 작성함.

3. 한국어 환경을 위한 5가지 추가 룰 (9:03)

* 콜론 금지: 한국어 문장 끝에 콜론 대신 마침표를 사용하여 자연스러운 출력 유도.

* 한국어 헤더 주석: 파일 상단에 해당 파일의 목적을 명시하여 AI가 문맥을 파악하기 쉽게 함.

* 계획·체크리스트·컨텍스트: 대규모 작업 시 체계적인 계획과 의사결정 기록을 활용함.

* 작업 마무리 전 테스트: 코드 작성 후 반드시 테스트를 수행하여 무결성 확인.

* 의미 단위 커밋: 한 번에 하나의 의미 있는 변경만 커밋함.

적용 방법 (11:14)

* CLAUDE.md 파일을 프로젝트 루트 혹은 홈 디렉토리~/.claude/CLAUDE.md)의 글로벌 설정에 넣어 모든 프로젝트에 적용할 수 있습니다. 작성자는 글로벌 설정을 추천합니다.