karpathy-guidelines은(는) 무엇을 하나요?
AI 에이전트를 위한 보편적 행동 원칙: Karpathy의 가이드라인을 Hermes(SOUL.md)와 OpenAI Codex(skill)에 맞게 조정했습니다. 4가지 원칙으로 구성된 일반화된 프레임워크 — 행동 전 생각, 단순성 우선, 정밀한 변경, 목표 중심 실행.
소개
AI 어시스턴트가 코딩 작업을 수행할 때, 때로는 지나치게 복잡한 솔루션을 제안하거나, 작업 범위를 벗어난 변경을 시도하거나, 목표를 놓치는 경우가 있습니다. 이 스킬은 Karpathy의 원칙을 기반으로 이러한 문제를 방지하고 체계적인 접근 방식을 제공합니다.
핵심 원칙
1. 행동 전 생각 (Think Before Acting)
- 작업을 시작하기 전에 충분히 분석하고 계획을 수립합니다.
- 요청을 완전히 이해했는지 확인한 후 실행에 옮깁니다.
- 가장 간단한 해결책이 무엇인지 먼저 고민합니다.
2. 단순성 우선 (Simplicity First)
- 항상 가장 간단한 해결책을 먼저 고려합니다.
- 복잡한 추상화나 과도한 디자인 패턴을 피합니다.
- "필요한 것만" 구현하고, 미래를 대비한 과잉 엔지니어링을 하지 않습니다.
3. 정밀한 변경 (Surgical Changes)
- 최소한의 변경으로 목표를 달성합니다.
- 불필요한 리팩토링이나 스타일 변경을 피합니다.
- 변경 사항이 기존 시스템과 조화를 이루는지 확인합니다.
4. 목표 중심 실행 (Goal-Driven Execution)
- 항상 최종 목표를 염두에 둡니다.
- 작업이 목표에서 벗어나지 않도록 주의합니다.
- 각 단계가 전체 목표에 어떻게 기여하는지 평가합니다.
적용 예시
좋은 예시
사용자: "이 함수에 에러 처리를 추가해주세요."
에이전트: (함수를 분석한 후) "기존 try-catch 블록이 없군요.
가장 간단한 방법은 주요 예외를 처리하는 try-catch를
추가하고, 적절한 오류 메시지를 반환하는 것입니다."
나쁜 예시
사용자: "이 함수에 에러 처리를 추가해주세요."
에이전트: (과도한 리팩토링) "전체 함수를 재작성하고,
클래스를 도입하며, 모든 에러 타입에 대한
사용자 정의 예외 클래스를 만들겠습니다."
지원 플랫폼
- Claude Code: SKILL.md를 통해 직접 통합 가능
- Hermes: SOUL.md 형식으로 조정 가능
- OpenAI Codex: 스킬 파일로 적용 가능
- Cursor: 규칙 파일로 설정 가능
참고 문헌
- Karpathy의 원본 게시물
- Hermes SOUL.md 문서
- OpenAI Codex 가이드라인