Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions docs_build/dev/ProjectInstructions/RELEASE_GATE.md
Original file line number Diff line number Diff line change
@@ -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
Original file line number Diff line number Diff line change
@@ -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.
Original file line number Diff line number Diff line change
@@ -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.
Original file line number Diff line number Diff line change
@@ -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
Original file line number Diff line number Diff line change
@@ -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`
11 changes: 5 additions & 6 deletions docs_build/dev/reports/codex_changed_files.txt
Original file line number Diff line number Diff line change
@@ -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
50 changes: 0 additions & 50 deletions docs_build/dev/reports/codex_review.diff
Original file line number Diff line number Diff line change
@@ -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
Loading