Problem / outcome
org 横断 CI/CD ポリシー文書が実装より2世代古く、実現不可能な要件を要求し続けている。SSoT が実装と食い違うと、これを読んだ人間およびエージェントが誤った判断をする。
Evidence / current behavior
.github/policies/ci-cd-trigger-strategy.md にて:
- line 18 — 「Production deploy = 手動のみ(
workflow_dispatch + environment: prd required reviewers)」と記載。実装は 2026-07 に frontend の auto-promote へ移行済み(agiletec/.github/workflows/deploy-frontend.yml:24-34、agiletec/CLAUDE.md §0c で「人手プロモート撤回」と確認済み)。Supabase だけが例外として §3 / line 19 に書かれているが、frontend の例外は記載が無い。
- line 105 — 「For repos with prod deploy:
environment: prd with required reviewers」。この機能は private repo では GitHub Enterprise Cloud が必要で、Team plan では永久に発火しない。agiletec/.github/workflows/deploy-supabase.yml:308-309 で agiletec 側は既に自認済みだが、ポリシー文書は要件として書き続けている。
- line 132-136(Implementation status, 2026-06-12)— 「prd は Cloudflare(frontend promote = 中井手動)」と記載。実装(2026-07-01 auto-promote 復活)と食い違う。
- org-level "required workflows"(旧 beta 機能)に依存した記述がある場合、その機能は廃止済みで repository rulesets に統合されている。文書中の該当箇所を確認して是正する。
公式根拠(実装前に再確認すること)
Scope
- 本番デプロイの記述を実装に追随させる(agiletec frontend = main マージで全自動 @100% promote、kill switch
AUTO_PROMOTE_ENABLED、preview smoke → promote → live smoke → 自動ロールバック)。agile-server 側は自動 sync だが post-sync smoke / 自動ロールバックが無い、という非対称も明記する。
environment: prd + required reviewers の要件を削除する。Team plan で実現できない要件を SSoT に残さない。 代替として deployment branch policy(main のみ)を要件として記載する。
- Implementation status 節を現状に更新するか、陳腐化する運命の節として削除する。日付付きスナップショットを残すなら、更新責任の所在を明記する。
- org-level required workflows への依存記述があれば rulesets 前提へ書き換える。
- 文書を読んだだけで「どのゲートが機械強制で、どれが運用ルールか」が判別できる構成にする。
Non-goals
- 実装側の変更(各 workflow の修正は agiletec 側の個別Issueで扱う)。
- Enterprise plan へのアップグレード判断。
- 新しい規範の追加(本Issueは既存記述の実装追随のみ)。
Acceptance criteria
Verification plan
| Check |
Command / evidence |
Pass condition |
| 実現不可能要件の除去 |
rg -i 'required reviewers' .github/policies/ |
要件としての記載が無い |
| 実装との一致 |
agiletec 側 workflow との突合 |
記述と実装が一致 |
| 廃止機能 |
rg -i 'required workflows' .github/policies/ |
rulesets 前提の記述のみ |
| ゲート実在性 |
PR 本文の確認記録 |
全ゲートに根拠あり |
Risks / dependencies
- この文書は org 横断の SSoT であり、他 repo の判断にも影響する。実装を確認せずに書き換えない(今回の問題そのものの再発になる)。
- agiletec 側の個別Issue(deployment branch policy 設定など)が完了する前に「設定済み」と書くと、また文書が先走る。実装完了後に記述するか、未完了であることを明記する。
Problem / outcome
org 横断 CI/CD ポリシー文書が実装より2世代古く、実現不可能な要件を要求し続けている。SSoT が実装と食い違うと、これを読んだ人間およびエージェントが誤った判断をする。
Evidence / current behavior
.github/policies/ci-cd-trigger-strategy.mdにて:workflow_dispatch+environment: prdrequired reviewers)」と記載。実装は 2026-07 に frontend の auto-promote へ移行済み(agiletec/.github/workflows/deploy-frontend.yml:24-34、agiletec/CLAUDE.md§0c で「人手プロモート撤回」と確認済み)。Supabase だけが例外として §3 / line 19 に書かれているが、frontend の例外は記載が無い。environment: prdwith required reviewers」。この機能は private repo では GitHub Enterprise Cloud が必要で、Team plan では永久に発火しない。agiletec/.github/workflows/deploy-supabase.yml:308-309で agiletec 側は既に自認済みだが、ポリシー文書は要件として書き続けている。公式根拠(実装前に再確認すること)
cancel-in-progressを使わない形。https://docs.github.com/en/actions/how-tos/deploy/configure-and-manage-deployments/control-deploymentsScope
AUTO_PROMOTE_ENABLED、preview smoke → promote → live smoke → 自動ロールバック)。agile-server 側は自動 sync だが post-sync smoke / 自動ロールバックが無い、という非対称も明記する。environment: prd+ required reviewers の要件を削除する。Team plan で実現できない要件を SSoT に残さない。 代替として deployment branch policy(main のみ)を要件として記載する。Non-goals
Acceptance criteria
environment: prd+ required reviewers の要件が削除され、Team plan で実際に機能する代替(deployment branch policy)が記載されている。Verification plan
rg -i 'required reviewers' .github/policies/rg -i 'required workflows' .github/policies/Risks / dependencies