수백만 달러를 들여 학습시킨 거대 언어 모델(LLM)이 개발자의 의도를 완벽히 파악하지 못해 쩔쩔맬 때, 단 65줄짜리 텍스트 파일 하나가 그 해결책이 될 수 있을까요?
최근 GitHub에서 하루 만에 스타 400개가 급증하며 총 4,000개를 돌파한 화제의 파일이 있습니다. 바로 AI 코딩 도구에게 "제발 생각 좀 하고 코딩해"라고 일침을 가하는 가이드라인, CLAUDE.md (또는 andrej-karpathy-skills)입니다.
🚀 현상의 시작: 카파시의 날카로운 지적
이 프로젝트는 테슬라의 전 AI 책임자이자 유명 AI 연구자인 **안드레이 카파시(Andrej Karpathy)**의 트윗에서 영감을 받았습니다. 그는 현재의 LLM 코딩 도구들이 가진 고질적인 문제점을 다음과 같이 꼬집었습니다.
- 사용자를 대신해 멋대로 가정을 내림
- 혼란스러운 상황에서 명확한 질문을 던지지 않음
- 코드 간의 불일치를 찾아내지 못함
- 트레이드오프(Trade-off)를 제시하거나 사용자에게 반박하지 않음
누군가 이 날카로운 통찰을 4가지 핵심 원칙으로 정리해 마크다운 파일로 만들었고, 이것이 개발자들 사이에서 폭발적인 반응을 얻은 것입니다.
🛠️ 65줄에 담긴 4가지 핵심 원칙
이 가이드라인의 핵심은 AI가 '무지성'으로 코드를 뱉어내는 대신, 숙련된 엔지니어처럼 행동하게 만드는 데 있습니다.
1. Think Before Coding (코딩 전 생각하기)
AI에게 가정을 명시하도록 강제합니다. 만약 지시사항이 불확실하다면 멋대로 추측하지 말고 사용자에게 다시 물어봐야 하며, 논리적 혼란이 생기면 즉시 멈추도록 설계되었습니다.
2. Simplicity First (단순함 우선)
많은 AI 모델이 요청하지도 않은 복잡한 추상화나 에러 처리 로직을 추가하곤 합니다. 이 원칙은 과잉 엔지니어링을 막고, 딱 필요한 만큼의 코드만 작성할 것을 요구합니다.
3. Surgical Changes (정밀한 수정)
전체 코드를 리팩토링한답시고 관련 없는 부분까지 건드려 버그를 만드는 '부작용'을 최소화합니다. 오직 요청된 부분만 정밀하게 타격하여 수정하도록 유도합니다.
4. Goal-Driven Execution (목표 중심 실행)
단순히 "이 기능을 추가해줘"라는 모호한 명령 대신, **"이 테스트 케이스가 통과하게 만들어"**와 같이 검증 가능한 목표를 중심으로 작업하게 합니다.
💻 실무 적용 방법: 프로젝트에 이식하기
이 가이드라인을 사용하는 방법은 매우 간단합니다. 프로젝트 루트 디렉토리에 지침이 담긴 파일을 위치시키거나, 전용 확장 도구를 사용하면 됩니다.
# 예시: CLAUDE.md 또는 .cursorrules의 일부 내용
## 핵심 행동 강령
- 코드를 수정하기 전에 반드시 '생각' 과정을 출력할 것.
- 가정이 필요한 부분은 질문으로 남길 것.
- 불필요한 라이브러리 도입이나 추상화를 지양할 것.
- 기존 스타일과 일치하지 않는 코드는 작성하지 말 것.현재 이 가이드라인은 Cursor의 .cursorrules 설정이나 Claude Code의 플러그인 형태로 활발히 포팅되어 사용되고 있습니다.
🤔 과연 진짜 효과가 있을까?
흥미로운 점은 이 파일을 직접 사용해본 개발자들 사이에서도 의견이 갈린다는 것입니다. 네덜란드의 개발자 Michiel Beijen은 "코드 변경을 더 신중하게 하는 것 같긴 하지만, 결과물이 압도적으로 나은지는 확신할 수 없다"고 고백하기도 했습니다.
이는 LLM의 비결정적(Non-deterministic) 특성 때문입니다. 똑같은 프롬프트를 줘도 매번 결과가 다르기에, 65줄의 텍스트가 마법 같은 해결책인지 아니면 일종의 '플라시보 효과'인지 단정 짓기 어렵습니다.
하지만 4,000명이 넘는 개발자가 이 프로젝트에 열광한 이유는 분명합니다. 우리가 AI에게 원했던 것은 단순히 '빠른 타이핑'이 아니라, '함께 고민하는 동료' 의 모습이었기 때문입니다.
📝 마치며
거대 모델의 한계를 단 몇 줄의 텍스트 가이드라인으로 보완하려는 시도는 프롬프트 엔지니어링이 단순한 기술을 넘어 하나의 '철학'으로 진화하고 있음을 보여줍니다.
여러분의 프로젝트에도 이 '65줄의 마법'을 적용해 보세요. 어쩌면 여러분의 AI 비서가 오늘부터 조금 더 똑똑하게 질문을 던지기 시작할지도 모릅니다.
참고 링크: