AIでコードを書く前に、先に設計書を生成するようにした話
AI要約
AIにコードを生成させる際、プロンプトを毎回ゼロから書くのではなく、先に設計書を作成してからコード生成を依頼するアプローチです。目的・背景・処理フロー・異常系などを設計書で整理することで、AI出力のばらつきを減らし、レビュー基準を統一できます。実装現場での試行錯誤を踏まえた、実践的な開発プロセスの改善事例です。
AI要約
AIにコードを生成させる際、プロンプトを毎回ゼロから書くのではなく、先に設計書を作成してからコード生成を依頼するアプローチです。目的・背景・処理フロー・異常系などを設計書で整理することで、AI出力のばらつきを減らし、レビュー基準を統一できます。実装現場での試行錯誤を踏まえた、実践的な開発プロセスの改善事例です。
Cursor や Claude Code などのAIエージェントをチームで使うと、コミットルールが崩れやすくなります。これを防ぐには「禁止事項・手順・メッセージ形式」の3点を明文化し、.cursor/rules や CLAUDE.md に記述することが重要です。チケット番号を先頭に入れる、git add .を禁止するなど、具体的なルール設定で追跡性が大幅に向上します。

