multica-ai/andrej-karpathy-skills
AI 코딩 도우미가 멋대로 추측하고 코드를 헤집는 걸 막는 지침 파일 하나
안드레 카파시는 LLM 코딩 도구가 아무 확인 없이 잘못된 가정을 밀어붙이고, 간단한 문제를 과하게 복잡한 코드로 만들고, 관련 없는 코드까지 건드리는 문제를 지적했다. 이 저장소는 그 문제들을 정면으로 겨냥한 네 가지 원칙을 담은 CLAUDE.md 파일 하나를 제공한다. Claude Code 플러그인으로 설치하거나 기존 프로젝트의 CLAUDE.md에 이어붙이는 방식으로 쓸 수 있다.
무엇을 하는 레포인가
- 카파시는 코딩 LLM이 확인 없이 잘못된 가정을 하고, 불필요한 추상화로 코드를 부풀리고, 작업과 무관한 코드나 주석까지 부작용으로 건드린다고 지적했다.
- 저장소는 이 문제들을 Think Before Coding(코딩 전 생각하기), Simplicity First(단순함 우선), Surgical Changes(수술하듯 정확한 수정), Goal-Driven Execution(목표 기반 실행) 네 가지 원칙으로 정리했다.
- Goal-Driven Execution은 '버그 고쳐줘' 같은 모호한 지시를 '재현하는 테스트를 작성한 뒤 통과시켜라'처럼 검증 가능한 목표로 바꿔, AI가 명확한 성공 기준에 도달할 때까지 스스로 반복하게 한다.
- 설치는 Claude Code 플러그인 마켓플레이스 등록 후 설치하는 방법과 CLAUDE.md 파일을 프로젝트에 직접 복사하는 방법 두 가지가 있으며, Cursor용 규칙 파일도 함께 포함되어 있다.
- 효과가 있는지는 변경 사항(diff)이 요청한 부분에만 국한되는지, 과도하게 복잡한 코드를 다시 짜는 일이 줄었는지, 실수 후가 아니라 구현 전에 확인 질문이 오는지로 판단한다.
왜 중요한가
AI 코딩 에이전트를 매일 쓰는 사람이라면 카파시가 지적한 문제들, 즉 조용한 오판, 비대해진 코드, 원치 않는 수정을 그대로 겪게 되므로 붙여넣기만 하면 되는 지침 파일은 검토 부담과 값비싼 실수를 줄이는 손쉬운 방법이 된다. 이 저장소가 별 205,079개를 받았다는 점은 Claude Code나 Cursor로 실무 작업을 하는 개발자들 사이에서 관심이 크다는 것을 보여준다.
이 레포의 용어
- CLAUDE.md · Claude Code가 프로젝트를 다룰 때 참고하는 지침 텍스트 파일
- Claude Code · Anthropic이 만든 터미널 기반 AI 코딩 에이전트 도구
- Cursor · AI 코드 자동완성 및 에이전트 기능이 내장된 코드 에디터
- Goal-Driven Execution · 모호한 지시 대신 검증 가능한 성공 기준을 제시해 AI가 스스로 반복 시도하게 하는 방식
레포 원문 소개 (영문)
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
GitHub에서 보기관련 기사
주목받는 레포
- vorssaint/vorssaint-utils메뉴바 아이콘 하나로 유료 맥 앱 열 개 값을 대신하는 오픈소스 도구
- Alishahryar1/free-claude-code코딩 AI 에이전트를 무료 모델 49곳에 자유롭게 연결해주는 로컬 프록시
- freestylefly/awesome-gpt-image-2GPT-Image2로 원하는 이미지를 정확히 뽑아내는 프롬프트 설계도 532개를 모아놓은 저장소
- block/buzz사람과 AI 에이전트가 같은 채팅방에서 함께 일하는 오픈소스 협업 플랫폼
- NousResearch/hermes-agentNous Research가 만든, 쓰면 쓸수록 스스로 똑똑해지는 AI 에이전트 Hermes
- virgiliojr94/book-to-skill기술서 PDF를 AI 에이전트가 언제든 펼쳐볼 수 있는 '스킬'로 바꿔주는 도구
- VoltAgent/awesome-agent-skillsAI 코딩 도구가 특정 작업을 '전문가처럼' 하도록 도와주는 매뉴얼 1000개 이상을 한곳에 모았다
- anthropics/claude-plugins-community누구나 만든 Claude 확장 기능을 한곳에 모아 설치하게 해주는 저장소