ソースコードのコメント頭にキーワード仕込んで、そこから仕様書を自動生成する仕組みが良いんじゃないかと思ってる（昔Perlで解析・テキスト出力できる簡単なの書いたことある）

ただコメントもセンス要るからなぁ…
コネクションを取得するとか書かれても困るし