仕様書 とは？

そうだよ。どんな機能があって、ボタンを押したらどう動くかなど、システムの全てを文書にまとめたものだね

プロジェクトの規模によるよ。大規模なら基本設計書・詳細設計書・画面仕様書と段階的に作ることが多いね

小さなプロジェクトなら簡易的でもいいけど、仕様書がないと「思ってたのと違う」という手戻りが起きやすいから注意だよ

プロジェクトマネージャーやシステムエンジニアが書くことが多いよ。顧客の要望を聞いて要件定義書にまとめ、それを元に設計書を書く。最近はプロダクトオーナーがユーザーストーリーの形で仕様を書くアジャイル開発も増えているね。

「仕様書が正しい」か「コードが正しい」かで判断が分かれるんだ。仕様書が古くなって放置されるケースは非常に多くて、業界では「コードが唯一の真実」とも言われる。だから最近はAPIならOpenAPIスペック、テストならBDD（振舞い駆動開発）のように、コードから仕様を生成したり、テスト自体が仕様になるアプローチが注目されているよ。