docs: add Karpathy LLM coding guidelines to AI 작업 지침

생각 먼저, 단순함 우선, 외과적 수정, 목표 중심 실행 원칙 추가.
Source: https://youtu.be/tcDoacn64Lo

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
joungmin
2026-02-28 10:01:07 +09:00
parent 624e5fd7d9
commit 0a0b288740

View File

@@ -5,6 +5,19 @@
---
## 세션 시작 시 필수 작업
**매 세션 시작 시, 반드시 Obsidian 메모리를 읽어 이전 컨텍스트를 복원하세요.**
```
Obsidian 노트 경로: 50 Meta/Claude Memory/CONTEXT.md
```
이 파일에는 진행 중인 작업, 통합 설정, 사용자 환경 등 세션 간 유지해야 할 모든 정보가 담겨 있습니다.
작업 완료 후에는 변경 사항을 해당 파일에 업데이트하세요.
---
## 프로젝트 개요
| 항목 | 내용 |
@@ -750,6 +763,30 @@ alias cc-standup='claude -p "Redmine 내 이슈와 Jenkins 빌드 상태를 가
7. **자기 검증**: 구현 완료 후 직접 테스트 실행하여 결과 확인
8. **실수 기록**: 오류 발생 시 CLAUDE.md의 '자주 하는 실수 목록' 즉시 업데이트
### Karpathy 코딩 가이드라인
> Andrej Karpathy가 X에 공유하고 GitHub에서 큰 반향을 일으킨 LLM 코딩 원칙.
> 복잡한 모델 개선보다 이 간단한 컨텍스트 규칙이 코드 생성 품질을 더 크게 높인다.
> 출처: https://youtu.be/tcDoacn64Lo
**원칙 1 — 코딩 전에 먼저 생각하라**
- 가정을 명시하고, 불확실하면 물어보고, 혼란스러우면 멈춰라
- 추측하지 말고 장단점을 명확히 드러내라
**원칙 2 — 단순함이 최우선이다**
- 200줄로 작성했는데 50줄로 줄일 수 있다면 다시 써라
- 요청받지 않은 기능·추상화·에러 처리를 추가하지 말 것
**원칙 3 — 외과적 수정만 하라**
- 기존 코드 수정 시 주변 코드·주석·포맷을 임의로 개선하지 않는다
- 고장나지 않은 부분은 리팩터링하지 않는다
- 본인 방식이 더 낫다고 생각해도 기존 스타일을 따른다
- 관련 없는 문제 코드를 발견해도 삭제하지 말고 언급만 할 것
**원칙 4 — 목표 중심으로 실행하라**
- 기능 추가가 아니라 테스트가 통과하는 것이 목표다
- 요청된 것만 바꿔라
---
## 팀 연락처