Commit Intent

製品概要

• AIチャットの意図を docs/intents/ に落とし込み、コードと同じコミットに添付するプリコミットフック
• 変更理由を失わず What と Why を同時に追跡する新しい実践

仕組み

• セッション転記をステージ済みファイルと照合
• Claude Code CLI を使って意図を Markdown に要約
• コードと同じコミットに追加され、後の理解を支援

技術的留意点

• AIセッションが対象でなければ効果は限定的
• 意図の品質は抽出の精度に依存
• 意図ドキュメントを計画ドキュメントと分離すべきか、統合すべきかはコミュニティの意見待ち

補足

• 用途の透明性とメンテナンス性の向上を狙い、長期的なプロジェクトの文脈保持を支援します。
• 導入前の検討材料として、サンプルの設計案も提供できる可能性があります。