1. 仕様書は読まれなくなる
企業のIT部門は大量のドキュメントを生み出す。要件定義書、基本設計書、詳細設計書、API仕様書、テスト仕様書。プロジェクトの最中、これらは不可欠だ。意思決定の根拠であり、チーム間の共通言語であり、品質の担保だ。
しかしバージョンが上がると、それらは陳腐化する。v3.0が稼働しているとき、v1.0の設計書を読む人間はいない。アーキテクチャが変われば、旧設計書の構造図は過去の遺物になる。
問題は、仕様書に書かれていた「なぜこの設計を選んだのか」という判断の根拠も、一緒に消えることだ。なぜマイクロサービスではなくモノリスを選んだのか。なぜこのデータベースを選んだのか。なぜこのトレードオフを受け入れたのか。
仕様書は「何を」「どのように」を記録する。しかし「なぜ」は、仕様書のフォーマットに収まらない。
仕様書は、システムの設計図。
しかし設計図は、設計者の思想を語らない。
2. 哲学は読み継がれる
UNIX哲学は50年以上前に生まれた。「ひとつのことをうまくやれ」「テキストストリームを共通インタフェースにせよ」。UNIXの実装は何度も書き換えられ、派生し、置き換えられた。しかしUNIX哲学は今も生きている。
フレデリック・ブルックスの『人月の神話』は1975年の著作だ。そこで論じられたソフトウェア開発の本質的困難は、50年後の今も変わっていない。当時の技術スタックは完全に過去のものだが、思考は色褪せない。
これらは仕様書ではない。哲学だ。なぜそう設計すべきか、何を守り何を捨てるべきか、どのような原則に従うべきか。具体的な技術を超えた、思考の骨格だ。
仕様書の寿命はシステムの寿命に縛られる。哲学の寿命は、それを読む人がいる限り続く。
3. 設計仕様書とエッセイの違い
| 設計仕様書 | エッセイ | |
|---|---|---|
| 記録する対象 | システムの構造と動作 | 構造を選んだ理由と思想 |
| 寿命 | バージョンと共に陳腐化 | プロダクトが消えても残る |
| 想定読者 | 開発チーム・後任者 | 未来の誰か |
| 形式 | 網羅的・定型的 | 選択的・散文的 |
| 価値の源泉 | 正確さ | 誠実さ |
両者は対立するものではない。仕様書は仕様書として必要だ。しかし仕様書だけでは、その設計が生まれた文脈が伝わらない。
エッセイは、仕様書の行間を言語化する行為だ。
4. トキストレージが刻んできたもの
トキストレージは一人のプロジェクトだ。設計仕様書は存在しない。コードがそのまま仕様であり、GitHubのコミット履歴が変更記録だ。
しかしエッセイは書いてきた。
- SSDLC——セキュリティはコストではなく倫理だと書いた。なぜデータをサーバーに送らない設計を選んだのか、その哲学を刻んだ。
- エンタープライズアーキテクチャ——初期設計としてのEAが後付けのEAと根本的に異なることを書いた。一人のプロジェクトでもEAが必要な理由を刻んだ。
- PoCの目線——Opusコーデックが失敗し、Codec2に至った検証過程を書いた。「やめる判断」が「続ける判断」と同じだけ重要であることを刻んだ。
- 責任者の決断——すべての判断に名前が刻まれることの意味を書いた。決められない組織と、名前を刻む個人の違いを刻んだ。
これらはマーケティング文書ではない。技術ブログでもない。なぜこのプロダクトがこの形であるのかを、将来の誰かに向けて記録した思考の証拠だ。
5. NDLへの納本——哲学も永続する
トキストレージは国立国会図書館（NDL）への納本を行っている。ニュースレターを通じて、購入者のストーリーとQRコードが国家記録として保存される。
しかし保存されるのはプロダクトだけではない。このサイト自体がNDLのウェブアーカイブの対象となる。つまり、これらのエッセイもまた、国家記録として永続する可能性がある。
100年後、誰かがトキストレージのQRコードを発見したとする。技術的な復号はコードを読めばわかる。しかし「なぜQRコードに音声を閉じ込めたのか」「なぜサーバーを使わなかったのか」「なぜ1000年の保存を目指したのか」——その「なぜ」は、エッセイにしか書かれていない。
プロダクトと哲学が一緒に保存される。これがトキストレージのアーカイブ設計だ。
QRコードは「何を残したか」を伝える。
エッセイは「なぜ残したか」を伝える。
6. 書くことは、考えたことの証拠
エッセイを書くことには、もうひとつの意味がある。書くことは、考えることを強制する。
「なぜこのアーキテクチャを選んだのか」を散文で説明しようとすると、自分の思考の曖昧さに直面する。箇条書きでは見えなかった論理の飛躍が、文章にすると露わになる。
もしエッセイとして書けないなら、実は自分でもわかっていなかったということだ。これは責任者の決断と通底する。決断したと言いながら言語化できないなら、それは決断ではなく流れだ。
エッセイは鏡だ。自分の思考を映し出し、曖昧さを許さない。だから書く。書けたものだけが、考えたことの証拠になる。
7. 結び——刻むとは、思考の証拠を残すこと
設計仕様書は、システムの記録。
エッセイは、思考の記録。
システムは書き換えられる。思考の記録は、書き換わらない。
トキストレージはプロダクトだ。QRコード生成ツールがあり、物理製品があり、NDLへの納本がある。これらは形のあるものだ。
しかしプロダクトだけでは、なぜそれが存在するのかは伝わらない。なぜこの設計なのか。なぜこの制約を選んだのか。なぜ100年後の読者を想定するのか。
その「なぜ」を刻むのが、エッセイだ。
エッセイを書くことは義務ではない。仕様にも要件にも含まれない。しかし考えたことを記録しなければ、考えたという証拠は残らない。そしてトキストレージは、証拠を残すためのプロダクトだ。
プロダクトが存在証明を残すなら、プロダクトの思想もまた、刻まれるべきだ。