에이전트 스킬·프롬프트도구/라이브러리

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.

GitHub 에서 보기 ↗카드 기준일 2026-10-31 · 처음 작성 2026-10-28 · 갱신 2026-11-02
+4,401지난 주
2.0%규모 대비 성장률
227,592누적 스타

AI 작성이 카드는 AI(Claude)가 공개 자료(README·릴리스·HN·웹 글)로 쓴 요약입니다. 사람이 검토하지 않았으며, 주장마다 출처 링크와 확인·추정 표시를 붙였습니다. 숫자는 GitHub API 값을 코드가 채웁니다.

013줄 요약

  • 무엇인지 — Andrej Karpathy가 지적한 LLM 코딩의 실패 패턴을 네 가지 원칙으로 정리해 Claude Code에 적용하는 단일 CLAUDE.md 파일이자 Claude Code 플러그인이다.
  • 왜 지금 떴나 — 이 저장소는 2026년 1월 Karpathy의 X 게시물 이후 꾸준히 주목받았다. 이후 multica-ai 조직으로 옮겨 플러그인 형태로 재포장됐고, 급등일인 2026-10-10 전후로 관련 소개 글과 SNS 후기가 다시 나오면서 관심이 되살아난 것으로 보인다.
  • 어떤 의미인지 — 코드 없이 행동 지침만으로도 에이전트가 하지 않아도 될 작업을 줄일 수 있다는 사례다. 개발자는 이 원칙을 자기 프로젝트의 CLAUDE.md나 Cursor 규칙에 맞게 골라 섞어 쓸 수 있다.

02숫자

누적 스타227,5922026-10-31
지난 주+4,401전주 2,928
규모 대비 성장률2.0%주 시작 223,191
생성01.272026년
주간 스타 · 최근 12주
12주 전10.25 주
이번 주 일별 스타 (UTC)
일 10.25토
항목값
누적 스타227,592 (2026-10-31 기준)
이번 주 증가+4,401
성장률+2% (주 시작 223,191)
AI 탭 순위누적 TOP 8위
일별 증가10-25 +562 · 10-26 +961 · 10-27 +746 · 10-28 +505 · 10-29 +495 · 10-30 +483 · 10-31 +649
급등일2026-10-10 +686 (평소의 3배)
유형 · 카테고리도구/라이브러리 · 에이전트 스킬·프롬프트 (보조: 코딩 에이전트·IDE)
확인 필요없음

03왜 지금 떴나

  • 2026-01-26 Karpathy가 X에 Claude 코딩 경험 노트를 올렸다. 모델이 잘못된 가정을 확인 없이 밀고 나가고, 코드를 과도하게 복잡하게 만들며, 이해하지 못한 코드를 부수적으로 바꾼다는 관찰이 담겼고, 이것이 저장소의 출발점이 됐다. x.com · medium.com · GitHub (확인)
  • 2026-04-12 Claude Code·OpenCode에서 이 단일 파일 스킬을 설치하고 쓰는 방법을 소개하는 YouTube 영상이 올라왔다. youtube.com (확인)
  • 2026-04-30 Augment Code가 OpenClaw 에이전트에 Karpathy 규칙을 적용한 실험 결과를 공개했다. 코드 품질은 나아지지 않았지만 검색과 파일 읽기가 줄어 더 빠르고 저렴하게 작업했다는 결론이다. augmentcode.com (확인)
  • 2026-05-03 원래 위치였던 forrestchang/andrej-karpathy-skills가 multica-ai/andrej-karpathy-skills로 리다이렉트되고, CLAUDE.md·Cursor 규칙·Claude Code 플러그인을 함께 묶어 배포한다는 분석 글이 나왔다. developersdigest.tech · notes.nicolasdeville.com (확인)
  • 2026-10-10 급등일에 맞춰 이 저장소를 Multica 조직의 Claude Code 플러그인으로 소개하는 노트가 갱신됐다. 재포장된 플러그인이 다시 노출된 것이 급등의 계기였을 가능성이 있다. notes.nicolasdeville.com · star-history.com (추정)
  • 2026-10-23 LinkedIn에 이 저장소를 써 보고 AI 코딩 방식이 달라졌다는 후기가 올라와, 급등 이후에도 확산이 이어졌다. linkedin.com (확인)

04무엇인가

LLM 코딩 에이전트는 몇 가지 반복되는 문제를 보인다. 모호한 요구를 조용히 한 가지로 해석해 그대로 진행하고, 100줄이면 될 일을 1000줄짜리 추상화로 부풀린다. 또 작업과 무관한 주석이나 코드를 건드린다. 이 저장소는 Karpathy가 X에서 지적한 이 문제들을 에이전트가 읽는 지침 파일 하나로 다룬다.

