caveman-commit

コミットメッセージは簡潔かつ正確に。Conventional Commits形式。無駄な説明は不要。「何」よりも「なぜ」を優先。

ルール

サブジェクト行:

• <type>(<scope>): <imperative summary> — <scope> はオプション
• Types: feat, fix, refactor, perf, docs, test, chore, build, ci, style, revert
• 命令形：「add」「fix」「remove」— 「added」「adds」「adding」ではなく
• 可能な限り ≤50 文字、最大 72 文字
• 末尾にピリオドなし
• コロン後の大文字化はプロジェクト慣例に合わせる

本文（必要な場合のみ）:

• サブジェクト行が自明な場合はスキップ
• 本文を追加する場合：非自明な「なぜ」、破壊的変更、マイグレーション注記、リンクされた Issue
• 72 文字でラップ
• 箇条書きは - で、* ではなく
• Issue/PR への参照は末尾に：Closes #42, Refs #17

絶対に含めてはいけないこと:

• 「このコミットは X を行う」「I」「we」「now」「currently」 — diff がそれを示している
• 「As requested by...」 — Co-authored-by トレーラーを使用
• 「Generated with Claude Code」や AI への帰属表示
• 絵文字（プロジェクト慣例で必須の場合を除く）
• scope ですでに説明されているファイル名の繰り返し

例

Diff：「なぜ」を説明する本文を含むユーザープロフィール用エンドポイント

• ❌ "feat: add a new endpoint to get user profile information from the database"
• ✅

  feat(api): add GET /users/:id/profile
  
  Mobile client needs profile data without the full user payload
  to reduce LTE bandwidth on cold-launch screens.
  
  Closes #128
  

Diff：破壊的 API 変更

• ✅

  feat(api)!: rename /v1/orders to /v1/checkout
  
  BREAKING CHANGE: clients on /v1/orders must migrate to /v1/checkout
  before 2026-06-01. Old route returns 410 after that date.
  

自動明確化

常に本文を含める対象：破壊的変更、セキュリティ修正、データマイグレーション、先行コミットを revert するもの。これらをサブジェクト行のみに圧縮しないこと — 将来のデバッガーがコンテキストを必要とする。

境界線

コミットメッセージの生成のみ。git commit の実行、ファイルのステージング、amend は行わない。貼り付ける準備ができたコードブロックとしてメッセージを出力。「stop caveman-commit」または「normal mode」：詳細なコミットスタイルに戻す。