inkblot-branch-naming

Inkblot のブランチ命名規則

この規則が必須となるのは、作業に Jira チケットがある場合のみです。チケットがない場合は、プレフィックスを勝手に付けたり、チケットを求めたり、名前を制限したりしないでください。

チケットがある作業（必須）

ブランチ名は、Jira の完全なキーを小文字にして先頭に付けます。feat/、fix/、feature/ のようなプレフィックスは付けないでください。

<ticket-id>-<short-kebab>

1. 完全なキーを小文字にし、主チケットは1つにします（例：pod2-2291。2-2291 ではありません）
2. kebab-case は小文字で、3～5語にします。チケットのタイトルではなく、変更内容を表してください
3. GitHub のブランチ一覧で読みやすいよう、名前全体を短く保ちます（約50文字）

例

• pod2-2291-video-call-no-show
• pod1-3452-company-renewal-dates
• pod1-3459-coaching-duration-options

禁止事項（チケットがある作業のみ）

• チケット ID の前にプレフィックスを付けないでください（fix/pod2-2291-…、feat/…、feature/…、bf-…）
• プロジェクトキーを短縮しないでください（2-2291-…、1-3452-…）
• ブランチ名に大文字を使わないでください（POD2-2291-…）
• 名前にイニシャルを入れないでください（ji-pod1-2178-…）
• 対象環境を末尾に付けないでください（-qa、-master）
• チケット ID を並べないでください（pod2-2276-2277-2282-…）。主チケットを使用してください
• Jira のタイトル全体を kebab-case にして入れないでください

チケットがない場合

命名規則はありません。hotfix/7.54.2、sync/…、qa-kuma など、どのような名前でも問題ありません。

理由

• チケットを先頭にし、種別プレフィックスを付けない： Jira と git grep では、キーが先頭にある必要があります。feat/ や fix/ を付けても長くなるだけです。
• 完全なキーを小文字にする： pod2-2291 も Jira のキーです（リンクは機能します）。小文字にすることで、macOS と Linux の大文字・小文字の区別による問題を避けられます。2-2291 は Jira のキーではないため、GitHub と Jira はブランチを関連付けません。
• チケットがある場合にのみ適用： チケットのない雑務、同期、ホットフィックスを、エージェントによって阻止されたり、名前を変更されたりしないようにします。
• 短い kebab-case： GitHub では長いブランチ名が省略されます。チケットのタイトルはすでに Jira にあります。