spatie-version-control

Spatie のバージョン管理ガイドライン

概要

一貫したリポジトリ管理のために、Spatie の Git およびバージョン管理の規約を適用します。

適用するタイミング

• コミット、ブランチ、プルリクエストを作成するときに、このスキルを適用します。
• 新しいリポジトリに名前を付けるときに、このスキルを適用します。
• ブランチ戦略やマージ戦略を決めるときに、このスキルを適用します。

対象範囲

• 対象：Git 操作、リポジトリの命名、ブランチの命名、コミットメッセージ、マージ戦略。
• 対象外：コードスタイル、デプロイパイプライン、CI/CD の設定。

ワークフロー

1. 関連する Git 操作またはリポジトリの規約を特定します。
2. references/spatie-version-control-guidelines.md を読み、関連するセクションに注目します。
3. ブランチ、コミット、マージ、クリーンアップに関するガイダンスより先に、プロジェクトの段階に応じたルールを適用します。

基本ルール（概要）

• サイトのリポジトリには小文字のドメイン名（www などを除く）を付け、その他のリポジトリにはケバブケースを使用します。
• リリース後は main を安定したデプロイ可能な状態に保ち、古くなったブランチを削除します。
• 初期開発では develop を使用し、プロジェクトの稼働開始後はフィーチャーブランチを使用します。
• ブランチ名には小文字とハイフンのみを使用します。
• 説明的で現在形の、粒度の細かいコミットを作成します。
• 定期的にリベースし、マージ時には通常、フィーチャーブランチをスカッシュします。
• 履歴を書き換える Git コマンドや破壊的な Git コマンドは、リファレンスに記載された注意事項に従って扱います。

リファレンス

• references/spatie-version-control-guidelines.md