💡 학습 개념 정의

• 핵심 키워드: KISS, YAGNI, DRY, 코드 설계 원칙, 과설계 경계
• 한 줄 정의: 코드를 단순하게(KISS), 필요할 때만 만들고(YAGNI), 반복을 줄이되(DRY) 세 원칙이 서로 충돌할 땐 맥락으로 균형을 잡는 설계 지침.

📝 상세 학습 내용

1. 도입 배경 (Why?)

• 코드를 짜다 보면 "지금 당장은 안 쓰지만 나중에 필요할 것 같아서" 미리 구조를 만들거나, "비슷해 보이니까" 공통 함수로 묶고 싶은 충동이 든다.
• 이런 충동을 따라가면 코드가 복잡해지고, 정작 미래에 그 가정이 틀리면 만든 구조를 도로 풀어야 한다. 과설계(over-engineering)다.
• KISS·YAGNI·DRY는 이 충동을 다스리는 세 가지 지침이다. 다만 셋은 종종 서로 충돌하므로, 외우는 것보다 "언제 어떤 걸 우선할지"를 아는 게 핵심이다.

2. 핵심 원리 및 특징 (What?)

• KISS (Keep It Simple, Stupid): 가능한 한 단순하게 유지하라. 영리하고 복잡한 해법보다, 읽고 이해하기 쉬운 단순한 해법이 낫다. "이 코드를 6개월 뒤의 내가 봐도 바로 이해하는가"가 기준.
• YAGNI (You Aren't Gonna Need It): 지금 필요하지 않은 건 만들지 마라. "나중에 쓸 것 같아서" 미리 만드는 추상화·옵션·확장점은 대부분 안 쓰이거나, 쓰일 때쯤엔 가정이 틀려 있다.
• DRY (Don't Repeat Yourself): 같은 지식을 두 곳에 두지 마라. 한 사실(상수, 로직)이 여러 곳에 복제되면, 하나만 고치고 나머지를 잊어 어긋난다.
• 세 원칙의 긴장 관계: DRY를 과하게 적용하면 "비슷해 보이는" 코드를 억지로 묶어 복잡한 추상화가 생기고(KISS 위반), 그 추상화가 미래를 가정하면 YAGNI 위반이 된다. 반대로 YAGNI만 좇으면 중복이 쌓인다. 그래서 "지식의 중복(DRY가 막아야 할 것)"과 "우연히 닮은 코드(묶으면 안 되는 것)"를 구분하는 게 중요하다.

3. 실제 활용 예시 (How?)

// ❌ YAGNI 위반 — "나중에 여러 모델 쓸지도 모르니" 미리 추상화
class LLMProvider {
  constructor(private config: ProviderConfig) {}
  async call(opts: CallOptions) { /* 복잡한 분기 */ }
}
// 지금 쓰는 모델은 하나뿐인데 확장을 가정한 구조 → 안 쓰일 복잡도
 
// ✅ KISS + 딱 필요한 DRY — 모델명만 한 곳에
// lib/ai.ts
export const GEMINI_MODEL = 'gemini-2.5-flash';
export const geminiFlash

// DRY를 언제 적용할지 — "두 번째 중복"을 기다린다
// 1단계에서 구조화 출력 호출을 한 번 작성.
// "2·3단계도 비슷할 것 같으니" 지금 헬퍼로 빼고 싶은 충동 →
// 참는다. 3단계는 tool calling이 들어가 형태가 달라질 수 있다(가정이 틀림).
// 2단계를 실제로 만들었을 때 1·2가 '진짜로' 같으면, 그때 헬퍼로 추출.
// → 추측이 아니라 실적으로 공통화.

🔍 심화 학습 (Deep Dive)

• Q. DRY와 YAGNI가 충돌하면 뭘 우선하나? A. 대개 YAGNI다. 중복은 나중에 합치기 쉽지만, 잘못 만든 추상화는 풀기 어렵다. "중복 두 줄"이 "안 맞는 추상화 한 개"보다 싸다. Sandi Metz의 말처럼 "잘못된 추상화보다 중복이 낫다(duplication is far cheaper than the wrong abstraction)."
• Q. 그럼 DRY는 언제 적용하나? A. 같은 "지식"이 중복될 때. 모델명, 설정값, 비즈니스 규칙처럼 "바뀌면 모든 곳이 같이 바뀌어야 하는 사실"의 중복은 DRY로 막는다. 반면 "우연히 코드 모양이 닮은 것"은 DRY 대상이 아니다. 핵심 질문: "이 둘은 항상 같이 바뀌는가, 아니면 지금만 우연히 닮았는가?"
• Q. KISS의 '단순함'은 코드 길이가 짧은 건가? A. 아니다. 줄 수가 아니라 이해 비용이다. 영리한 한 줄(축약된 정규식, 중첩 삼항)이 풀어 쓴 다섯 줄보다 복잡할 수 있다. "짧음"이 아니라 "읽고 바로 이해됨"이 KISS다.
• Q. 미래 확장을 아예 고려하지 말라는 건가? A. 그건 아니다. 확장 "지점"을 열어두는 것과, 확장을 미리 "구현"하는 것은 다르다. 예: 함수에 콜백 파라미터 자리만 열어두고(저렴) 실제 스트리밍은 나중에 구현(YAGNI). 비용이 거의 없는 확장점은 열어도 되지만, 무거운 추상화는 필요해질 때 만든다.

📌 오늘의 핵심 요약

• KISS(단순하게)·YAGNI(필요할 때만)·DRY(지식 중복 금지)는 과설계를 막는 세 지침이다.
• 셋은 충돌한다. 충돌 시 대개 YAGNI 우선 — 잘못된 추상화보다 중복이 싸다.
• DRY는 "지식의 중복"에만 적용하고, "우연히 닮은 코드"는 묶지 않는다. 공통화는 추측이 아니라 두 번째 중복이 실제로 나타났을 때.
• 단순함은 줄 수가 아니라 이해 비용. 확장은 "지점만 열고" 구현은 미룬다.