日本人エンジニアの「コメント山盛り」あるある、AI時代に改善してみた
AI要約
日本人エンジニアは英語のコードに日本語コメントを大量に付ける習慣があります。しかし、AIがコードを読む時代には不要です。ステップ番号コメント・関数名の日本語翻訳・冗長なdocstringなど4つの「あるある」をClaudeとの実例で改善。コードの可読性とAI時代の効率を両立させるアプローチが学べます。
AI要約
日本人エンジニアは英語のコードに日本語コメントを大量に付ける習慣があります。しかし、AIがコードを読む時代には不要です。ステップ番号コメント・関数名の日本語翻訳・冗長なdocstringなど4つの「あるある」をClaudeとの実例で改善。コードの可読性とAI時代の効率を両立させるアプローチが学べます。
Cursor や Claude Code などのAIエージェントをチームで使うと、コミットルールが崩れやすくなります。これを防ぐには「禁止事項・手順・メッセージ形式」の3点を明文化し、.cursor/rules や CLAUDE.md に記述することが重要です。チケット番号を先頭に入れる、git add .を禁止するなど、具体的なルール設定で追跡性が大幅に向上します。

