設計書は人間のためじゃない。AIファースト設計という考え方
はじめに
X のポストを見ていていつも繰り返し考えることがあり、それこそ時間の無駄だと考え今回この執筆に至りました。
あくまで「考え方」の一つとして紹介するものであって、押し付けたりするものではありません。
背景
これまで設計書は、人間が読んで理解することを前提に作られてきました。
Excel、PowerPoint、Wiki、PDFといった形式でまとめられ、レビューされ、合意形成のために使われてきたのが一般的です。
しかし近年、システムは複雑化し、クラウド、IaC、コンテナ、マイクロサービス、セキュリティ要件などが絡み合うことで、人間がすべてを正確に把握し続けることは難しくなっています。
一方で、AIは設計内容を理解し、コード生成、レビュー、運用支援まで行える存在になりつつあります。
この状況において、「設計書は誰のために存在するのか」という前提自体を見直す必要が出てきたのではないでしょうか。
概要
本記事では、設計書の一次的な利用者を人間からAIへと転換するという考え方を提示しています。
設計書はまずAIが正確に理解できる形で作成され、その内容のうち、人間にとって必要な部分のみを可視化・変換して提示し、ExcelやPowerPointはその可視化手段の一つに過ぎず、設計書そのものではないという考え方です。
つまり、
- AI用ドキュメントを一次情報（Single Source of Truth）とする
- 人間向け資料はそこから派生するビューである
という設計思想です。
従来の設計書モデル
内容
AIを一次利用者とする設計書
従来の設計書は、人間が読むことを前提としているため、自然言語による曖昧さや暗黙の前提が多く含まれていました。
これは人間同士のコミュニケーションでは許容されてきましたが、AIが理解・推論・生成を行う際には大きな障害となります。
AIを一次利用者とする設計書では、以下が重視されます。
- 構造化されていること
- 曖昧な表現が排除されていること
- 条件・制約・依存関係が明示されていること
- 機械的に検証可能であること
設計書は「読む文章」ではなく、「解釈されるデータ」へと性質が変わります。
人間向け資料は「可視化結果」である
AI用に構造化された設計情報を、そのまま人間が読む必要はありません。
人間にとって必要なのは、意思決定や説明、合意形成に足る情報です。
そのため、
- Excelで一覧化する
- PowerPointで図示する
- アーキテクチャ図として描画する
といった行為は、設計情報の可視化・変換プロセスと捉えます。
ここで重要なのは、ExcelやPowerPointが「正」なのではなく、あくまで表示形式の一つであるという点です。
元となる設計情報はAI用ドキュメントにあり、人間向け資料はそこから自動的、あるいは半自動的に生成される。
設計書の役割の変化
この考え方により、設計書の役割は次のように変化します。
- 人間が頑張って読み解く対象
→ AIが理解し、人間は結果を見る対象 - 作った瞬間が完成
→ 継続的に更新・検証される知識ベース - 実装と乖離しがちな資料
→ 実装・運用・レビューと密結合した情報源
設計書は「成果物」ではなく、「知識の基盤」として機能するようになる。
新しい設計モデル
終わりに
設計書をAIのために作る、という考え方は、一見すると極端に見えるかもしれません。
しかし、すでにIaCやコードベースの設計では「機械が読むこと」を前提とした記述が当たり前になっています。
その流れを、設計書全体へと拡張するだけです。
- 人間は判断と責任を担い、AIは理解と生成を担う
- その分業を成立させるためには、設計書の在り方自体を変える必要がある
ExcelやPowerPointは今後も使われ続けるでしょう。
ただしそれは「設計書そのもの」ではなく、AI用設計情報を人間に届けるための窓としての役割になるのではないでしょうか。
設計書は、人間のためだけのものではなくなるということです。
一言
もしこの記事が気に入って頂けたらここでのいいね＆フォローとX( @___nix___ )でのフォローもお願い致します。
Discussion