「ドキュメント文化を作る」がなぜ失敗するのか
2026.06.09執筆者：DigKnow株式会社 CTO 桑原 脩
「うちはドキュメント文化を根付かせたい」——マネジメント層の口からよく聞かれるフレーズです。けれど半年経つ頃にはたいてい、最初の熱量は薄れ、書き手は数人に固定され、新しいページは月に数本という静かな状態に戻っています。「文化が定着しなかった」と総括され、次の半期にまた同じ号令がかかる。なぜ毎回同じ結末をたどるのでしょうか。
「文化」という言葉が議論を止めている
ドキュメント運用がうまくいかない組織で「ドキュメント文化を作ろう」という号令がかかるとき、その言葉はだいたい便利な蓋として機能しています。
書かれない原因は、本当はもっと具体的です。誰の業務時間にドキュメント執筆が含まれていないのか、書いた人が評価される仕組みになっているか、書いたものを誰が読むことになっているのか——こうした設計上の問いは、答えるのに時間がかかります。「文化」という言葉は、その面倒な問いをまとめて一つの抽象に押し込んでくれる。
「文化を作る」と言った瞬間、議論は一段階ふわっとします。「啓蒙が足りない」「意識を変えていく必要がある」「リーダーが手本を示そう」——どれも反対しにくく、どれも具体的な打ち手にはなりません。打ち手にならないからこそ、半年後の振り返りでも同じことを言える。文化という言葉は、検証コストを払わなくて済むぶん、何度でも繰り返し使える便利な仮説になっているわけです。
文化という言葉そのものに意味がない、と言いたいのではありません。組織における文化は実在します。ただしそれは抽象的な「空気」ではなく、現場の一人ひとりが日々下している小さな選択の連鎖として実在しています。号令だけがあって、その連鎖を成立させる設計がないとき、文化はいつまでも「醸成中」のままになる。私自身、過去に同じ号令をかけてきたので、これは自戒の側が強い指摘です。
文化醸成が崩れる三つの構造
「文化を作ろう」という試みが頓挫するパターンは、いくつかに類型化できます。私が観察してきた範囲では、少なくとも次の三つは繰り返し見てきました。
①書く時間が業務時間に組み込まれていない
「業務の合間に書こう」というのは、ほぼ「書かないでいい」と同じです。実装・レビュー・障害対応・ミーティングで一日が埋まる現場で、合間という余白は構造的に存在しません。書く時間を業務として明示的に確保しないかぎり、書く行為は常に「やったほうがいいけど後回し」のカテゴリに留まり続けます。
②書いた人が評価されない
評価の場面では「実装した機能の数」「対応したインシデント」といった目に見える成果が優先されがちで、書いたドキュメントが半期評価で言及される組織は実は多くありません。書く側にとってこれは「やってもやらなくても変わらない」という強烈な学習になります。一度この学習が定着すると、号令をいくらかけても行動は戻りません。
③書いたものが読まれた手応えがない
書き手が一番疲れるのは、書く時間そのものではなく、書いたあとに何も起こらないことです。誰かが質問してきたとき、ドキュメントを開かずにSlackで直接聞いてくる。この経験が累積すると、書き手の内側で静かに諦めが育っていきます。
これら三つは、どれも「文化の問題」ではありません。業務設計・評価設計・読まれる経路の設計という、もっと具体のレイヤーの話です。文化という言葉でまとめた瞬間、これらが一つの抽象に押し込まれて、個別に手を打てなくなります。
「強い書き手」依存と、AI時代に悪化する戦略の限界
文化醸成がある程度うまくいっているように見える組織にも、別の脆弱性が潜んでいます。一部の強い書き手に文化全体が支えられているケースです。
どの組織にも、書くことが好きで、忙しくても何かしら書き残してくれる人がいます。組織にとって本当にありがたい存在です。ただ、文化がその人個人の習性で支えられているとき、その人がチームを抜けた瞬間に文化は急速に消えます。「ドキュメントが充実している」と評判だったチームが、キーパーソンの転職を境に静かになる光景は珍しくありません。「ドキュメントを書く文化」が一人の書き手に依存しているなら、それは文化と呼ぶには細い。組織の能力ではなく個人の能力で、いつかその個人と一緒にいなくなります。
ここまでの構造はAI以前から存在していました。ただ、AIコーディングが日常になった現在、「文化醸成で乗り切る」という戦略はさらに分が悪くなっています。
理由は二つあります。一つは、書くべき対象の量が増えたこと。実装速度が上がるほど、設計の意図、トレードオフ、AIに採用させた選択肢の理由——ドキュメントとして残すべきことの総量は増えていきます。書き手の数は変わらないのに、書く対象だけが増えていく。文化醸成は時間のかかる施策ですが、その時間が稼げないペースでコードのほうが先に進んでしまう。もう一つは、書き手の中に「なぜ」がそもそも残っていないことが増えたことです。AIとの対話で生まれたコードについて、書いた本人が三週間後に細部の理由を即答できないというのは、もはや珍しい現象ではありません。文化が育つには、書き手の中にまず書くべき内容が言語化された状態で存在している必要があります。AIコーディングは、その前提を静かに崩しています。
意思を強くしても書ききれない量があり、意思を強くしても言語化しきれない不確実さがある。文化醸成という戦略の有効性そのものが、AI以後の開発スピードに合わなくなりつつある——というのが、現場で起きていることの本質に近い気がしています。AIがコードを10倍速く書く世界で実装と理解の速度差がどう深刻な乖離になっているかについては、今後の記事で改めて掘り下げていく予定です。
文化に頼らない設計はあるか
文化醸成を否定したいわけではありません。書きたい人が書きやすい環境、書いた人が評価される設計、書いたものが読まれるフロー——これらを整えていくことは、長期的には組織の地力になります。否定すべきは「文化を作ろう」という号令だけで実態が変わると期待することであって、文化形成への投資そのものではない。
そのうえで、Phase 1の最後の問いとして置きたいのはこれです。そもそも、文化に依存せずにドキュメント相当のものが残る設計は、本当に不可能なのでしょうか。
書くという行為は、書き手の意思とコストの上に成り立っています。意思とコストは、文化醸成という長い投資でしか動かしにくい変数です。だとすれば、別の道を探す価値はあります。意思とコストに頼らずに、開発過程でほぼ自動的に発生している情報——コミット履歴、PRの議論、AIとの対話ログ、テストコードの形——を素材として、ドキュメント相当の構造を復元できないか。これは技術側の問いです。この問いに何ができて、何ができないかについては、今後の記事で正面から扱う予定です。
まとめ
「ドキュメント文化を作ろう」という号令は、半年後にはほぼ確実に「文化が定着しなかった」という総括に行き着きます。原因は文化という言葉の便利さそのものにある。それは、書く時間が業務に組み込まれていない・書いた人が評価されない・書いたものが読まれない、という具体の設計問題を一つの抽象に押し込んでしまうのです。さらに文化醸成がうまくいっているように見える組織でも、強い書き手の個人習性に依存していることは多く、その人が抜けた瞬間に消える。AIコーディング時代には書くべき量と「なぜ」の言語化困難さが両方上がり、文化醸成という戦略の有効性そのものが落ちています。文化を脇に置いて、具体のレイヤーで設計をやり直すしかありません。
あなたのチームの「ドキュメント文化」は、誰が抜けたら消えますか。一人の名前を思い浮かべられたなら、それはおそらく文化ではなく、その人個人の能力です。次回からは視点を一段ずらして、書かれるべきドキュメントの中身そのもの——「2025年の仕様書はコードから読み取るべきものになりつつあるのか」「フローチャートやシーケンス図は誰のために書くのか」を順を追って問い直していきます。