ソフトウェアを開発するときに仕様書を書くべき3つの理由
7月 5th, 2008 Posted in C++, PHP「Joel on Softwere」で、機能仕様書を書く重要性が延々と述べられているので、ちょっとまとめてみます。いきなりコーディング始めていませんか？
プログラムをデザインする
仕様書の最も重要な役割はプログラムをデザインすることだ。
仕様書を書くという行為自体によって-プログラムがどう機能するか詳細に記述するということによって-プログラムを実際にデザインするように強いられるのだ。
ここでいう仕様書とは機能仕様書のことで、内部仕様書（技術仕様書）のことではないです。機能仕様書とは、ユーザの観点から製品がどのように動くかを記述したドキュメントです。ダイアログとかメニューとかの仕様を書くアレです。
機能仕様書を書くことによって、プログラムがどのように動くかを深く考えることになります。これから作ろうとしているソフトウェアの動きを文章で書き、簡単な絵を添付した場合、上司や顧客からダメだしをされてもすぐに書き換えることができます。一方、2週間掛けて書いたプログラムをダメだしされた場合は・・・！？
アジャイル開発におけるテストファーストも、関数をコーディングする前に関数のテストを書くことによって、その関数の入力と出力の組み合わせを細かく考えます。そうすることで、その関数の仕様を詳細に検討することになります。
作ろうとするものがどう動くかをまず考えることが、デザインにつながります。
コミュニケーションにかかる時間を節約できる
開発のテスト期間中に、どんどん報告されるバグを片っ端からかたづけているとき、スピーディーに改修をこなしているアナタの集中力はMAX！（この状態をフロー状態と言います。）
しかし、突然鳴り出す電話。相手は試験チームのアイツ。いつもくだらない質問で電話してくるアイツです。
試験チームのアイツ：
「音楽CDを再生しながらプロパティダイアログを開くと、CDが停止するんですけど、これ不具合ですか？」
はぁ？不具合なわけないじゃん。つか今頃そんな質問すんなYO！
アナタ：
「それは仕様です。」
試験チームのアイツ：
「では仕様書への記載お願いします。」
げ。書いてなかったっけ？
こんな経験たぶん誰にでもあるんじゃないですか？ボクだけですか？
さて、ここからまた改修作業に戻るわけですが、「ピープルウェア」によるとさっきのフロー状態まで戻るのに15分はかかります。あぁ、なんという無駄。
2分間の仕様書への追記をサボったために、電話対応＋フロー状態への復帰で20分の貴重な時間が無駄になります。20分の無駄も問題ですが、仕事が中断したことによるイライラで仕事へのモチベーションが下がってしまうことのほうが大問題です。
仕様書を書いておけば、こんなことにはならないのです。
スケジュールが立てられない
製品を開発するには時間がかかり、そしてお金がかかります。スケジュールを立てられるだけの仕様書がないということは、製品を開発するのにどれくらい時間がかかり、どれくらいのお金がかかるか分からないということです。
あなたは値段を見ずにジーンズを買ったりしないだろう。
まとめ
「Joel on Softwere」の仕様書を書く理由を自分なりに解釈してますが、ほかにも仕様書を書かないことによってこんな問題があるよってのがあれば教えて欲しいです。仕様書の書き方については「達人プログラマー」が参考になります。これはまたいつかまとめたいと思います。できれば。
参考資料
