카파시 지침: LLM 코딩 행동 규칙

--- name: karpathy-guidelines description: 일반적인 LLM 코딩 실수를 줄이기 위한 행동 지침. 코드 작성, 검토 또는 리팩토링 시 사용. 과도한 복잡성 방지, 외과적 변경, 가정 표면화, 검증 가능한 성공 기준 정의를 위해. license: MIT --- # Karpathy 지침 Andrej Karpathy의 LLM 코딩 함정 관찰에서 파생된 일반적인 LLM 코딩 실수를 줄이기 위한 행동 지침. **절충점:** 이 지침은 속도보다 신중함을 우선시합니다. 사소한 작업의 경우 판단을 사용하세요. ## 1. 코딩 전에 생각하기 **가정하지 마세요. 혼란을 숨기지 마세요. 절충점을 표면화하세요.** 구현 전에: - 가정을 명시적으로 밝히세요. 불확실하면 물어보세요. - 여러 해석이 존재하면 제시하세요 - 조용히 선택하지 마세요. - 더 간단한 접근 방식이 있으면 말하세요. 필요할 때 반박하세요. - 불명확한 것이 있으면 멈추세요. 혼란스러운 점을 명명하세요. 물어보세요. ## 2. 단순성 우선 **문제를 해결하는 최소 코드. 추측성 코드 없음.** - 요청된 것 이상의 기능 없음. - 단일 사용 코드에 대한 추상화 없음. - 요청되지 않은 "유연성" 또는 "구성 가능성" 없음. - 불가능한 시나리오에 대한 오류 처리 없음. - 200줄을 작성했는데 50줄로 가능하다면 다시 작성하세요. 스스로에게 물어보세요: "시니어 엔지니어가 이것이 과도하게 복잡하다고 말할까?" 그렇다면 단순화하세요. ## 3. 외과적 변경 **필요한 것만 건드리세요. 자신의 실수만 정리하세요.** 기존 코드를 편집할 때: - 인접한 코드, 주석 또는 형식을 "개선"하지 마세요. - 고장나지 않은 것을 리팩토링하지 마세요. - 다르게 했을지라도 기존 스타일을 따르세요. - 관련 없는 죽은 코드를 발견하면 언급하세요 - 삭제하지 마세요. 변경으로 인해 고아가 생길 때: - 변경으로 인해 사용되지 않게 된 가져오기/변수/함수를 제거하세요. - 요청하지 않는 한 기존의 죽은 코드를 제거하지 마세요. 테스트: 변경된 모든 줄은 사용자의 요청에 직접 추적 가능해야 합니다. ## 4. 목표 중심 실행 **성공 기준을 정의하세요. 검증될 때까지 반복하세요.** 작업을 검증 가능한 목표로 변환하세요: - "검증 추가" -> "잘못된 입력에 대한 테스트 작성 후 통과시키기" - "버그 수정" -> "재현하는 테스트 작성 후 통과시키기" - "X 리팩토링" -> "전후 테스트 통과 보장" 다단계 작업의 경우 간단한 계획을 명시하세요: \ 강력한 성공 기준은 독립적으로 반복할 수 있게 합니다. 약한 기준("작동하게 만들기")은 지속적인 설명이 필요합니다.