-
コラム
コラム
Blog
AI時代、設計書は「作る基準・確かめる基準」に戻ってきた
設計書は本来、コードを書くための基準であり、出来上がったものを確かめるための基準でした。ところが多くの現場で、設計書は「ない」か「古い」ものになり、いまの動きを
仕様駆動開発はなぜ「設計書」を必要とするのか
仕様駆動開発(SDD)は、要件を決め、設計を決め、タスクに分けてからAIに実装させる進め方です。ところが実際に回してみると、要件とタスクは書いても、設計は「AI
AI駆動開発の限界——AIは正解を知っていても、選べない
AIが書いたコードが動き、テストも通り、レビューでも違和感がありません。それなのに後になって、「うちの仕様とは違う」と分かることがあります。思い当たる方も多いの
AI駆動開発の主導権は「仕様駆動開発」へ——Vibe Codingの次に来たもの
AIコーディングエージェントを毎日使う開発者が、7割に迫りました。AIにコードを書かせること自体は、もう特別ではあ
AIが書く時代に、人間が手放してはいけないもの
AIが書いたコードは、たしかに動きます。ただ、なぜそう動くのかを、もう誰も説明できない。ここまでの23本の記事でくり返し向き合ってきたのは、突き詰めればこの一点
AIはドキュメント問題を解決できるか——可能性と現実の境界線
AIコーディングがコードを書く速度を何倍にも引き上げた一方で、その理解を支えるドキュメントは相対的に痩せ細っていく——この構造を何度も書いてきました。ここで自然
技術ドキュメント問題の全体地図——AIコーディング時代に何が起きているか【まとめ】
ここまで、技術ドキュメントについて何本も記事を書いてきました。書いては消し、現場の話を聞いては書き直す——その繰り返しのなかで気づいたのは、これは「書くか書かな
コードが自分を説明できる世界——「セルフドキュメンティングコード」の限界と未来
「良いコードにコメントはいらない。コードそのものが仕様書だ」——シニアエンジニアなら、一度はこの言葉に頷いたことがあるはずです。命名を丁寧にし、関数を適切に分け
スタートアップが「ドキュメントを書かない」合理的理由と、その代償
「いま仕様書を書いている時間があったら、もう一機能リリースしたい」——スタートアップで一度でもコードを書いた人なら、この感覚は身に染みているはずです。実際、創業
日本のSIer文化とドキュメント問題——多重下請けで仕様はどう失われるか
「このシステム、当時の元請けの担当者が辞めて、設計書も最新じゃないんですよ」——SI出身のエンジニアなら、一度は耳にしたことがあるのではないでしょうか。コードは
動くコードほど、理解されなくなる——AIコーディングの逆説
そのコードは動いています。テストも通り、本番でも問題を起こしていません。では「なぜこの設計なのか」——即答できる人は、チームに何人いるでしょうか。少し前まで、「
10年後、システムを読める人は何人残るか——AIコーディング時代の盲点
10年前にローンチされたシステムが、いまも会社の売上の中心にある——そんな現場は、思っているより多いはずです。そして、そのシステムを書いた当時のメンバーは、いま