Claudeのプロジェクトサマリーをリポジトリにチェックインしよう — 人間のドキュメントより優れている

HNの開発者が実践的なワークフローを共有している：Claudeをプロジェクトで使用した後、解決したことや変更点について構造化された高レベルのサマリーを書くように依頼し、レビューしてからリポジトリにコミットする。そのサマリーの品質は開発者自身が書くものに匹敵するが、所要時間は1時間ではなく10秒であり、レビューにも1時間はかからない。

投稿のポイント：

• Claudeの引き継ぎ文書を捨てないで。PROJECT.md などとしてコミットしよう。
• Claudeはプロジェクトの終了時にゼロから新しい概要を書くこともできる。
• 開発者はコミット前に必ず自分でレビュー・編集する — 人間のプログラマーの作業と同じだ。
• 注意点：Claudeが以前のサマリーから「承認者」のパラグラフを新しいサマリーにコピーしてしまった。これを防ぐには CLAUDE.md に指示を追加する。
• このアドバイスは自明ではないが、著者はプロジェクトの継続性にとって画期的だと感じている。

実用的な教訓：Claudeを多用したプロジェクトの終了時には、必ずサマリーを生成させてコミットしよう。それが次の開発者、あるいは将来の自分自身の、git履歴を掘り返す時間を何時間も節約してくれるかもしれない。