Contextual Commits: Gitコミットに「なぜ（WHY）」を記録するための新しいオープン標準

概要

Gitのコミットメッセージに、変更内容だけでなく、意思決定の背景や却下した代替案などの「理由」を構造化して記録し、AIエージェントや開発者の文脈理解を助ける新しい規約。

詳細内容

Contextual Commitsは、従来のConventional Commitsを拡張し、Gitのコミット履歴に「なぜその変更が行われたのか」という意思決定の軌跡を埋め込むための標準規格です。AIコーディングエージェントとのセッションが終了すると、なぜそのアプローチが選ばれ、何が試され、何が却下されたかという重要な文脈が失われてしまうという課題を解決します。この規格では、コミットの本文に `intent` (意図)、`decision` (決定)、`rejected` (却下案)、`constraint` (制約)、`learned` (知見) という5つの型付きアクションラインを使用します。これにより、将来のAIエージェントや人間が `git log` を通じて過去の文脈を正確に把握でき、同じ失敗の繰り返しを防ぐことが可能になります。既存のツールやワークフローを壊すことなく、AI時代の開発における「文脈の蓄積」をGitリポジトリ内で完結させる実用的なアプローチです。

元記事を読む他のサマリーを見る