WRITING
要件定義は、発注者の仕事である——システム構築の「施工図」をそろえる100枚のテンプレート
AIのおかげで、システムを「作る」速さは目に見えて上がりました。社員が言葉で頼むだけで業務アプリができ、開発会社の生産性も変わりつつあります。それでも、プロジェクトの失敗はなくなりません。原因の多くは、作る前にあります。何を作るのか、誰のために、どこまでを、どんな条件で——。この記事では、建設会社がシステムを発注するとき、あるいは自社で作るときに、その「作る前」を埋めるための100ページのテンプレート集を紹介します。
作る速さが上がると、決める力が問われる
AIを使った開発では、画面やプログラムの下書きが短時間で手に入ります。社員が自分でアプリを作れる仕組みも、大手のオフィス製品に組み込まれ始めました。作る側の手間が減ったぶん、相対的に重くなったのが**「何を作るか」を決める作業**です。
要求があいまいなまま作り始めると、AIはあいまいなまま、もっともらしいものを作ります。人間の開発者なら途中で「ここはどうしますか」と聞き返すところを、AIは推測で埋めて先へ進みます。完成品を見てから「そうではない」と気づく手戻りは、作る速さが上がっても減りません。むしろ、作り直しが簡単になったぶん、決めないまま進む誘惑が強くなります。
決める作業の中心にいるのは、開発会社ではなく発注者です。業務の実態を知っているのも、何が困りごとかを知っているのも、発注者の側です。公的な要件定義の手引きも、利用者側が主体となって要件を固めることを重視しています。要件定義は、ベンダーに任せる仕事ではなく、発注者の仕事なのです。
建設業の人には、この構図が見えやすい
建設会社の方にとって、この話はきっと新しくないはずです。建物も土木構造物も、設計図書と施工計画なしに着工することはありません。施主の要望を聞き、現地を調べ、基本設計で全体像を固め、実施設計で細部を詰め、施工図で現場の納まりを決めてから、ようやく工事が始まります。
ところが、社内のシステムとなると、この順序が飛ばされやすくなります。「とりあえず発注システムを作りたい」「現場で使えるアプリが欲しい」という要望が、図面にあたるものを持たないまま開発会社や社内の作り手に渡されます。口頭で着工しているのと同じです。
| 建設の工程 | システム構築の工程 | テンプレート集の章 |
|---|---|---|
| 基本計画・事業計画 | 企画・構想 | 01 企画・構想 |
| 現地調査・既存調査 | 現状把握(As-Is) | 02 現状把握 |
| 基本設計 | あるべき姿・要件定義 | 03 To-Be/04 要件定義 |
| 実施設計・施工図 | 入出力・データ・連携の設計 | 05〜08 |
| 業者選定・入札 | ベンダー選定・調達 | 09 調達 |
| 検査・引き渡し | テスト・移行・運用 | 10 テスト・移行 |
| 工程管理・施工管理 | プロジェクト管理 | 11 PM |
図1:建設の工程とシステム構築の工程の対応(筆者による整理。厳密な一対一ではなく、考え方の対応)
建設の現場が「図面がないと施工できない」と知っているように、システムも「決めたものを書いた文書がないと作れない」という点は変わりません。違うのは、システムの図面には決まった書式が浸透していないことです。何をどこまで書けばよいかが分からず、結果として書かれないまま進んでしまいます。テンプレートは、その書式の代わりになります。
テンプレート集の中身
今回公開するテンプレート集は、企画・構想からプロジェクト管理まで11章と付録、全100ページで構成しています。各章の扉には、その章のテンプレート一覧と、どの工程で使うかを示しました。
| 章 | 主なテンプレート |
|---|---|
| 01 企画・構想 | プロジェクト憲章、SWOT、バランススコアカード、スコープ定義、体制図・役割分担、効果試算、リスク一覧 |
| 02 現状把握 | ヒアリングシート、業務一覧、As-Is業務フロー、工数調査、帳票・資料の棚卸し、課題の原因分析、優先度マトリクス |
| 03 To-Be | To-Beコンセプト・業務フロー、ギャップ分析、改善検討表、システム化範囲図、要求構造図 |
| 04 要件定義 | 要件定義書の目次案、機能一覧、業務処理定義、非機能要求のグレード表、権限・ロール定義 |
| 05 入力設計 | 画面一覧、画面遷移図、画面レイアウト、入力チェック仕様、画面共通ルール |
| 06 出力設計 | 帳票一覧・レイアウト、ダッシュボード・KPI設計、通知・ファイル出力仕様 |
| 07 データ設計 | エンティティ一覧、ER図、テーブル定義、コード定義、CRUD図、データフロー図、データ移行マッピング |
| 08 外部連携 | システム全体構成図、外部システムIF一覧・定義書、バッチ処理一覧、ネットワーク構成、基盤の選定比較 |
| 09 調達 | 提案依頼書(RFI/RFP)の構成、評価基準・評価表、見積比較、適合・乖離分析 |
| 10 テスト・移行 | テスト計画、テストケース表、受入テストのチェックリスト、移行計画、運用設計、教育計画、効果測定 |
| 11 PM | WBS、課題管理表、変更管理、会議体・議事録 |
| 付録 | 用語集、レビュー観点のチェックリスト、白紙レイアウト |
企画
01 企画・構想
現状把握
02 As-Is
要件定義
03 To-Be/04 要件
設計
05〜08 入出力・データ・連携
テスト・移行
10 テスト・移行
設計上の3つのこだわり
1. すべてのページに「記入枠」と「記入例」
白紙の書式は、何を書けばよいかが分からず手が止まってしまいます。そこで、すべてのページに【記入】の枠と、資材の発注業務を題材にした架空の記入例を入れました。例を自分の業務に置き換えていけば、一通りの文書ができます。記入例の題材を一つの業務にそろえたので、章をまたいで読むと、企画から移行までが一本の話としてつながります。
2. ノートに「使い方」「記入のポイント」「注意点」
各ページのノート欄には、そのテンプレートをいつ使うか、どこに気をつけて書くか、よくある失敗は何かを記しています。たとえばAs-Isの業務フローでは、表計算ファイルやFAXのような「システムではないもの」も必ず描くよう注意しています。二重入力や転記の発見につながるからです。資料を作る人だけでなく、レビューする人の確認観点にもなります。
3. 公的な手引きの考え方に沿う
章の構成と工程の区分は、情報処理推進機構(IPA)が公開している要件定義の手引き、非機能要求のグレード、ソフトウェア開発の共通フレームを参考にしています。独自の流儀ではなく、開発会社と共通の言葉で話せる形にしておくと、発注先とのやり取りがかみ合いやすくなります。
どこから使うか:規模に応じて選ぶ
100ページすべてを埋める必要はありません。むしろ、規模に合わせて必要なものだけを選ぶことが前提です。目安をお示しします。
| 規模の目安 | まず使うテンプレート |
|---|---|
| 部署内の小さな業務アプリ | プロジェクト憲章、As-Is業務フロー、To-Be業務フロー、機能一覧、画面遷移図。5〜6枚で「何を作るか」が共有できます |
| 開発会社に発注する業務システム | 上記に加えて、スコープ定義、非機能要求、提案依頼書、評価表、テスト計画、移行計画 |
| 全社の基盤・複数部署にまたがる案件 | 全章。とくにステークホルダ一覧、体制・役割分担、外部連携、データ移行、変更管理 |
小さなアプリでも、憲章と業務フローの2枚だけは省かないことをお勧めします。何のために作るのかと、今の業務がどう流れているのか。この2つが書かれていれば、作り手が人でもAIでも、大きく外れることは少なくなります。
AIと一緒に使う
テンプレートの枠は、AIへの指示の型としても使えます。ヒアリングのメモをAIに渡して業務フローの枠を埋めさせる、機能一覧から画面一覧の下書きを作らせる、要件定義書の目次案に沿って記載漏れを点検させる——そういった使い方です。枠が決まっていると、AIの出力もそろい、人が確認しやすくなります。
ただし、AIに任せてよいのは下書きと点検までです。スコープをどこで切るか、どの課題を優先するか、何を満たせば受け入れるか。こうした判断は発注者が下すものであり、テンプレートはその判断を書き残す場所です。AIが書いた要件を、誰も判断しないまま開発に回してしまうと、冒頭の「推測で埋めて先へ進む」問題がそのまま戻ってきます。
図面を描く力が、発注者の力になる
建設会社は、図面を読み、描き、図面どおりに作る組織です。その強みは、システムの世界でもそのまま生きます。作る技術がAIで手に入りやすくなった今、差がつくのは、何を作るかを自分たちの言葉で書き残せるかどうかです。
このテンプレート集が、その最初の一枚を書く手助けになれば幸いです。必要なページだけを複製して、自社の書式として育ててください。