설명
multica-ai/andrej-karpathy-skills는 AI 연구자 Andrej Karpathy가 LLM 코딩 보조 도구의 전형적인 실패 패턴을 분석한 글에서 도출한 4가지 원칙을 하나의 CLAUDE.md 파일로 정리한 Claude Code 스킬입니다. LLM이 코드를 작성할 때 무분별한 가정, 과도한 추상화, 범위를 벗어난 코드 수정 등 반복적으로 나타나는 문제를 사전에 차단하여 실용적이고 예측 가능한 코딩 보조 경험을 제공하는 것이 목적입니다.
첫 번째는 "코딩 전 사고(Think Before Coding)" 원칙으로, 모델이 불확실한 상황에서 가정을 숨기고 진행하는 대신 가정을 명시하거나 사람에게 먼저 질문하도록 강제합니다. 두 번째는 "단순성 우선(Simplicity First)"으로, 요청받지 않은 기능, 불필요한 추상화, 투기적 유연성을 배제하고 문제를 해결하는 최소한의 코드만 작성하도록 제한합니다. 세 번째는 "외과적 변경(Surgical Changes)"으로, 수정 범위를 요청한 코드에만 엄격히 한정하고 인접한 주석, 포맷, 관련 없는 코드를 건드리지 않도록 규율합니다. 네 번째는 "목표 주도 실행(Goal-Driven Execution)"으로, 테스트 코드나 검증 기준을 먼저 정의한 뒤 그 기준이 통과될 때까지 모델이 스스로 루프를 돌아 구현하게 하는 패턴을 권장합니다. 다섯 번째로 Cursor 지원도 포함되어 .cursor/rules 규칙 파일이 함께 제공되므로 동일한 지침을 Cursor IDE에서도 바로 활용할 수 있습니다.
코드 리뷰 시 diff에 요청과 무관한 변경이 줄어들어 PR 검토 부담이 낮아지고 불필요한 리라이트 사이클이 감소합니다. 모델이 구현을 시작하기 전에 먼저 질문을 던지기 때문에 방향이 어긋난 결과물을 받아 처음부터 다시 설명해야 하는 상황이 크게 줄어듭니다. 단일 CLAUDE.md 파일 하나로 모든 효과를 얻을 수 있어 도입 비용이 매우 낮으며, 기존 프로젝트의 CLAUDE.md에 내용을 추가하는 방식으로도 병합이 가능합니다.
이 지침은 신중함을 속도보다 우선시하도록 설계되어 있어, 오타 수정이나 단순 한 줄 변경처럼 명백히 사소한 작업에도 동일한 엄격함이 적용되면 오히려 응답이 느려질 수 있습니다. 목표 기반 실행 원칙을 충분히 활용하려면 사용자 측에서 테스트 코드나 구체적인 성공 기준을 작성하는 습관이 선행되어야 하므로, TDD에 익숙하지 않은 팀은 초기 적응 비용이 발생할 수 있습니다. 지침 자체가 메타 수준의 행동 규칙이기 때문에 매우 복잡한 멀티 파일 아키텍처 변경이나 도메인 특화 지식이 필요한 작업에서는 프로젝트 전용 지침을 별도로 추가하는 것이 권장됩니다.
스킬의 실체는 CLAUDE.md 파일 하나로, Claude Code가 세션 시작 시 자동으로 읽어 시스템 컨텍스트에 주입하는 방식으로 동작합니다. Claude Code 플러그인으로 설치하면 모든 프로젝트에 걸쳐 전역으로 적용되고, 프로젝트 루트에 직접 복사하면 해당 프로젝트에만 국소 적용됩니다. 각 원칙은 독립적인 섹션으로 구성되어 있어 필요에 따라 프로젝트 전용 규칙과 병합하거나 특정 섹션만 선택적으로 제거할 수 있습니다.
기존 코드베이스에 기능을 추가하거나 버그를 수정할 때 모델이 범위를 벗어나 관련 없는 코드까지 건드리는 문제가 반복적으로 발생하는 팀에 특히 적합합니다. 테스트 주도 개발 흐름을 이미 갖추고 있는 팀이라면 목표 주도 실행 원칙과 시너지가 높아 모델이 테스트를 통과할 때까지 자율적으로 반복 구현하는 패턴을 바로 활용할 수 있습니다. 코드 리뷰 문화가 엄격한 조직이나 오픈소스 프로젝트에서 PR 노이즈를 줄이고 변경 의도를 명확히 유지하고 싶을 때도 유용합니다.