Developing Release

リリースワークフロー

品質ゲート→バージョンバンプ→CHANGELOG 生成→git commit + tag を一貫して実行する。

リリースを自動化する価値は「いつでもリリースできる」状態を維持すること。手作業によるミスを排除し、品質ゲートで最低品質を保証する。

参照ドキュメント

• @docs/reference/リリースガイド.md — リリースワークフロー全体

オプション

リリースフロー

1. ドライラン: CHANGELOG プレビューとバージョン計算を確認する
2. リリース種別選択: patch / minor / major を選択する
3. 品質ゲート（preflight）: 全チェックを通過する
4. リリース実行: バージョンバンプ→CHANGELOG 生成→commit + tag
5. リモートプッシュ: コミットとタグをプッシュする
6. プルリクエスト作成: リリースブランチからメインブランチへの PR を作成し、CHANGELOG の差分をレビューする
7. デプロイ: 必要に応じて本番デプロイを実行する

品質ゲート（preflight）

リリース前に以下のチェックを直列実行する。全チェック通過が必須。

バージョニング規則

Semantic Versioning に従う。

モノレポ構成の場合、全パッケージのバージョンを同期管理する。

CHANGELOG 生成ルール

Conventional Commits に基づいて自動生成する。

直近の git tag から HEAD までのコミットを対象とする。タグが存在しない場合は全コミット履歴を対象とする。

リリース実行ステップ

途中から再開

リリース作業の途中から再開する場合は、現在の状態を確認する。

Example:

ユーザー: 「品質ゲートは通った。リリースを実行したい」
回答: --preflight の結果を確認し、全チェック通過を検証する。
      --patch / --minor / --major のいずれかでリリースを実行する。

トラブルシューティング

• working tree がクリーンでない: 変更をコミットまたは git stash してからリリース再実行する
• テスト失敗: テストを修正してからリリースを再実行する
• リリースを元に戻したい: リモートプッシュ前なら git tag -d vX.X.X && git reset --hard HEAD~1

コンテキスト管理

品質ゲート完了後、CHANGELOG 生成後、リリースコミット完了後に /compact を実施する。

注意事項

• ビルドツール・パッケージマネージャーがセットアップ済み、依存関係インストール済みであること（前提条件）
• working tree がクリーンでないとリリース不可
• リリース前に必ずドライランで内容を確認する
• Conventional Commits でコミットメッセージを記述し CHANGELOG の品質を確保する

関連スキル

• git-commit — Conventional Commits 準拠のコミット作成
• managing-operations — デプロイ・運用管理
• planning-releases — リリース・イテレーション計画
• orchestrating-development — 開発フェーズ全体のワークフロー

Converted and distributed by TomeVault — claim your Tome and manage your conversions.