multica-ai/andrej-karpathy-skills — A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Andrej Karpathy의 관찰을 바탕으로 Claude Code의 코딩 실수를 줄이는 지침
Claude Code에 적용하는 지침 파일로, LLM의 성급한 추측과 과도한 구현, 불필요한 주변 코드 수정 문제를 다룹니다. 명확화 질문, 최소 변경, 테스트로 확인하는 성공 기준 등 네 가지 원칙을 제시하고 플러그인 또는 프로젝트별 CLAUDE.md로 설치하는 방법을 안내합니다.
- 주제
AI 요약
저장소는 Andrej Karpathy가 지적한 LLM 코딩의 문제를 줄이기 위한 지침을 단일 파일로 제공합니다. 모델이 모호한 요구를 임의로 해석하거나, 필요 이상으로 코드를 복잡하게 만들거나, 요청과 무관한 코드까지 수정하는 상황을 줄이는 데 초점을 둡니다.
네 가지 원칙
‘Think Before Coding’은 불확실한 부분을 추측하지 말고 가정을 밝히며, 해석이 여럿이면 각각 제시하고 필요할 때 사용자에게 질문하도록 합니다. ‘Simplicity First’는 요청하지 않은 기능이나 단일 용도 추상화, 불필요한 설정 가능성을 추가하지 말고 문제를 푸는 데 필요한 최소 코드만 작성하라고 권합니다.
‘Surgical Changes’는 요청과 직접 관련된 부분만 수정하도록 합니다. 기존 코드의 인접한 주석이나 형식을 임의로 개선하지 않고, 기존의 미사용 코드도 요청 없이 삭제하지 않습니다. 다만 이번 변경으로 사용되지 않게 된 import, 변수, 함수는 정리합니다. 수정한 각 줄이 사용자 요청과 연결되어야 한다는 기준을 둡니다.
‘Goal-Driven Execution’은 작업 지시를 확인 가능한 성공 조건으로 바꾸고, 검증을 통과할 때까지 반복하도록 합니다. 예를 들어 버그 수정은 재현 테스트를 먼저 작성하고 통과시키며, 리팩터링은 변경 전후 테스트를 확인합니다. 여러 단계로 이뤄진 작업은 단계별 계획과 검증 방법을 함께 적도록 권합니다.
설치와 적용
Claude Code에서는 플러그인 마켓플레이스를 추가한 뒤 andrej-karpathy-skills 플러그인을 설치합니다. 프로젝트별 적용을 원하면 새 프로젝트의 CLAUDE.md로 지침을 내려받거나 기존 파일 끝에 덧붙일 수 있습니다. 저장소에는 Cursor용 규칙 파일도 포함되어 있습니다. 이 지침은 프로젝트별 규칙과 함께 사용할 수 있으며, 사소한 오타 수정처럼 단순한 작업에는 매번 전체 절차를 적용하지 말고 상황에 맞게 판단하라고 명시합니다.
원문: GitHub / 번역·요약: Trawling