코드에 숨겨진 "왜"

코드를 보면 무엇을(What) 알 수 있다. 하지만 **왜(Why)**는 코드에 없다.

도메인 지식 문서가 있으면:

---

도메인 지식 문서 구조

---

반드시 문서화해야 할 도메인 지식

항목	예시	왜 중요한가
임계값의 근거	온도 85도, 진동 4.5mm/s	변경 시 안전 위험
에러코드 분류 기준	E-CNC-001의 의미	새 에러 추가 시 일관성
데이터 수집 주기	5분 간격의 이유	비용-정확도 트레이드오프
KG 스키마 설계 이유	왜 이 관계를 만들었나	스키마 변경 시 판단 기준
RAG 청킹 전략	왜 500토큰 청크인가	검색 품질에 직결
모델 선택 이유	왜 GPT-4o인가	비용/성능 트레이드오프

---

핵심 정리

1. 코드는 What, 도메인 문서는 Why를 말한다
2. 임계값, 분류 기준, 수집 주기의 근거를 반드시 기록한다
3. 도메인 전문가의 의견은 날짜와 출처와 함께 기록한다
4. 변경 이력을 남겨야 "왜 바뀌었는지" 추적 가능하다