設計書– tag –

仕様書の作成ツールを、文章・表・図・共有と履歴の4つの役割に分けて紹介。Excel・Word・ドキュメント共有ツール・作図ツールの向き不向きと、設計書や要件定義書のツールを選ぶ時の確認点が分かります。

システム仕様書とは何かを、業務・機能・データ・運用の4層で書く範囲から解説。要件定義書・設計書・テスト仕様書との関係、プログラムやソフトウェアの仕様書の項目、自治体システムの標準仕様書、設計書のGit管理まで分かります。

仕様書駆動開発とは何かを、コードから書く進め方との違いから解説。仕様書に書く4点（目的・振る舞い・制約・確かめ方）の表、公開されているツールキットの流れ、AI駆動開発で設計書を書く時に人が確かめる所が分かります。

仕様書とは何かを、意味と目的からわかりやすく解説。誰が書く・何を決める・いつ使うの3軸で見る仕様書の地図、設計書・要件定義書・図面との違い、IT・建設・住宅・調達など業界別の主な仕様書と、読み方・書き方の基本が分かります。

仕様書と設計書の違いを、何を書くか・誰が書くか・作る順番の3つで解説します。システム開発と建設工事の2つの例で並べた比較表と、設計書と内訳書・設計図書の違いも分かります。

設計書とは何かを、システム開発の流れに沿ってやさしく解説。基本設計書・詳細設計書・画面やデータの設計書など種類ごとの役割と、テスト工程と対応させた「V字の地図」、土木の設計書との違いが分かります。

設計書のリバースとは、動いているソースコードから設計書を起こし直す作業です。リバースで分かること・分からないことの表、進める手順、どこまで書くかの決め方、生成AIを使う時に確かめる所をまとめました。

仕様書や設計書をMarkdown（マークダウン）で書く方法を紹介。見出し・表・テキストの図・変更履歴の4部品で組む手順、Excel・Wordとの使い分け、テンプレートの作り方と管理のコツまで分かります。

機能仕様書とは何かを、要件定義書や設計仕様書との違いから解説。1つの機能を入力・処理・出力・例外の4枠で書く記入表、目次と項目、ExcelやWordのテンプレートとサンプルの使い方、伝わる書き方のコツが分かります。