deploy

デプロイ

トランクからステージングまたは本番環境に Web アプリをデプロイします。ゲート、検証、ロールバック手順を含みます。

コントラクト

入力：

• リポジトリのルート
• 対象環境：preview、staging、production
• 任意のブランチ、PR 番号、デプロイプロバイダー、ヘルスチェック URL

出力：

• デプロイ前のゲート結果
• デプロイ経路とプロバイダー
• 検証ステータス
• 必要に応じたロールバックまたはフォローアップの手順

作成／変更：

• デプロイ前に失敗したゲートを修正する場合に限り、ローカルの変更
• リリース PR またはタグは release スキルを通じてのみ作成

外部への副作用：

• プロバイダーのデプロイがトリガーされる場合があります
• 委任されたリリーススキルを通じて、GitHub PR が作成または更新される場合があります
• ログや監視システムを読み取る場合があります

確認が必要な操作：

• 本番環境へのデプロイ前
• リリース PR のマージ前
• ロールバックコマンドの実行前
• 強制プッシュまたは履歴の書き換え前

委任先：

• インストール済みスキルディレクトリ内のプレイブックを読み、従って委任先を実行します （/<router> <action>：<router>/references/<action>.md、/<name>：<name>/SKILL.md）。 ここにあるスキルはユーザーが呼び出す場合に限られるため、Skill ツールでは読み込めません。
• トランク SHA のゲート確認とリリースの作成には release
• 失敗した GitHub Actions のチェックには /git ci

ローカル品質ゲート（必須）

すべてのデプロイ前に、リポジトリ固有のフォーマット、lint、型チェック用スクリプトを実行します（テストとビルドが設定されている場合は、それらも実行します）。package.json から実際のスクリプト名を確認し、推測したり、パッケージマネージャーを連結したりしないでください（デフォルトでは Bun など、リポジトリ固有のものを使用します）。プッシュまたはデプロイの前に失敗を修正します。プロバイダーの CLI をローカルで実行するより、CI 主導のデプロイを優先します。

プロセス

ステージング

1. トランクの CI が成功していることを確認します。
2. トランクからステージングへのデプロイをトリガーします（ステージングブランチは使用しません）。
3. CI とステージングのヘルスチェックが成功するまで待ちます。

本番環境

1. ステージングが正常であることを確認します。
2. 明示的な確認を必須とします。 本番環境は重要です。
3. トランクから本番環境にデプロイします。
4. デプロイを監視します。ヘルスエンドポイントとエラートラッキングを15分間確認します。

ホットフィックス

トランク（デフォルトブランチ）から hotfix/xxx ブランチを作成し、修正して、トランクへの PR を作成し、マージしてから本番環境にデプロイします。

デプロイ後の検証

1. ヘルスエンドポイントを確認します。
2. エラートラッキング（Sentry など）を確認します。
3. 重要なユーザーフローを検証します。
4. デプロイログを確認します。

ロールバック

デプロイに失敗した場合は、マージコミットを取り消して再デプロイします。

参考資料

references/workflow.md には、プラットフォーム固有のデプロイ詳細、AWS のパターン、CI/CD 連携、ロールバック手順が記載されています。コマンド例は汎用的なプレースホルダーです。リポジトリ固有のパッケージマネージャーとスクリプトに置き換えてください。