Skip to content

Commit 4cd3b51

Browse files
ToolboxAidToolboxAid
committed
PR_26172_OWNER_021 ProjectInstructions release gate
1 parent 009d2b8 commit 4cd3b51

7 files changed

Lines changed: 118 additions & 56 deletions

‎docs_build/dev/ProjectInstructions/RELEASE_GATE.md‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# ProjectInstructions Release Gate
2+
3+
Teams may not start until this release gate passes.
4+
5+
## Required Checks
6+
7+
- [ ] ProjectInstructions folder exists on main.
8+
- [ ] `README.txt` exists.
9+
- [ ] `PROJECT_INSTRUCTIONS.md` exists.
10+
- [ ] `backlog/BACKLOG_MASTER.md` exists.
11+
- [ ] `team_assignments/TEAM_ASSIGNMENTS.md` exists.
12+
- [ ] NATO team names are normalized.
13+
- [ ] Day Work / EOD Merge rule exists.
14+
- [ ] OWNER branch lock rule exists.
15+
- [ ] No protected instructions were deleted.
16+
- [ ] No direct commits to main occurred.
17+
- [ ] Teams may not start until this passes.
18+
19+
## Validation Commands
20+
21+
```text
22+
Test-Path docs_build/dev/ProjectInstructions
23+
Test-Path docs_build/dev/ProjectInstructions/README.txt
24+
Test-Path docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md
25+
Test-Path docs_build/dev/ProjectInstructions/backlog/BACKLOG_MASTER.md
26+
Test-Path docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md
27+
Run the configured legacy-name search against `docs_build/dev/ProjectInstructions/` and require zero matches.
28+
rg -n "Commit/push during the day is allowed only on assigned team/OWNER/PR branches" docs_build/dev/ProjectInstructions
29+
rg -n "OWNER still has one active assignment at a time|OWNER still has one active branch at a time" docs_build/dev/ProjectInstructions
30+
```
31+
32+
## Pass Rule
33+
34+
This gate passes only when every required check is confirmed.
35+
36+
If any check fails, stop and report:
37+
- failing check
38+
- current branch
39+
- current git status
40+
- recommended owner action

‎docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-instruction-compliance-checklist.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# PR_26172_OWNER_021 Instruction Compliance Checklist
2+
3+
- [x] Read `docs_build/dev/PROJECT_INSTRUCTIONS.md`.
4+
- [x] Read `docs_build/dev/PROJECT_MULTI_PC.txt`.
5+
- [x] Read `docs_build/dev/ProjectInstructions/README.txt`.
6+
- [x] OWNER override documented by user.
7+
- [x] Started from PR020 branch.
8+
- [x] Created branch `pr/26172-OWNER-021-projectinstructions-release-gate`.
9+
- [x] Created `docs_build/dev/ProjectInstructions/RELEASE_GATE.md`.
10+
- [x] Included all requested release gate checks.
11+
- [x] Did not delete ProjectInstructions content.
12+
- [x] Did not commit directly to `main`.
13+
- [x] Did not merge any PR.
14+
- [x] Ran docs/static validation.
15+
- [x] Created repo-structured delta ZIP.

‎docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-manual-validation-notes.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# PR_26172_OWNER_021 Manual Validation Notes
2+
3+
- Verified `RELEASE_GATE.md` exists.
4+
- Verified required anchor files exist in the stacked ProjectInstructions tree.
5+
- Verified NATO team names remain normalized.
6+
- Verified Day Work / EOD Merge rule exists.
7+
- Verified OWNER branch lock rule exists.
8+
- Verified teams may not start until the release gate passes.
9+
- Verified no runtime, UI, Playwright, or sample files changed.

