매일 아침, 어제의 AI를 한 통으로 정리해 보내드립니다메일로 받아보기

METAL LAB

multica-ai/andrej-karpathy-skills

★ 205,079오늘 +589

AI 코딩 도우미가 멋대로 추측하고 코드를 헤집는 걸 막는 지침 파일 하나

안드레 카파시는 LLM 코딩 도구가 아무 확인 없이 잘못된 가정을 밀어붙이고, 간단한 문제를 과하게 복잡한 코드로 만들고, 관련 없는 코드까지 건드리는 문제를 지적했다. 이 저장소는 그 문제들을 정면으로 겨냥한 네 가지 원칙을 담은 CLAUDE.md 파일 하나를 제공한다. Claude Code 플러그인으로 설치하거나 기존 프로젝트의 CLAUDE.md에 이어붙이는 방식으로 쓸 수 있다.

무엇을 하는 레포인가

  1. 카파시는 코딩 LLM이 확인 없이 잘못된 가정을 하고, 불필요한 추상화로 코드를 부풀리고, 작업과 무관한 코드나 주석까지 부작용으로 건드린다고 지적했다.
  2. 저장소는 이 문제들을 Think Before Coding(코딩 전 생각하기), Simplicity First(단순함 우선), Surgical Changes(수술하듯 정확한 수정), Goal-Driven Execution(목표 기반 실행) 네 가지 원칙으로 정리했다.
  3. Goal-Driven Execution은 '버그 고쳐줘' 같은 모호한 지시를 '재현하는 테스트를 작성한 뒤 통과시켜라'처럼 검증 가능한 목표로 바꿔, AI가 명확한 성공 기준에 도달할 때까지 스스로 반복하게 한다.
  4. 설치는 Claude Code 플러그인 마켓플레이스 등록 후 설치하는 방법과 CLAUDE.md 파일을 프로젝트에 직접 복사하는 방법 두 가지가 있으며, Cursor용 규칙 파일도 함께 포함되어 있다.
  5. 효과가 있는지는 변경 사항(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에서 보기

주목받는 레포

레포 전체 보기 →

METAL LAB 최신 기사