AI時代、設計書は「作る基準・確かめる基準」に戻ってきた
2026.11.12設計書は本来、コードを書くための基準であり、出来上がったものを確かめるための基準でした。ところが多くの現場で、設計書は「ない」か「古い」ものになり、いまの動きを知る手段はコードを読むことだけになりました。AIがコードを書く時代になって、設計書は再び基準の位置に戻ってきています。何が戻ってきて、何が新しいのか。AI時代の設計書の役割を整理します。
設計書は、もともと「基準」だった
V字モデルで開発してきた方には、なじみのある話だと思います。要件定義、基本設計、詳細設計と進み、プログラマは詳細設計書を見てコードを書きます。テストも、単体テストは詳細設計に、結合テストは基本設計に、総合テストは要件に対応させて作ります。設計書は読み物である以前に、作る基準であり、確かめる基準でした。
ところが、いつの間にか設計書が「ない」「古い」現場が増えていきました。理由は1つではありません。
①設計書を作らない開発が広がった:動くソフトウェアを早く届けることを優先し、設計書は最小限にするか、書かない進め方が増えました
②仕様が決まらないまま開発が始まる:要件を詰めきる前に作り始め、設計書がない状態のまま開発が進みます
③作っても、更新されない:ウォーターフォールの開発では今も設計書が作られます。ただ、納品物として作られた後、改修を重ねるうちに現物と合わなくなります
その結果、多くの現場で「いまどう動いているか」を知る手段は、コードを読むことだけになりました。コードが正しいからではなく、ほかに頼れるものがないからです。こうして生まれたのが、「コードは残るが、仕様は誰も知らない」という状態でした。
AIで、設計書が基準の位置に戻ってきた
この流れを変えたのが、AIです。
仕様駆動開発では、要件と設計を先に決め、AIはその設計書を読んでコードを書きます。前回の記事で見たように、機能をまたいで守るべき判断も、設計書にあって初めてAIに守らせることができます。設計書は再び、作る基準になりました。
確かめる側でも、設計書の重みが増しています。AIはコードだけでなく、テストも書けます。ただ、そのテストが何を正しいとするかは、設計がなければ決まりません。AIがコードとテストの両方を書くなら、なおさら、人間が確かめる拠り所として設計書が要ります。設計書は再び、確かめる基準にもなりました。
新しいのは、設計書を読んで作る主役が、人間からAIに替わったことです。人間なら設計書の行間を読み、曖昧な部分は経験で補いました。AIは、書かれていることを基準に作ります。だからこそ、設計書に何が書かれ、それが正しいかどうかが、以前にも増して効いてきます。
戻ってきた設計書も、放っておけば古くなる
ただ、設計書が基準の位置に戻ってきても、先ほど挙げた3つ目の理由は消えていません。作った設計書が、その後の変更に合わせて更新されないという問題です。仕様駆動開発で書いた設計書も、例外ではありません。障害対応でコードを直接直したり、AIに小さな修正を頼んだりするたびに、設計書は少しずつ実装から離れていきます。
以前と違うのは、古くなった設計書が引き起こす結果です。以前なら、古い設計書を読んだ人が、コードや経験と照らして「ここは違う」と気づけました。基準になった設計書は、そうはいきません。新しく加わったエンジニアが設計書をもとに機能を足すと、AIは古い設計書どおりのコードを書き、古い設計書から作ったテストも通ります。作る側も確かめる側も同じ古い基準に立っているため、食い違いはどこにも引っかからず、本番で既存の処理とかみ合わなくなって初めて表に出ます。
Martin Fowlerのサイトの解説記事は、仕様駆動開発を「実装の前に仕様を書く」段階と、「実装の後も仕様を保守し続ける」段階に分けて整理し、多くの道具はまだ前者が中心だとしています。作るときに書いた設計書を、作った後も正しく保つ仕組みは、まだ発展途上です。
設計書を「コードから起こし直す」という発想
では、どうすれば設計書を基準として保てるのでしょうか。
建築の世界には、参考になる考え方があります。工事の前に描く「設計図」とは別に、完成した建物の実際の姿を記録した「竣工図」を作るのです。工事の途中で変更が入ることは避けられないため、最後に現物に合わせて図面を描き直します。改修や点検のときに頼りにされるのは、竣工図のほうです。
ソフトウェアに当てはめると、作る前に書いた設計書とは別に、いまのコードから起こし直した設計書が要る、ということになります。必要になる場面は2つあります。
・仕様駆動開発で作ったシステム:実装の後に入った修正で、書いた設計書と実際のコードがずれていく
・何年も動いてきた既存システム:冒頭で見た理由で、最初から設計書がないか、あっても現物とはとうに違っている
前の節で見たとおり、人が設計書を更新し続ける運用には限界があります。設計書に合わせてコードを保つのではなく、コードに合わせて設計書を起こし直す、という向きの発想が要ります。
どちらの場合も、出発点にできる事実はコードだけです。コードが正しいとは限りませんが、いま実際に動いているのはコードです。起こし直した設計書は、バグも含めて「いまの動き」を写します。だからこそ、人間がそれを読んで「これは意図どおりか」を判断する出発点になります。そのうえで、次の改修ではAIに渡す「作る基準」に、変えたくない部分が変わっていないかを確かめる「確かめる基準」にも使えます。
私たちDigKnowは、この「コードから設計書を起こし直す」側を作っています。ただし、コードから起こせるのは「何をしているか」「どう動くか」までで、「なぜそう決めたのか」は人間が書き足す必要があります。いま動いているコードを事実として現状を見える形にし、その上で人間が判断を重ねる、という分担です。
設計書は、理解を代わってくれるものではない
ここで1つ、誤解しやすい点があります。設計書が基準になると、「設計書さえあれば、人間はコードを理解しなくてよい」と考えたくなります。
私は逆だと考えています。設計書は、人間がAIの仕事を理解する速度を上げるための道具であって、理解を代わってくれるものではありません。AIが数百行のコードを書く世界で、人間がすべてのコードを読み切ることはできません。だからこそ、コードより小さく、意図に近い設計書の単位で、人間がAIの仕事を把握し、判断し続ける必要があります。この考え方は「AIが書く時代に、人間が手放してはいけないもの」でも書きました。
そして、設計書がもっとも切実に必要になるのは、実は新規開発ではありません。何年も動いてきた既存システムを、新しい基盤へ移す場面です。移行では「いまと同じに動くこと」が求められますが、「いま」がどう動いているかを示す設計書がなければ、同じかどうかを確かめる基準がありません。
まとめ
設計書は、もともと作る基準であり、確かめる基準でした。ところが、設計書を作らない開発や、仕様が決まらないまま始まる開発、作っても更新されない運用が重なり、多くの現場でいまの動きを知る手段はコードだけになりました。AIの登場で、設計書は再び基準の位置に戻ってきています。ただし、読んで作るのはAIです。基準がずれると、間違いは作る側と確かめる側の両方を通り抜けます。建築の竣工図のように、いまのコードから設計書を起こし直し、それを人間が理解と判断の土台にすることが、これからの設計書のあり方です。
ここまでは、新しく作る開発を中心に見てきました。次回からは視点を変えて、既存システムに目を向けます。いま、古いシステムを新しい基盤へ移すマイグレーションやモダナイゼーションの需要が高まっています。なぜ今なのか、その背景から掘り下げます。
ところで、AIがコードを書く時代ほど、「いまのコードが何をしているか」を把握し続けることが大切になります。私たちDigKnowが開発する「Codeledge(コードレッジ)」は、ソースコードから技術ドキュメントを自動生成するAIサービスです。GitHubなどのリポジトリを連携するだけで、AIが仕様書・設計書を作成し、コードの更新に合わせて最新の状態に保ちます。AIコードドキュメンテーションで、「コードは残るが、仕様は誰も知らない」という問題を解決します。→ Codeledgeについて詳しく見る
桑原 脩(くわはら おさむ)|DigKnow株式会社 CTO 大阪大学大学院でシステム工学を専攻。大日本印刷(DNP)で、IoTによる医療分野の遠隔監視システムの構築や、データ分析による生産現場のDXに携わり、最適化システム構築のPMも務める。社内の引き継ぎで技術的負債に直面した経験から、2025年10月、創業メンバーとしてDigKnowに参画。Codeledgeのプロダクト開発と技術戦略を担う。