‎docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-tree.txt‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
docs_build/dev/ProjectInstructions/
2+
|-- PROJECT_INSTRUCTIONS.md
3+
|-- README.txt
4+
|-- RELEASE_GATE.md
5+
|-- TEAM_START_COMMANDS.md
6+
|-- addendums/
7+
| |-- build_path_sync.md
8+
| |-- deprecation.md
9+
| |-- multi_team.md
10+
| |-- preservation.md
11+
| |-- team_release_readiness.md
12+
| `-- tile_overlay_status.md
13+
|-- archive/
14+
| |-- README.md
15+
| `-- history/
16+
| `-- .gitkeep
17+
|-- backlog/
18+
| `-- BACKLOG_MASTER.md
19+
|-- deprecation/
20+
| `-- README.md
21+
`-- team_assignments/
22+
`-- TEAM_ASSIGNMENTS.md

‎docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate.md‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
# PR_26172_OWNER_021-projectinstructions-release-gate
2+
3+
## Scope
4+
5+
Create the final ProjectInstructions release gate checklist.
6+
7+
## Changes
8+
9+
- Added `docs_build/dev/ProjectInstructions/RELEASE_GATE.md`.
10+
- 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.
11+
12+
## Validation
13+
14+
- `git diff --check`
15+
- `git diff --cached --check`
16+
- Text search for `Alpha`, `Beta`, and `Gamma` in `docs_build/dev/ProjectInstructions/`
17+
- Required file existence checks
18+
- Tree output for `docs_build/dev/ProjectInstructions/`
19+
20+
## Skipped Lanes
21+
22+
- Playwright skipped: documentation-only release gate.
23+
- Samples skipped: documentation-only release gate.
24+
25+
## Package
26+
27+
- `tmp/PR_26172_OWNER_021-projectinstructions-release-gate_delta.zip`

‎docs_build/dev/reports/codex_changed_files.txt‎

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,7 @@
1-
docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md
2-
docs_build/dev/ProjectInstructions/addendums/multi_team.md
3-
docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md
4-
docs_build/dev/reports/PR_26172_OWNER_020-owner-branch-lock-governance-instruction-compliance-checklist.md
5-
docs_build/dev/reports/PR_26172_OWNER_020-owner-branch-lock-governance-manual-validation-notes.md
6-
docs_build/dev/reports/PR_26172_OWNER_020-owner-branch-lock-governance.md
1+
docs_build/dev/ProjectInstructions/RELEASE_GATE.md
2+
docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-instruction-compliance-checklist.md
3+
docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-manual-validation-notes.md
4+
docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate-tree.txt
5+
docs_build/dev/reports/PR_26172_OWNER_021-projectinstructions-release-gate.md
76
docs_build/dev/reports/codex_changed_files.txt
87
docs_build/dev/reports/codex_review.diff

‎docs_build/dev/reports/codex_review.diff‎

Lines changed: 0 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -1,51 +1 @@
1-
diff --git a/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md b/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md
2-
index 9636e2d41..96c4e5622 100644
3-
--- a/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md
4-
+++ b/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md
5-
@@ -53,3 +53,11 @@ OWNER follows the same safety rules:
6-
- One active OWNER assignment at a time.
7-
- OWNER may override team locks, but may not silently delete, rewrite, or remove protected instructions.
8-
- OWNER override must be explicitly documented.
9-
+
10-
+### OWNER Branch Lock Governance
11-
+
12-
+- OWNER may override team locks.
13-
+- OWNER still has one active assignment at a time.
14-
+- OWNER still has one active branch at a time.
15-
+- OWNER may not silently delete, rewrite, or remove protected instructions.
16-
+- OWNER override must be documented.
17-
diff --git a/docs_build/dev/ProjectInstructions/addendums/multi_team.md b/docs_build/dev/ProjectInstructions/addendums/multi_team.md
18-
index f0a369ee9..670543d1a 100644
19-
--- a/docs_build/dev/ProjectInstructions/addendums/multi_team.md
20-
+++ b/docs_build/dev/ProjectInstructions/addendums/multi_team.md
21-
@@ -55,3 +55,11 @@ Merge to main is EOD-only and owner-approved, unless the owner explicitly says:
22-
Existing ProjectInstructions wording that appears to require immediate or automatic merge remains preserved for traceability.
231

24-
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.
25-
+
26-
+## OWNER Branch Lock Governance
27-
+
28-
+- OWNER may override team locks.
29-
+- OWNER still has one active assignment at a time.
30-
+- OWNER still has one active branch at a time.
31-
+- OWNER may not silently delete, rewrite, or remove protected instructions.
32-
+- OWNER override must be documented.
33-
diff --git a/docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md b/docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md
34-
index b7c5df692..04ff72616 100644
35-
--- a/docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md
36-
+++ b/docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md
37-
@@ -38,6 +38,14 @@ Active assignment: none.
38-
39-
Active branch: none.
40-
41-
+### OWNER Branch Lock Governance
42-
+
43-
+- OWNER may override team locks.
44-
+- OWNER still has one active assignment at a time.
45-
+- OWNER still has one active branch at a time.
46-
+- OWNER may not silently delete, rewrite, or remove protected instructions.
47-
+- OWNER override must be documented.
48-
+
49-
## Team Name Registry
50-
51-
- Team Alfa

0 commit comments

Comments
 (0)