リビングドキュメンテーション

稼働中のシステムから生成または検証されるドキュメントで、システムの進化に合わせて正確さを保ち続けるもの。

リビングドキュメンテーションとは?

Cyrille Martraireが提唱したリビングドキュメンテーションは、ドキュメントは必ず腐るという前提を否定します。その考え方は、ドキュメントを、誰かが更新を覚えておかなければならない並行的な成果物としてではなく、コードベースの出力(抽出・生成、または継続的に検証されるもの)として扱うというものです。コードから発見されるC4モデルや、CIで強制される適合性ルールは、いずれもこの考え方の実例です。

関連用語

  • アーキテクチャ・アズ・コード — システムアーキテクチャをバージョン管理されたテキストベースの形式で記述し、ソースコードと同じようにレビュー・差分確認・検証できるようにすること。
  • アーキテクチャドリフト — ドキュメント化されたアーキテクチャと、実際に本番環境で動作しているシステムとの間に広がっていくギャップ。
  • MCPサーバー — Model Context Protocolを実装したサーバーで、AIコーディングアシスタントが標準化されたツールインターフェースを通じてプロジェクトのコンテキストを照会できるようにするもの。