https://www.youtube.com/watch?v=xnNFexW9Wrk

1. 개요: AI 코딩의 "브레이크"가 필요한 이유

안드레이 카파시(OpenAI 공동 창업자)는 AI가 코드를 못 짜는 것이 아니라, 너무 빨리, 자신 있게, 그리고 과하게 짜는 것이 문제라고 지적합니다. CLAUDE.md는 AI에게 단순 명령이 아닌 '성공 기준'을 제시하여 스스로를 통제하게 만드는 가이드라인입니다.

2. AI의 3대 고질병 (해결하려는 문제)

AI가 코딩 시 반복하는 세 가지 주요 실수를 방지하는 데 목적이 있습니다.

• 잘못된 가정: 사용자에게 확인하지 않고 구현 방식(예: 로그인 방식 등)을 독단적으로 결정함.
• 코드 부풀리기: 간단한 기능도 불필요한 추상화나 클래스를 도입해 복잡하게 만듦.
• 멋대로 고치기: 요청하지 않은 주변 코드나 포맷팅, 주석 등을 건드려 기존 기능을 망가뜨림.

3. 카파시의 4대 코딩 원칙

① 코딩 전 먼저 생각하라 (Think Before Coding)

• 모호한 점이 있다면 가정하지 말고 사용자에게 질문할 것.
• 여러 해결책이 있을 경우 트레이드오프(장단점)를 설명하고 선택지를 제공할 것.
• 더 단순한 방법이 있다면 제안하거나 사용자의 의견에 반박할 것.

② 단순함 우선 (Simplicity First)

• 문제를 해결하는 최소한의 코드만 작성하고, 요청하지 않은 기능이나 설정을 추가하지 말 것.
• 한 번만 쓸 코드를 과하게 추상화하지 말 것.
• 200줄의 코드를 50줄로 줄일 수 있다면 다시 작성할 것.

③ 외과수술처럼 정확하게 (Surgical Accuracy)

• 요청받은 부분만 수정하고, 인접한 코드·주석·포맷팅은 개선하지 말 것.
• 기존 코드 스타일에 맞추고, 사용하지 않는 코드를 발견해도 말만 하고 직접 지우지 말 것.