コラム

Blog

コラム ドキュメント

AI時代、設計書は「作る基準・確かめる基準」に戻ってきた

設計書は本来、コードを書くための基準であり、出来上がったものを確かめるための基準でした。ところが多くの現場で、設計書は「ない」か「古い」ものになり、いまの動きを

AI活用・開発生産性トレンド コラム ドキュメント 技術的負債

仕様駆動開発はなぜ「設計書」を必要とするのか

仕様駆動開発(SDD)は、要件を決め、設計を決め、タスクに分けてからAIに実装させる進め方です。ところが実際に回してみると、要件とタスクは書いても、設計は「AI

AIコーディング コラム テスト設計・品質保証 ドキュメント文化・組織論

AI駆動開発の限界——AIは正解を知っていても、選べない

AIが書いたコードが動き、テストも通り、レビューでも違和感がありません。それなのに後になって、「うちの仕様とは違う」と分かることがあります。思い当たる方も多いの

AIコーディング コラム ドキュメント文化・組織論

AI駆動開発の主導権は「仕様駆動開発」へ——Vibe Codingの次に来たもの

                       AIコーディングエージェントを毎日使う開発者が、7割に迫りました。AIにコードを書かせること自体は、もう特別ではあ

AIコーディング コラム 技術的負債

AIが書く時代に、人間が手放してはいけないもの

AIが書いたコードは、たしかに動きます。ただ、なぜそう動くのかを、もう誰も説明できない。ここまでの23本の記事でくり返し向き合ってきたのは、突き詰めればこの一点

AIコーディング AI活用・開発生産性トレンド ClaudeCode コラム

AIはドキュメント問題を解決できるか——可能性と現実の境界線

AIコーディングがコードを書く速度を何倍にも引き上げた一方で、その理解を支えるドキュメントは相対的に痩せ細っていく——この構造を何度も書いてきました。ここで自然

AIコーディング AI活用・開発生産性トレンド コラム ドキュメント

技術ドキュメント問題の全体地図——AIコーディング時代に何が起きているか【まとめ】

ここまで、技術ドキュメントについて何本も記事を書いてきました。書いては消し、現場の話を聞いては書き直す——その繰り返しのなかで気づいたのは、これは「書くか書かな

AIコーディング AI活用・開発生産性トレンド コラム テスト設計・品質保証 ドキュメント

コードが自分を説明できる世界——「セルフドキュメンティングコード」の限界と未来

「良いコードにコメントはいらない。コードそのものが仕様書だ」——シニアエンジニアなら、一度はこの言葉に頷いたことがあるはずです。命名を丁寧にし、関数を適切に分け

AIコーディング コラム ドキュメント文化・組織論 技術的負債 投稿ドキュメント実務

スタートアップが「ドキュメントを書かない」合理的理由と、その代償

「いま仕様書を書いている時間があったら、もう一機能リリースしたい」——スタートアップで一度でもコードを書いた人なら、この感覚は身に染みているはずです。実際、創業

AIコーディング AI活用・開発生産性トレンド コラム ドキュメント文化・組織論 技術的負債

日本のSIer文化とドキュメント問題——多重下請けで仕様はどう失われるか

「このシステム、当時の元請けの担当者が辞めて、設計書も最新じゃないんですよ」——SI出身のエンジニアなら、一度は耳にしたことがあるのではないでしょうか。コードは

AIコーディング AI活用・開発生産性トレンド ClaudeCode コラム 引き継ぎ・属人化解消 技術的負債

動くコードほど、理解されなくなる——AIコーディングの逆説

そのコードは動いています。テストも通り、本番でも問題を起こしていません。では「なぜこの設計なのか」——即答できる人は、チームに何人いるでしょうか。少し前まで、「

AIコーディング コラム ドキュメント ドキュメント文化・組織論 属人化 技術的負債

10年後、システムを読める人は何人残るか——AIコーディング時代の盲点

10年前にローンチされたシステムが、いまも会社の売上の中心にある——そんな現場は、思っているより多いはずです。そして、そのシステムを書いた当時のメンバーは、いま