CI 運用方針（品質ゲート）

本ドキュメントは 意図した CI 設計 の正本です。Issue #2002（Actions 課金上限）への対応として採用しています。

AI エージェント・Copilot レビュー: コードレビューや PR コメントで CI を提案するときは、必ず本ページの「推奨しない変更」を守ること。

背景

項目	方針
ワークフロー	`ci-quality-gate.yml` 1 本（6 種チェックを 1 ジョブで順次実行）
GitHub Actions トリガー	`pull_request`: `opened` / `reopened` / `ready_for_review` のみ
追加 push（`synchronize`）	CI を自動起動しない（意図的）
`develop` への merge 後 push	品質 CI は走らない（`deploy-docs` 等は別）
マージ前の検証	workflow_dispatch（Run workflow）で PR head を検証
開発中の品質確認	ローカルで個別またはまとめて実行

以下は リグレッション または 課金再燃 になりうるため、Issue #2002 の意図に反します。

pull_request に synchronize を戻す、または types 未指定で全 PR イベントにする
→ 毎 push で CI が走り、旧運用と同様に分数が増える
品質チェック用に push: branches: [develop] を追加する
→ PR と merge 後の二重実行になる
6 本の個別ワークフローに再分割する（各々が composer install する）
→ 1 回の検証あたりの分数が増える
Merge Queue / merge_group のみを前提にした手順を、現プランでは唯一の解として勧める
→ 個人無料プライベートでは設定できない
「CI が付いていないから push ごとにチェックを足すべき」という指摘を、設計ミスとして扱う
→ 追加 push で Checks が付かないのは仕様。対処は Run workflow とローカルチェック
追加 push 後の検証に「Re-run all jobs」だけを勧める
→ Re-run は 元の workflow run と同じコミット SHA を再実行するだけ。最新 head を検証するには Actions → CI Quality Gate → Run workflow（pr_number 入力または PR ブランチ選択）を使う

状況	推奨
PR に push した直後	ローカルで `composer quality-check` / `composer test` / `npm run format:check`
マージ前	Actions → CI Quality Gate → Run workflow（`pr_number` または PR ブランチ）
CI 失敗の修正後	修正を push → Run workflow（自動では再実行されない）
ワークフロー変更の PR	マージ後に Ruleset の必須チェック名が `CI Quality Gate / Quality Gate` か確認

チェック	コマンド
PHPCS	`composer lint`
PHPStan + Deptrac	`composer ci-static-check`
PHPUnit	`composer test`
PSR-4	`composer psr4`
Format	`npm run format:check`
まとめ（PHPUnit 除く）	`composer quality-check` または `./bin/run_local_quality_check.sh`

CI トリガーを変える PR を出すときは、次を PR 説明に書くこと: