진정한 ‘살아있는 문서’의 조건
개요
‘살아있는 문서(Living Documentation)‘는 단순히 최신 상태를 유지하는 문서가 아니다. 그것은 프로젝트의 현재 상태를 반영할 뿐만 아니라, 과거의 결정 맥락과 미래의 가능성을 내포하는 문서다.
LLM 파이프라인이 충족해야 할 3가지 조건
- 자동 감지 및 업데이트: 코드 변경을 감지하고, 영향 받는 문서를 자동으로 식별하여 업데이트한다.
- 결정 맥락 보존: 단순한 변경 로그가 아닌, ‘왜 그런 결정을 내렸는가’에 대한 추론 가능한 기록을 남긴다.
- 지식 그래프 구축: 문서 간의 관계를 명시적으로 연결하여, 사용자가 탐색을 통해 예상치 못한 통찰을 얻을 수 있게 한다.
날카로운 통찰력
대부분의 문서화 도구는 ‘정확성’에 집중한다. 하지만 진정한 살아있는 문서는 ‘정확성’보다 ‘유용성’이 더 중요하다. 가끔 부정확하더라도, 사용자가 문제를 해결하는 데 도움이 되는 문서가 완벽하게 정확하지만 아무도 읽지 않는 문서보다 가치 있다. LLM 파이프라인은 이 ‘유용성’을 최우선으로 설계되어야 한다.