📋가이드
카파시 스타일 Claude Code 가이드라인 - AI 코딩의 4가지 핵심 원칙
안드레 카파시가 제시한 LLM 코딩의 문제점을 해결하는 4가지 원칙과 실전 활용법
↗ 원본 링크#Claude#AI코딩#카파시#프롬프트엔지니어링
개요
안드레 카파시가 지적한 LLM 코딩의 문제점을 해결하는 CLAUDE.md 가이드라인이 공개되었습니다. 이 가이드는 Claude Code 플러그인으로도 제공됩니다.
LLM 코딩의 주요 문제점
카파시가 지적한 LLM의 전형적인 문제들:
▸
잘못된 가정으로 돌진: 명확화 없이 추측으로 진행
▸
과도한 복잡성: 100줄로 될 코드를 1000줄로 작성
▸
불필요한 추상화: 단일 사용 케이스에 과도한 유연성 추가
▸
죽은 코드 방치: 정리되지 않은 코드 누적
4가지 핵심 원칙
1. 코딩 전에 생각하세요
▸불확실하면 추측하지 말고 **물어보기**
▸모호함이 있으면 여러 해석을 **명시적으로 제시**
▸혼란스러우면 멈추고 무엇이 불분명한지 **말하기**
2. 단순함이 먼저입니다
▸요청받은 것만 해결하는 **최소한의 코드**
▸단일 사용에 대한 **추상화 없음**
▸요청받지 않은 **유연성 추가 금지**
▸불가능한 시나리오에 대한 **불필요한 에러 처리 없음**
3. 외과적 변경
▸건드려야 할 것**만** 건드리기
▸인접 코드 "개선" 금지
▸깨지지 않은 것은 **리팩터링 하지 않기**
▸관련 없는 죽은 코드는 **말만 하고 삭제하지 않기**
4. 목표 주도 실행
Before (명령형):
▸"유효성 검사를 추가하세요"
After (목표 중심):
▸"잘못된 입력에 대한 테스트를 작성하고, 통과시켜라"
성공 기준을 정의하고, 검증될 때까지 루프를 도는 방식입니다.
핵심 인사이트
> "LLM은 특정 목표를 달성할 때까지 루프를 도는 데 탁월합니다. 무엇을 할지 말하지 말고, 성공 기준을 주고 지켜보세요."
명령어가 아니라 검증 가능한 목표를 제공하는 것이 LLM을 제대로 활용하는 방법입니다.
Claude Code 플러그인 설치
bash
/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills실전 활용 팁
이 4원칙은 AI뿐만 아니라 좋은 개발자의 원칙이기도 합니다:
▸코딩 전에 요구사항 명확히 하기
▸최소한으로 단순하게 작성하기
▸요청 범위 밖은 건드리지 않기
▸테스트로 성공을 정의하기
특히 멀티 에이전트나 서브에이전트 패턴에서는 검증 가능한 성공 기준 없이는 루프가 발산하기 쉽습니다. 컨텍스트 관리와 함께 사용하면 매우 강력한 효과를 볼 수 있습니다.
마무리
AI를 더 잘 사용하고 싶다면, 결국 더 명확하게 생각하는 연습이 필요합니다. 이것이 카파시 스타일 가이드라인이 가르쳐주는 핵심입니다.