접근 방식은 네 가지 원칙이다. Think Before Coding은 가정을 드러내고, 해석이 여러 개면 제시하고, 헷갈리면 멈춰서 묻게 한다. Simplicity First는 요청받지 않은 기능, 일회성 추상화, 불필요한 설정 가능성을 금지한다. Surgical Changes는 요청과 직접 관련된 줄만 바꾸고, 자기 변경으로 생긴 미사용 코드만 지우게 한다. Goal-Driven Execution은 '버그 고쳐줘'를 '재현 테스트를 쓰고 통과시켜라'처럼 검증 가능한 목표로 바꿔, 에이전트가 스스로 반복하며 확인하게 한다.

배포 형태는 세 가지다. 첫째는 Claude Code 플러그인으로, marketplace를 추가한 뒤 /plugin install 명령으로 설치하면 모든 프로젝트에 적용된다. 둘째는 프로젝트별 CLAUDE.md로, curl로 받아 기존 파일에 덧붙인다. 셋째는 Cursor용 .cursor/rules/karpathy-guidelines.mdc 규칙이다. README는 이 지침이 속도보다 신중함 쪽으로 치우쳐 있다고 밝히고, 프로젝트별 규칙과 합쳐 쓰도록 권한다.

05비교

  • hongdosan/hongdosan-spec-driven-orchestra — Karpathy 4원칙을 grill-me, Verification Design, Handoff, Harness 등 다섯 개 스킬 중 하나로 포함하고, 강제 게이트를 둔 스펙 주도 개발 프레임워크다. 이 저장소보다 범위가 넓다. github.com (확인)
  • multica-ai/multica — 같은 작성자가 만든 프로젝트로, 재사용 가능한 스킬과 함께 코딩 에이전트를 실행하고 관리하는 플랫폼이다. 지침 파일 하나인 이 저장소와 달리 에이전트 운영 인프라를 다룬다. GitHub (확인)
  • Reddit에 공유된 무료 플랜용 변형판은 같은 원칙을 터미널과 서브에이전트가 없는 채팅 중심 환경에 맞게 고쳤다. reddit.com (확인)

06활용사례

  • Augment Code는 OpenClaw 기반 여러 에이전트 러너로 실제 PR 작업을 비교했다. 그 결과 검색과 파일 읽기, 출력 토큰이 줄었고, 대부분의 PR에서 더 빠르고 저렴했다. 반면 코드 품질 자체가 좋아지지는 않았다고 보고했다. augmentcode.com (확인)
  • Claude Code와 OpenCode에서의 설치 방법과 실제 동작을 보여주는 YouTube 튜토리얼이 있고, 같은 철학을 Verdent 같은 다른 도구로 옮기는 방법도 다룬다. youtube.com (확인)
  • Medium에 여러 CLAUDE.md 설정을 시험한 끝에 이 파일을 써 본 후기가 올라왔다. medium.com (확인)
  • Developers Digest는 이 규칙을 그대로 템플릿으로 복사하기보다, 네 범주를 자기 저장소에 옮긴 뒤 맞지 않는 부분을 지우는 '메뉴'처럼 쓰라고 권한다. developersdigest.tech (확인)
  • Claude 무료 플랜의 채팅 환경에 맞게 원칙을 고쳐 공유한 Reddit 사례가 있다. reddit.com (확인)

07한계·리스크

항목값
라이선스없음·모름
기여자7
상위 1명 기여 비중61%
지난 30일 이슈이슈 꺼짐
릴리스 주기릴리스 없음·모름
열린 이슈+PR138
  • 외부 실험에서는 비용과 시간이 줄었지만 품질 향상은 확인되지 않았다. README도 이 지침이 속도보다 신중함을 택한다고 밝힌다. 단순 작업에서는 오히려 절차가 부담이 될 수 있다. augmentcode.com · GitHub (확인)
  • 저장소가 forrestchang에서 multica-ai로 옮겨졌는데, README의 설치 명령은 여전히 forrestchang 경로의 raw URL과 marketplace를 가리킨다. 리다이렉트가 끊기면 설치가 깨질 수 있다. GitHub · notes.nicolasdeville.com · developersdigest.tech (추정)
  • 핵심 산출물이 행동 체크리스트 하나뿐이다. 모델이 개선되면 효용이 줄 수 있고, 실제로 아직 유용한지 끄는 게 나은지를 묻는 사용자 글도 있다. developersdigest.tech · reddit.com (추정)
  • README 상단에 작성자의 Multica 플랫폼 홍보가 붙어 있다. 일부 근거는 Reddit과 X 같은 본문 미수집 스니펫이어서 사용 후기의 세부 내용은 검증하지 못했다. GitHub · reddit.com · x.com · reddit.com (확인)

08변경 기록

근거