Skip to content

ドキュメントの共同執筆が難しいのは、調整コストが不可視だから

   
ドキュメントの共同執筆が難しいのは、調整コストが不可視だからのGPT生成本文インフォグラフィック

Wikipediaは、数えきれない人数で書かれている。
共著論文も、新聞も、何人もの手が入って成立している。
それなのに、社内の設計書を三人で書こうとすると、たいてい空中分解する。

人数のせいだ、と言いたくなる。
だが、それでは説明がつかない。
Wikipediaのほうが、人数ははるかに多い。
だとすれば、難しさを決めているのは人数ではない、別の何かだ。

「本質的に難しい」を疑う

難しさを説明する三つの仮説

まず、ドキュメントの共同執筆が難しい理由を、素直に並べてみる。
コードの共同開発と比べると、三つのハンデがあるように見える。

  • 「コンパイラ」の不在。コードには型チェックやテストという強制的な整合性検証があるが、ドキュメントの整合性を判定するのは各人の頭の中の読者モデルで、人ごとに異なる。矛盾はビルドエラーとして即座に現れず、読み手の混乱として遅れて現れる
  • インターフェースを宣言できない。章立ては関数分割に似て見えるが、文体・抽象度・前提知識・語彙という「グローバル変数」が全編を貫いており、章単位では分割しきれない
  • 成果物と思考過程の癒着。書くことは理解の生成と不可分で、複数人で書くとは、複数の思考過程を一つの線形テキストにマージすることになる

どれも、それらしい。
だが、「だから本質的に難しい」と結論づける前に、一つ確かめておきたい。

成立している事例は多い

本当に本質的に難しいなら、多人数の執筆はどこでも破綻しているはずだ。
ところが、成立している領域は、むしろ多い。
Wikipedia、共著論文、新聞、RFC、ISO規格、OSSのドキュメント。

そして成立している事例には、共通して同じ構造がある。
役割分化、文書規範、編集権限。
つまり「ドキュメントの共同執筆は本質的に難しい」という観察のほうが、怪しい。
難しさの体感は、同格のメンバーがフラットな体制で、一枚岩の文書を書く場面に、偏っている。

変数は人数ではなく整合性スコープ

完結単位の大きさが難しさを決める

成立事例を、もう一度よく見る。
すると、共通点がもう一つ浮かぶ。
Wikipediaはページ単位、論文は一本単位、新聞は記事単位。
いずれも、小さい完結単位の集まりとして書かれている。
整合性が要求されるスコープが、小さいのだ。

一方、難しいと感じる文書は違う。
設計書、提案書、書籍。
全体を貫く一つの論理が要求される、一枚岩だ。
ここから、法則が一つ導ける。
共同執筆の難しさは人数ではなく、整合性を保証すべきスコープの大きさに比例する。

大きなスコープで成立している事例も、よく見ると、必ずどちらかをやっている。
「一人が全体を書き直す」か、「編集長という単一の整合性保証者を置く」か。
分散システムで、グローバルな一貫性を単一のコーディネータに保証させる構成と、同型だ。

一貫性の源泉は「同一の生成モデル」

では、なぜ一人で書くと一貫するのか。
一人だから、ではない。
一人の中では、暗黙の制約がすべて共有済みで、調整コストがゼロだからだ。
書き手は、常に自分自身と合意済みの状態にある。

傍証がある。
一人で書いても、執筆期間が空くと一貫性は壊れる。
半年後の自分は、同じ生成モデルではないからだ。
一貫性の源泉は、「人が一人であること」ではない。
同一の生成モデルからの出力であること、にある。

この見方は、編集長方式が機能する理由も説明する。
編集長は、全員の原稿を自分の生成モデルに通して、再出力している。
つまり編集とは、実質、翻訳だ。

スタイルガイドの限界も、ここから導ける。
明文化で揃えられるのは、表記や章構成といった、モデルの浅い層だけだ。
何を自明として省くか、どんな比喩を使うか、という深い層は揃わない。
引き継ぎで判断基準を渡せないのと同じ構造で、規約をいくら整備しても「継ぎ接ぎ感」は消えない。

調整コストの経済学

ここまでの話は、一つの勘定に還元できる。

執筆体制調整コストの扱い
一人で書くほぼゼロ
複数人+小さい完結単位(Wikipedia型)スコープ分割で回避
複数人+一枚岩+統合者一人に集約して支払う
複数人+一枚岩+フラット全員が分散して支払い続ける

「難しい」の正体は、最後の行だ。
調整コストが体制のどこにも集約されず、全員が見えない形で支払い続ける。
コストが不可視だから、書き方の問題やメンバーのスキルの問題と、誤診されやすい。

難しさそのものは、消せない。
できるのは、どこで誰が支払うかを設計することだけだ。
コンウェイの法則が組織構造を成果物に写すのに対して、ここでは逆向きの力が働く。
成果物に要求される一貫性の構造が、執筆体制の構造を規定する。
一枚岩の文書が欲しければ、体制のどこかに「一枚岩の点」が要る。

だから、冒頭の三人の設計書に戻る。
あれが空中分解したのは、三人だったからではなかった。
一枚岩の文書を、フラットな体制のまま書こうとしたからだ。
それは、構造的にいちばん高くつく選び方だった。
取れる手は、二つしかない。
Wikipedia型に倣って完結単位を小さく切るか、編集長型に倣って統合者を一人立てるか。
どちらも調整コストを消す魔法ではなく、支払い方を先に決めておく、というだけの設計だ。

関連記事

  1. 構想はなぜ一人が早いのか、そしてLLMは何を変えたのか
  2. AIで賢くなるほど、組織はバラバラになる:共通認識を「転送」から「再生成」へ
  3. 引き継ぎで知識は渡せても、判断基準は渡せない
  4. ADRを効果的に組織へ定着させるために
  5. 完成度の高さは心理的安全性を奪うかもしれない
  6. 「失われた30年」が示す、インセンティブ設計の原則
  7. 日本はなぜ「勝てないけど負けない」のか 変化と抵抗の二層構造