'C4' (1)

Foundations - 04. 아키텍처 문서화

건축 도면이 거짓말이 되는 순간 — 아키텍처 문서화건축가가 집을 지을 때 도면을 그린다. 대지 평면도로 전체를 보고, 층별 평면도로 층을, 방 상세도로 디테일을 본다. 도면은 집을 이해하고 소통하는 도구다. 하지만 도면이 집 그 자체는 아니다. 현장에서 벽을 하나 허물고 도면을 안 고치면, 도면은 거짓말이 된다. 6개월 뒤 새 직원이 그 도면을 보고 집을 이해하려다 포기한다 — 도면 속 "거실"은 이미 침실로 바뀌어 있는데 도면엔 옛날대로 그려져 있으니까.소프트웨어 아키텍처 문서도 같다. 한때 정확했던 상자-화살표 그림이, 코드가 바뀌어도 안 고쳐지면 거짓말이 된다. 그렇다고 문서를 포기하면 결정의 이유가 사라지고 매번 같은 논쟁이 반복된다. 문제는 "문서를 쓸까 말까"가 아니라 "무엇을, 어떻게 기록하..