「ドキュメント書いて」はもう古い。AIに4種類のドキュメントを「コードから自動生成」させる実践ガイド
AI要約
ドキュメント作成はコード完成後だから後回しになります。その解決策は、コードから自動生成する仕組みです。README・API仕様書・ADR・コメントなど4種類のドキュメントごとに、AIに渡すべきコンテキストが全く異なることに着目。実装例とプロンプト、GitHub Actionsの自動化レシピを紹介しながら、「AIが下書き生成→人間がレビュー」の実践的ワークフローを解説しています。
AI要約
ドキュメント作成はコード完成後だから後回しになります。その解決策は、コードから自動生成する仕組みです。README・API仕様書・ADR・コメントなど4種類のドキュメントごとに、AIに渡すべきコンテキストが全く異なることに着目。実装例とプロンプト、GitHub Actionsの自動化レシピを紹介しながら、「AIが下書き生成→人間がレビュー」の実践的ワークフローを解説しています。
Cursor や Claude Code などのAIエージェントをチームで使うと、コミットルールが崩れやすくなります。これを防ぐには「禁止事項・手順・メッセージ形式」の3点を明文化し、.cursor/rules や CLAUDE.md に記述することが重要です。チケット番号を先頭に入れる、git add .を禁止するなど、具体的なルール設定で追跡性が大幅に向上します。

