From 4cd3b51f978ad82500d89fb6a2aa120ee0c8028e Mon Sep 17 00:00:00 2001 From: "Mr. Q" <97194984+ToolboxAid@users.noreply.github.com> Date: Sun, 21 Jun 2026 15:14:46 -0400 Subject: [PATCH] PR_26172_OWNER_021 ProjectInstructions release gate --- .../dev/ProjectInstructions/RELEASE_GATE.md | 40 +++++++++++++++ ...e-gate-instruction-compliance-checklist.md | 15 ++++++ ...ns-release-gate-manual-validation-notes.md | 9 ++++ ...-projectinstructions-release-gate-tree.txt | 22 ++++++++ ...ER_021-projectinstructions-release-gate.md | 27 ++++++++++ .../dev/reports/codex_changed_files.txt | 11 ++-- docs_build/dev/reports/codex_review.diff | 50 ------------------- 7 files changed, 118 insertions(+), 56 deletions(-) create mode 100644 docs_build/dev/ProjectInstructions/RELEASE_GATE.md create mode 100644 docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-instruction-compliance-checklist.md create mode 100644 docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-manual-validation-notes.md create mode 100644 docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-tree.txt create mode 100644 docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate.md diff --git a/docs_build/dev/ProjectInstructions/RELEASE_GATE.md b/docs_build/dev/ProjectInstructions/RELEASE_GATE.md new file mode 100644 index 000000000..5bf506d6d --- /dev/null +++ b/docs_build/dev/ProjectInstructions/RELEASE_GATE.md @@ -0,0 +1,40 @@ +# ProjectInstructions Release Gate + +Teams may not start until this release gate passes. + +## Required Checks + +- [ ] ProjectInstructions folder exists on main. +- [ ] `README.txt` exists. +- [ ] `PROJECT_INSTRUCTIONS.md` exists. +- [ ] `backlog/BACKLOG_MASTER.md` exists. +- [ ] `team_assignments/TEAM_ASSIGNMENTS.md` exists. +- [ ] NATO team names are normalized. +- [ ] Day Work / EOD Merge rule exists. +- [ ] OWNER branch lock rule exists. +- [ ] No protected instructions were deleted. +- [ ] No direct commits to main occurred. +- [ ] Teams may not start until this passes. + +## Validation Commands + +```text +Test-Path docs_build/dev/ProjectInstructions +Test-Path docs_build/dev/ProjectInstructions/README.txt +Test-Path docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md +Test-Path docs_build/dev/ProjectInstructions/backlog/BACKLOG_MASTER.md +Test-Path docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md +Run the configured legacy-name search against `docs_build/dev/ProjectInstructions/` and require zero matches. +rg -n "Commit/push during the day is allowed only on assigned team/OWNER/PR branches" docs_build/dev/ProjectInstructions +rg -n "OWNER still has one active assignment at a time|OWNER still has one active branch at a time" docs_build/dev/ProjectInstructions +``` + +## Pass Rule + +This gate passes only when every required check is confirmed. + +If any check fails, stop and report: +- failing check +- current branch +- current git status +- recommended owner action diff --git a/docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-instruction-compliance-checklist.md b/docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-instruction-compliance-checklist.md new file mode 100644 index 000000000..77819305b --- /dev/null +++ b/docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-instruction-compliance-checklist.md @@ -0,0 +1,15 @@ +# PR_26172_OWNER_021 Instruction Compliance Checklist + +- [x] Read `docs_build/dev/PROJECT_INSTRUCTIONS.md`. +- [x] Read `docs_build/dev/PROJECT_MULTI_PC.txt`. +- [x] Read `docs_build/dev/ProjectInstructions/README.txt`. +- [x] OWNER override documented by user. +- [x] Started from PR020 branch. +- [x] Created branch `pr/26172-OWNER-021-projectinstructions-release-gate`. +- [x] Created `docs_build/dev/ProjectInstructions/RELEASE_GATE.md`. +- [x] Included all requested release gate checks. +- [x] Did not delete ProjectInstructions content. +- [x] Did not commit directly to `main`. +- [x] Did not merge any PR. +- [x] Ran docs/static validation. +- [x] Created repo-structured delta ZIP. diff --git a/docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-manual-validation-notes.md b/docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-manual-validation-notes.md new file mode 100644 index 000000000..d0f93d70a --- /dev/null +++ b/docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-manual-validation-notes.md @@ -0,0 +1,9 @@ +# PR_26172_OWNER_021 Manual Validation Notes + +- Verified `RELEASE_GATE.md` exists. +- Verified required anchor files exist in the stacked ProjectInstructions tree. +- Verified NATO team names remain normalized. +- Verified Day Work / EOD Merge rule exists. +- Verified OWNER branch lock rule exists. +- Verified teams may not start until the release gate passes. +- Verified no runtime, UI, Playwright, or sample files changed. diff --git a/docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-tree.txt b/docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-tree.txt new file mode 100644 index 000000000..781cd8374 --- /dev/null +++ b/docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-tree.txt @@ -0,0 +1,22 @@ +docs_build/dev/ProjectInstructions/ +|-- PROJECT_INSTRUCTIONS.md +|-- README.txt +|-- RELEASE_GATE.md +|-- TEAM_START_COMMANDS.md +|-- addendums/ +| |-- build_path_sync.md +| |-- deprecation.md +| |-- multi_team.md +| |-- preservation.md +| |-- team_release_readiness.md +| `-- tile_overlay_status.md +|-- archive/ +| |-- README.md +| `-- history/ +| `-- .gitkeep +|-- backlog/ +| `-- BACKLOG_MASTER.md +|-- deprecation/ +| `-- README.md +`-- team_assignments/ + `-- TEAM_ASSIGNMENTS.md diff --git a/docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate.md b/docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate.md new file mode 100644 index 000000000..ac8fbfdf5 --- /dev/null +++ b/docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate.md @@ -0,0 +1,27 @@ +# PR_26172_OWNER_021-projectinstructions-release-gate + +## Scope + +Create the final ProjectInstructions release gate checklist. + +## Changes + +- Added `docs_build/dev/ProjectInstructions/RELEASE_GATE.md`. +- Included required checks for the ProjectInstructions folder, anchor files, NATO normalization, Day Work / EOD Merge rule, OWNER lock rule, protected instruction preservation, no direct main commits, and team-start gating. + +## Validation + +- `git diff --check` +- `git diff --cached --check` +- Text search for `Alpha`, `Beta`, and `Gamma` in `docs_build/dev/ProjectInstructions/` +- Required file existence checks +- Tree output for `docs_build/dev/ProjectInstructions/` + +## Skipped Lanes + +- Playwright skipped: documentation-only release gate. +- Samples skipped: documentation-only release gate. + +## Package + +- `tmp/PR_26172_OWNER_021-projectinstructions-release-gate_delta.zip` diff --git a/docs_build/dev/reports/codex_changed_files.txt b/docs_build/dev/reports/codex_changed_files.txt index 452b0c62c..059ea67e3 100644 --- a/docs_build/dev/reports/codex_changed_files.txt +++ b/docs_build/dev/reports/codex_changed_files.txt @@ -1,8 +1,7 @@ -docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md -docs_build/dev/ProjectInstructions/addendums/multi_team.md -docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md -docs_build/dev/reports/PR_26172_OWNER_020-owner-branch-lock-governance-instruction-compliance-checklist.md -docs_build/dev/reports/PR_26172_OWNER_020-owner-branch-lock-governance-manual-validation-notes.md -docs_build/dev/reports/PR_26172_OWNER_020-owner-branch-lock-governance.md +docs_build/dev/ProjectInstructions/RELEASE_GATE.md +docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-instruction-compliance-checklist.md +docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-manual-validation-notes.md +docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-tree.txt +docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate.md docs_build/dev/reports/codex_changed_files.txt docs_build/dev/reports/codex_review.diff diff --git a/docs_build/dev/reports/codex_review.diff b/docs_build/dev/reports/codex_review.diff index ad2097adf..8b1378917 100644 --- a/docs_build/dev/reports/codex_review.diff +++ b/docs_build/dev/reports/codex_review.diff @@ -1,51 +1 @@ -diff --git a/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md b/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md -index 9636e2d41..96c4e5622 100644 ---- a/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md -+++ b/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md -@@ -53,3 +53,11 @@ OWNER follows the same safety rules: - - One active OWNER assignment at a time. - - OWNER may override team locks, but may not silently delete, rewrite, or remove protected instructions. - - OWNER override must be explicitly documented. -+ -+### OWNER Branch Lock Governance -+ -+- OWNER may override team locks. -+- OWNER still has one active assignment at a time. -+- OWNER still has one active branch at a time. -+- OWNER may not silently delete, rewrite, or remove protected instructions. -+- OWNER override must be documented. -diff --git a/docs_build/dev/ProjectInstructions/addendums/multi_team.md b/docs_build/dev/ProjectInstructions/addendums/multi_team.md -index f0a369ee9..670543d1a 100644 ---- a/docs_build/dev/ProjectInstructions/addendums/multi_team.md -+++ b/docs_build/dev/ProjectInstructions/addendums/multi_team.md -@@ -55,3 +55,11 @@ Merge to main is EOD-only and owner-approved, unless the owner explicitly says: - Existing ProjectInstructions wording that appears to require immediate or automatic merge remains preserved for traceability. - This addendum clarifies that merge to `main` remains owner-controlled. If a workflow rule appears to conflict with this addendum, stop and request explicit owner approval before merging. -+ -+## OWNER Branch Lock Governance -+ -+- OWNER may override team locks. -+- OWNER still has one active assignment at a time. -+- OWNER still has one active branch at a time. -+- OWNER may not silently delete, rewrite, or remove protected instructions. -+- OWNER override must be documented. -diff --git a/docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md b/docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md -index b7c5df692..04ff72616 100644 ---- a/docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md -+++ b/docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md -@@ -38,6 +38,14 @@ Active assignment: none. - - Active branch: none. - -+### OWNER Branch Lock Governance -+ -+- OWNER may override team locks. -+- OWNER still has one active assignment at a time. -+- OWNER still has one active branch at a time. -+- OWNER may not silently delete, rewrite, or remove protected instructions. -+- OWNER override must be documented. -+ - ## Team Name Registry - - - Team Alfa