developing-release

name: developing-release description: アプリケーションのリリースワークフロー。品質ゲート、バージョンバンプ、CHANGELOG 生成、git commit + tag を一貫実行。リリース作業やバージョン管理時に使用。

リリースワークフローガイド

品質ゲート → バージョンバンプ → CHANGELOG 生成 → git commit + tag を一貫して実行するリリースワークフローを支援します。

Instructions

1. 参照ドキュメント

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

2. リリースフロー

リリースは以下の順序で実行します:

ドライラン: CHANGELOG プレビューとバージョン計算を確認
リリース種別選択: patch / minor / major を選択
品質ゲート（preflight）: 全チェックを通過
リリース実行: バージョンバンプ → CHANGELOG 生成 → commit + tag
リモートプッシュ: コミットとタグをプッシュ
デプロイ: 必要に応じて本番デプロイ

3. オプション

なし : ドライランを実行（デフォルト）
--dry-run : CHANGELOG プレビュー + バージョン計算
--patch : パッチリリース（バグ修正）
--minor : マイナーリリース（新機能追加、後方互換あり）
--major : メジャーリリース（破壊的変更）
--preflight : 品質ゲートのみ実行
--deploy : リリース + デプロイ（--patch / --minor / --major と併用）

4. 基本例

# ドライラン（プレビュー）
npm run release:dry-run

# パッチリリース
npm run release:patch

# マイナーリリース
npm run release:minor

# メジャーリリース
npm run release:major

# 品質ゲートのみ実行
npm run release:preflight

# パッチリリース + デプロイ
npm run release:deploy:patch

5. 品質ゲート（preflight）

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

チェック	コマンド	内容
working tree クリーン	`release:preflight:clean`	未コミット変更がないこと
静的解析	`release:preflight:lint`	lint エラーがないこと
ユニットテスト	`release:preflight:test`	全テストパス
ビルド確認	`release:preflight:build`	ビルド成功
E2E テスト	`release:preflight:e2e`	E2E テスト全パス

6. バージョニング規則

Semantic Versioning に従います:

種類	変更例	バージョン変化
`patch`	バグ修正、軽微な改善	`0.1.0` → `0.1.1`
`minor`	新機能追加（後方互換あり）	`0.1.0` → `0.2.0`
`major`	破壊的変更	`0.1.0` → `1.0.0`

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

7. CHANGELOG 生成ルール

Conventional Commits に基づいて自動生成:

prefix	カテゴリ
`feat`	Features
`fix`	Bug Fixes
`docs`	Documentation
`refactor`	Refactoring
`test`	Tests
`chore`	Chores
`perf`	Performance
`ci`	CI
`style`	Styles
`build`	Build

直近の git tag から HEAD までのコミットを対象
タグが存在しない場合は全コミット履歴を対象
CHANGELOG.md の先頭に新しいエントリを追加

8. リリース実行ステップ

ステップ	内容
[1/4] バージョン更新	対象パッケージのバージョンをセマンティックバージョニングに従って更新
[2/4] CHANGELOG 生成	直近タグから HEAD までのコミットを分類し CHANGELOG.md を生成
[3/4] git commit + tag	変更ファイルをステージング → `release: vX.X.X` でコミット → `vX.X.X` タグ作成
[4/4] サマリー表示	バージョン変化、タグ名、次のステップを表示

9. トラブルシューティング

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

10. コンテキスト管理

長時間のリリースセッションでは Context limit reached エラーを回避するため、タスクの区切りごとに /compact を実施してコンテキストを圧縮する。

/compact を実施するタイミング:

品質ゲート（preflight）の実行が完了したとき
バージョンバンプと CHANGELOG 生成が完了したとき
リリースコミット・タグ作成が完了したとき
デプロイ完了後

運用ルール:

/compact 実施前に、現在のリリース状態と次のステップをメモとして出力する
/compact 実施後、次のステップの作業を継続する

11. 注意事項

前提条件: ビルドツール・パッケージマネージャーがセットアップ済み、依存関係インストール済み
制限事項: working tree がクリーンでないとリリース不可
推奨事項: リリース前に必ずドライランで内容を確認

12. ベストプラクティス

ドライランファースト: 必ずドライランで CHANGELOG プレビューを確認してからリリース
品質ゲート厳守: preflight の全チェックを通過させてからリリース実行
セマンティックバージョニング: 変更内容に応じた適切なバージョン種別を選択
Conventional Commits: コミットメッセージを規約に従って記述し CHANGELOG の品質を確保
段階的デプロイ: リリースとデプロイを分離し、必要に応じてデプロイを実行