Skip to content

policy: ci-cd-trigger-strategy.md を実装に追随させる(実現不可能なrequired reviewers要件の除去・auto-promote反映) #22

Description

@kazukinakai

Problem / outcome

org 横断 CI/CD ポリシー文書が実装より2世代古く、実現不可能な要件を要求し続けている。SSoT が実装と食い違うと、これを読んだ人間およびエージェントが誤った判断をする。

Evidence / current behavior

.github/policies/ci-cd-trigger-strategy.md にて:

  1. line 18 — 「Production deploy = 手動のみ(workflow_dispatch + environment: prd required reviewers)」と記載。実装は 2026-07 に frontend の auto-promote へ移行済み(agiletec/.github/workflows/deploy-frontend.yml:24-34agiletec/CLAUDE.md §0c で「人手プロモート撤回」と確認済み)。Supabase だけが例外として §3 / line 19 に書かれているが、frontend の例外は記載が無い。
  2. 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 側は既に自認済みだが、ポリシー文書は要件として書き続けている。
  3. line 132-136(Implementation status, 2026-06-12)— 「prd は Cloudflare(frontend promote = 中井手動)」と記載。実装(2026-07-01 auto-promote 復活)と食い違う。
  4. org-level "required workflows"(旧 beta 機能)に依存した記述がある場合、その機能は廃止済みで repository rulesets に統合されている。文書中の該当箇所を確認して是正する。

公式根拠(実装前に再確認すること)

Scope

  1. 本番デプロイの記述を実装に追随させる(agiletec frontend = main マージで全自動 @100% promote、kill switch AUTO_PROMOTE_ENABLED、preview smoke → promote → live smoke → 自動ロールバック)。agile-server 側は自動 sync だが post-sync smoke / 自動ロールバックが無い、という非対称も明記する。
  2. environment: prd + required reviewers の要件を削除する。Team plan で実現できない要件を SSoT に残さない。 代替として deployment branch policy(main のみ)を要件として記載する。
  3. Implementation status 節を現状に更新するか、陳腐化する運命の節として削除する。日付付きスナップショットを残すなら、更新責任の所在を明記する。
  4. org-level required workflows への依存記述があれば rulesets 前提へ書き換える。
  5. 文書を読んだだけで「どのゲートが機械強制で、どれが運用ルールか」が判別できる構成にする。

Non-goals

  • 実装側の変更(各 workflow の修正は agiletec 側の個別Issueで扱う)。
  • Enterprise plan へのアップグレード判断。
  • 新しい規範の追加(本Issueは既存記述の実装追随のみ)。

Acceptance criteria

  • AC-1: 「Production deploy = 手動のみ」の記述が、実装どおりの自動 promote の説明に置き換わっている。
  • AC-2: environment: prd + required reviewers の要件が削除され、Team plan で実際に機能する代替(deployment branch policy)が記載されている。
  • AC-3: Implementation status 節が現状と一致しているか、削除されている。
  • AC-4: org-level required workflows への依存記述が残っていない(存在した場合)。
  • AC-5: 各ゲートについて「機械強制」か「運用ルール」かが文書上で判別できる。
  • AC-6: 記載された全ての機械強制ゲートについて、それが実在することを確認したコマンドまたは根拠が PR 本文に記録されている。

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 設定など)が完了する前に「設定済み」と書くと、また文書が先走る。実装完了後に記述するか、未完了であることを明記する。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions