設計書とは？

設計書とは、要件定義書で定義された「何を作るか」をシステムの「どのように作るか」に変換する技術文書であり、システムの内部構造・処理ロジック・データフロー・コンポーネント間の関係を定義した開発の設計図です。基本設計書（外部設計・概要設計）と詳細設計書（内部設計）の二層で構成されるのが一般的であり、AI駆動開発では要件定義書からの自動生成が実務標準として広がっています。

— 背景・課題

設計書は要件定義書の内容を開発者が実装できる技術仕様に翻訳する文書ですが、この翻訳プロセスは担当者のスキル・経験に品質が依存しやすく・工数が膨らみやすい属人化した工程でした。要件定義書の記述が曖昧なまま設計工程に進むと、設計判断が担当者ごとに異なり設計書の品質がばらつく・設計書と要件定義書の整合性が失われるという問題が生じます。また従来の開発では要件定義書と設計書が別々のツール・ファイルで管理されるため、要件変更の影響が設計書に反映されないという変更管理の断絶も課題でした。

— 仕組み・特徴

設計書は基本設計書と詳細設計書の二層で構成されます。基本設計書（概要設計・外部設計）はシステムの全体構造・画面設計・API仕様・データベース概念設計・外部システムとの連携仕様など、発注者・ステークホルダーが理解できるレベルで定義します。詳細設計書（内部設計）はクラス設計・処理ロジック・SQL・エラー処理など、開発者が実装に直接使用できるレベルで定義します。AI駆動開発では成果物生成AIが承認済みの要件定義書をインプットとして基本設計書の初稿を自動生成し、担当者がレビュー・修正するフローが実務標準として広がっています。さらにER図・ユースケース図・API設計書といった設計成果物も同一パイプラインで自動展開される構成が実現しています。

— 実務利用シーン

AI Native SDLCの設計フェーズでの代表的な活用例は、AI要件定義ガバナンスで承認された要件定義書をインプットとして成果物生成AIが基本設計書の初稿を自動生成し、アーキテクトがレビュー・承認した上で詳細設計書の自動展開へと進むパイプラインです。設計書のバージョン管理をGitで行い、要件定義書の変更が設計書に与える影響範囲をAIが自動特定する構成により、要件変更管理の一貫性が確保されます。BYOK型AIと組み合わせることで、未公開の技術アーキテクチャ・システム構成情報を含む設計書の自動生成をセキュアに実施できます。

— 関連概念との関係性

設計書は要件定義書の下流・テストシナリオの上流に位置するAI Native SDLCの中核成果物として機能し、成果物生成AIによる自動生成・AI要件定義ガバナンスによる品質管理の対象となります。アーキテクチャ設計・API設計・ER図・ユースケース図が設計書の構成要素として連携し、IaC（Infrastructure as Code）へのデプロイ設定も設計書から自動展開される構成がAI駆動開発の実装パイプラインとして標準化されています。

— まとめ・重要性

設計書は要件定義書の品質を実装品質に変換する重要な技術文書です。AI駆動開発においてLLMが要件定義書から設計書を自動生成・相互検証するパイプラインの整備が、上流工程の品質統制と開発効率の向上を同時に実現する重要な実践課題として、AI Native SDLCの中核的な取り組みとなっています。