私の Claude Code Git ワークフロー: 小規模なコミット、クリーンな履歴、ゼロの恐怖

このワークフローを構築する前、私の AI 支援セッションでは、まさに皆さんが恐れているようなもの、つまり「修正作業」というタイトルの 800 行のコミットが生成されました。 Claude Code は優れたコミット メッセージを書き込みますが、それは各コミットが 1 つの一貫した変更となるようにセッションを構造化している場合に限られます。

作業単位はタスクであり、私はそれを明確に述べます。「私たちがやっているのは 1 つです。それは、電子メール検証を共有モジュールに抽出することです。」他には何もありません。』クロードは、発見した他の 3 つのバグを喜んで修正します。これらの善意の迂回路はすべて、誰もレビューできない差分を取得する方法です。関連するバグはリストに記載され、セッションの外で後で紙に書かれます。

タスクの合間に、私はクロードに儀式を実行してもらいます。テスト、次に差分をステージングし、次に「差分からのコミット メッセージ (従来のコミット) を 72 文字以内で書く」というものです。セッション コンテキストにはタスクが 1 つだけ含まれているため、メッセージは正確です。差分が小さいため、メッセージは具体的です。これがすべてのトリックであり、完全にセッションの規律に関するものです。

エージェントにとってブランチ戦略はそれ以上に重要であり、それ以上に重要です。私は機能ブランチに取り組み、マージ前にクロードをレビュー担当者にします。「懐疑的なシニア エンジニアとして、メインとの完全なブランチの差分をレビューします。」コミット 2 で追加され、コミット 5 で放棄されたヘルパーなど、単一の差分レビューでは見逃されるクロスコミットの問題を検出します。

驚くべき利点は考古学的なものでした。 6 か月が経ち、私のこれまでの歴史は、まるで人間のプロジェクトがうまく運営されているかのように見えます。すべての変更は 1 行で説明でき、すべての変更は元に戻ります。クロード コードのセッションがコミットされた小さなタスクとして構成されている場合、AI の広範囲にわたる傾向は、技術的負債になるのではなく、ドキュメントに反映されます。