bagisto-git-workflow

Git ワークフロー

一般的な Git ガイドではなく、リポジトリの履歴から読み取った、このリポジトリが実際に従っている規約です。

ブランチ

<author>/<topic> または <author>/<type>/<topic> の形式で、小文字とハイフンを使用します。

devansh-webkul/themes-improvements
kartikeywebkul9260/v2.4_file_attribute_required_validation
Vansh-Sharmaa/fix/duplicate-product-customizable-options

対象とするリリースブランチから分岐します。2.4 の作業なら 2.4、次のメジャーリリース向けなら master から分岐し、同じブランチを対象にプルリクエストを作成します。2.4 や master に直接コミットしてはいけません。

コミット

Conventional Commits に従い、件名は小文字で、命令形または説明的な表現にします。直近 200 件のコミットでは、fix: が 66 件、feat: が 21 件、chore: が 9 件、chore(deps): が 5 件、test: が 3 件、refactor(shop): が 1 件、docs: が 1 件です。

fix: grouped themes into two parts my theme and buy themes
feat: playwight testcases updated and draft issue fixed
test: playwright testcases added
chore: changelog and version updated

スコープは省略可能で、使用は控えめです。例：refactor(shop):、chore(deps):。

件名だけで理由を伝えられない場合に限り、本文を書きます。直近 100 件の非マージコミットのうち、本文があるのは 12 件です。本文では差分から分かる内容ではなく、理由を説明します。また、このコードベースではメソッド本体内にコメントを書かないため、コード内のコメントとして書こうとしていた内容は本文に記載します。

AI やツールのクレジットを追加してはいけません。 アシスタントの Co-Authored-By、「Generated with」、ロボットの絵文字は禁止です。このリポジトリの履歴には一切なく、今後も追加してはいけません。

CHANGELOG

CHANGELOG.md は ## Unreleased で始まり、その後にリリースごとのセクションが続きます。

## Unreleased

- Entry.

## **v2.4.9 (5th of August 2026)** - *Release*

- Entry.

各項目は - で始め、項目の間には空行を入れます。アップグレードするユーザー向けに、完全な文で書きます。 ユーザーに見える効果を記載してください。コミットの件名や差分の要約ではありません。

別のタブに検索結果があると、メガ検索で結果のないタブが表示され、何も見つからなかったように見える問題を修正しました。これからは、一致した最初のタブが開きます。

各項目は最大 2 行で、明快かつ簡潔にします。 これは厳守すべき上限で、次のどちらの形式にも適用されます。

形式	使用する場合
- <prose>	機能、または報告された問題を伴わない変更
- #11432 [fixed] - <prose>	報告された問題の修正

ユーザーに見える効果を伝えたら、それ以上は書きません。原因、内部の仕組み、経緯は CHANGELOG に記載する内容ではありません。コミットメッセージまたはプルリクエストに記載してください。変更を調査する人はそこを確認します。2 行に収まらない項目には、本来そちらに記載すべき説明が含まれています。

- Fixed the admin product listing repeating a product once for every channel it is carried by.

- Fixed the admin product listing repeating a product once for every channel it is carried by, so a
  store with three channels listed it three times. The PostgreSQL work had widened the grouping from
  the product to every selected column, which made the channel part of the group; it now picks one
  row per product.        ← the cause belongs in the commit message, not here

項目は ## Unreleased の下に追加します。バージョン見出しや日付を独自に作成してはいけません。リリースは別途作成されます。

プルリクエスト

履歴に残っているとおり、GitHub のデフォルトの件名でマージします。

Merge pull request #11426 from devansh-webkul/themes-improvements

説明には、何を変更したか、なぜ変更したかを記載します。また、設定のデフォルト値、マイグレーション、後回しにした追加対応など、レビュー担当者が差分から確認できない内容も明記します。作成前に検証ゲートを実行し、どれを実行してどれをスキップしたかを説明に記載してください。

ルール

• 依頼されない限り、コミット、プッシュ、PR の作成をしてはいけません。 作業はツリー内に残し、何が準備できているかを伝えてください。
• 共有ブランチに --force でプッシュしてはいけません。 公開済みの履歴を書き換えてはいけません。
• .env、認証情報、vendor/、node_modules/、public/themes/*/build/ 以下のビルド出力をコミットしてはいけません。
• 1 つのコミットには、論理的にまとまった変更を 1 つだけ含めます。 修正と無関係なリファクタリングは別々にコミットし、それぞれ単独で取り消せるようにします。
• 承認なしに Composer または npm の依存関係を追加・削除してはいけません。 意図しないロックファイルの変更もコミットしてはいけません。
• 先に検証ゲートを実行してください。 Pint またはテストに失敗するコミットは、CI に失敗するコミットです。

必須のサブスキル： 変更を完了とする前に、bagisto-change-verification を使用してください。