Karpathy-Inspired Claude Code Guidelines

어떤 도구인가요?

Claude Code가 코드를 짤 때 흔히 저지르는 실수를 줄여주는 행동 지침 모음입니다. OpenAI 공동 창업자이자 테슬라 AI 책임자였던 Andrej Karpathy(앤드레이 카파시)가 X에 올린 "LLM 코딩의 약점" 관찰을 바탕으로, Forrest Chang(@jiayuan_jy)이 4가지 핵심 원칙으로 정리한 단일 CLAUDE.md 파일입니다.

CLAUDE.md는 Claude Code가 프로젝트를 열 때마다 자동으로 읽는 "지시사항 파일"입니다. 이 도구는 그 안에 넣을 4개 원칙(생각 후 코딩 / 단순함 우선 / 외과적 수정 / 목표 기반 실행)을 미리 작성해서 제공합니다. 한 명령어로 플러그인으로 설치하거나, 한 파일을 받아서 프로젝트 루트에 두기만 하면 끝입니다.

GitHub 별 97k 이상으로 빠르게 입소문을 탔는데, 실제 내용물은 텍스트 가이드라인 한 페이지가 전부입니다. Karpathy의 이름값과 더불어, "AI한테 일 시킬 때 답답해지는 지점"을 정확히 짚어낸 게 인기 비결입니다.

왜 추천하나요?

혼자 빌딩하다 보면 Claude가 요청한 기능 외에 다른 코드까지 "정리하면서" 바꿔서 어디가 깨졌는지 추적이 어려워지거나, 간단한 기능 하나에 코드 1000줄을 만들어버리는 일을 자주 겪습니다. 이 가이드는 그런 행동을 명시적으로 차단합니다. 비슷한 가이드 모음 중에서도 분량이 압도적으로 짧고(전체 4쪽 미만), 한 번에 적용하기 쉬운 게 장점입니다.

• 요청 외 수정 차단: "주변 코드 정리/리팩토링 금지, 스타일이 마음에 안 들어도 그대로 따라가라"를 명시
• 과복잡한 코드 차단: "200줄짜리를 50줄로 쓸 수 있으면 다시 써라", "안 쓸 추상화 만들지 마라"
• 무작정 가정 차단: 모호하면 묻고, 해석이 여러 개면 다 보여주고, 더 단순한 방법이 있으면 반박하라
• 검증 가능한 목표 만들기: "기능 추가해줘" 같은 모호한 지시를 "잘못된 입력 테스트를 먼저 쓰고 통과시켜라"로 변환
• 즉시 적용: 한 명령어 또는 한 파일로 설치 끝, 다른 도구와 충돌 없음

Vuild에 이미 등록된 Superpowers가 TDD/디버깅/브레인스토밍까지 다루는 광범위한 워크플로우 패키지라면, 이건 "Claude의 행동 결을 다듬는 4가지 룰"만 깔끔하게 추가하는 가벼운 가이드입니다. 두 도구를 함께 써도 서로 충돌하지 않습니다.