文書主義原則
前回は「不可逆な行為ほど確認と記録を課す」という設計の考え方を整理しました。 今回は、その「記録」という行為そのものを原則として定義している文書主義について書き残しておきます。
文書主義とは何か
文書主義とは、意思決定や作業判断を口頭や記憶に頼らず、ファイルや文書として残すという原則です。
「そんなの当たり前では」と思うかもしれません。 ただ、AI を複数使って組織的に動かす場面では、この当たり前がとくに重要になります。
人間同士なら「さっきこう決めましたよね」という確認が会話でできます。 AI には文脈をまたいだ記憶が基本的にありません。セッションが変われば、前回どんな判断をしたか、どんな理由でその設計にしたかは、文書として残していない限り消えます。
だから「記録を残す」は努力目標ではなく、構造として必要な原則になります。
なぜ記録に残すと効くのか
文書として残しておくことには、大きく三つの効能があります。
ひとつ目は、後から検証できること。
ある判断が正しかったのか間違いだったのかは、実行してみて初めてわかることが多いです。 「なぜあのときそう決めたのか」が記録になければ、検証の起点が作れません。 「なんとなくうまくいった」「なんとなく失敗した」という感覚だけが残り、改善につながりません。
記録があれば「このときこういう前提でこう決めた、結果はこうだった」という形で照らし合わせられます。 それが積み重なると、判断の精度が少しずつ上がっていきます。
ふたつ目は、責任の所在を辿れること。
AI に仕事を任せる構造では、「誰が何を決めたか」が曖昧になりやすいです。 AI が出力したのか、人間が承認したのか、どちらも「なんとなく流れた」状態になると、問題が起きたときに原因を特定できません。
文書主義は「この判断はこのタイミングでこの役割が行った」という証跡（後から確認できる記録のこと）を残す行為でもあります。 証跡があれば、問題の原因を構造として分析できます。原因が分かれば、再発を防ぐ設計ができます。
みっつ目は、別の AI や次の担当への引き継ぎができること。
AI を使う場面でとくに効いてくるのが、この引き継ぎの側面です。
あるセッションで設計した判断を次のセッションに渡すとき、文書がなければゼロから説明し直すことになります。 逆に、判断の背景・選んだ理由・却下した選択肢が文書に残っていれば、次の AI はそこから続きを始められます。 人間の担当者が変わる場面でも同じことが言えます。
引き継ぎコストを下げることは、継続して動かせる組織の条件でもあります。
実際どう運用するか
原則として理解しても「具体的に何をどう書けばいいか」が見えないと動けません。 このプロジェクトで実際に試している運用を記録として残しておきます。
意思決定の記録は、その場でファイルに落とす。
「あとでまとめて書く」は実質書かないと同じです。 判断を下した直後、設計を変えた直後に、1〜3行でもファイルに起こします。 「なぜそうしたか」「他の選択肢は何があったか」を一言添えるだけで、後から見たときの解像度が変わります。
ファイルは探せる場所に置く。
記録は残したが見つけられない、という状態は記録がないのとほぼ同じです。 命名規則、置き場所、索引の三点セットを最初に決めておくのが理想です。 このプロジェクトでは設計ドキュメントの置き場を明示し、変更があればファイルを更新する形を取っています。
全部を完璧に書こうとしない。
文書主義の最大の敵は「完璧に書こうとして書けなくなる」ことです。 箇条書きでも一行メモでも、残っている状態の方が残っていない状態より明らかに良いです。 粗くてもいいので、判断の形跡を残す習慣を先に作る。精度はその後でいくらでも上げられます。
記録を残すことは、誠実さの話でもあります。 「なぜそう決めたか」を記録しておくことは、後から自分や別の誰かがその判断を引き受けられる状態を作ることです。
ただし記録が増えるにつれて別の問題も出てきます。 記録が複数の場所に散らばってしまうと、どれが最新の正しい情報なのかがわからなくなる。 文書が増えれば増えるほど、その管理の仕方も設計する必要が出てきます。