리빙 도큐멘테이션

동작하는 시스템으로부터 생성되거나 검증되어, 시스템이 발전해도 정확성을 유지하는 문서입니다.

리빙 도큐멘테이션란?

Cyrille Martraire가 소개한 리빙 도큐멘테이션은 문서가 반드시 낡아빠질 수밖에 없다는 전제를 거부합니다. 그 아이디어는 문서를 누군가 갱신하기를 기억해야 하는 별도의 산출물이 아니라 코드베이스의 출력물(추출되거나, 생성되거나, 지속적으로 검증되는 것)로 취급하는 것입니다. 코드로부터 발견된 C4 모델과 CI에서 강제되는 적합성 규칙은 모두 이 아이디어의 사례입니다.

관련 용어

  • Architecture as Code — 시스템 아키텍처를 버전 관리되는 텍스트 기반 형식으로 기술하여, 소스 코드처럼 리뷰하고 비교하고 검증할 수 있도록 하는 것입니다.
  • 아키텍처 드리프트 — 문서화된 아키텍처와 실제로 프로덕션에서 동작하는 시스템 사이에 벌어지는 격차입니다.
  • MCP 서버 — Model Context Protocol을 구현한 서버로, AI 코딩 어시스턴트가 표준화된 도구 인터페이스를 통해 프로젝트 컨텍스트를 질의할 수 있게 합니다.