Skip to content

Commit 8f7140e

Browse files
committed
PR_26172_OWNER_030 workstream hygiene governance
1 parent 60ac651 commit 8f7140e

7 files changed

Lines changed: 215 additions & 160 deletions

docs_build/dev/PROJECT_INSTRUCTIONS.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2064,6 +2064,30 @@ Rules:
20642064
- If merge succeeds but repository is not returned to main:
20652065
closeout status = FAIL.
20662066

2067+
## WORKSTREAM HYGIENE GOVERNANCE
2068+
2069+
At workstream closeout, Codex must review repository collaboration state before reporting the workstream closed.
2070+
2071+
Required review targets:
2072+
- open PRs
2073+
- draft PRs
2074+
- local branches
2075+
- remote branches
2076+
2077+
Each reviewed item must be classified as one of:
2078+
- Active
2079+
- Merged
2080+
- Superseded
2081+
- Abandoned
2082+
- Historical/Archive
2083+
2084+
Rules:
2085+
- Merged branches should be deleted after successful merge and main sync.
2086+
- Superseded draft PRs should be closed.
2087+
- Abandoned branches should be documented before removal.
2088+
- Active workstream branches remain.
2089+
- No branch deletion is performed by this governance rule unless a later owner-approved cleanup task explicitly scopes deletion.
2090+
20672091
## OWNER-CONTROLLED STABLE AND MERGE APPROVAL
20682092

20692093
Stable promotion and merge approval are owner-controlled.

docs_build/dev/ProjectInstructions/addendums/multi_team.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,30 @@ Rules:
8383
- If merge succeeds but repository is not returned to main:
8484
closeout status = FAIL.
8585

86+
## Workstream Hygiene Governance
87+
88+
At workstream closeout, Codex must review repository collaboration state before reporting the workstream closed.
89+
90+
Required review targets:
91+
- open PRs
92+
- draft PRs
93+
- local branches
94+
- remote branches
95+
96+
Each reviewed item must be classified as one of:
97+
- Active
98+
- Merged
99+
- Superseded
100+
- Abandoned
101+
- Historical/Archive
102+
103+
Rules:
104+
- Merged branches should be deleted after successful merge and main sync.
105+
- Superseded draft PRs should be closed.
106+
- Abandoned branches should be documented before removal.
107+
- Active workstream branches remain.
108+
- No branch deletion is performed by this governance rule unless a later owner-approved cleanup task explicitly scopes deletion.
109+
86110
## Conflict Note
87111

88112
Existing ProjectInstructions wording that appears to require immediate or automatic merge remains preserved for traceability.
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# Manual Validation Notes
2+
3+
PR: $pr
4+
5+
## Checks Performed
6+
7+
- Confirmed Workstream Hygiene governance was added to legacy and active ProjectInstructions governance.
8+
- Confirmed closeout review targets include open PRs, draft PRs, local branches, and remote branches.
9+
- Confirmed each reviewed item must be classified as Active, Merged, Superseded, Abandoned, or Historical/Archive.
10+
- Confirmed merged branches are recommendation-only deletion candidates after successful merge and main sync.
11+
- Confirmed this PR does not delete branches or close PRs.
12+
- Confirmed EOD closeout remains present and authoritative.
13+
14+
## Manual Result
15+
16+
PASS
17+
18+
## Skipped Validation
19+
20+
- Playwright was not run because no UI or runtime behavior changed.
21+
- Samples were not run because no samples or sample-impacting runtime changed.
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# PR_26172_OWNER_030-workstream-hygiene-governance
2+
3+
## Scope
4+
5+
Add Workstream Hygiene governance for closeout review of PR and branch state.
6+
7+
## Team Ownership
8+
9+
- TEAM token: OWNER
10+
- Ownership classification: governance / workflow governance
11+
- TEAM ownership result: PASS
12+
13+
## Files Changed
14+
15+
- docs_build/dev/PROJECT_INSTRUCTIONS.md
16+
- docs_build/dev/ProjectInstructions/addendums/multi_team.md
17+
- docs_build/dev/reports/codex_changed_files.txt
18+
- docs_build/dev/reports/codex_review.diff
19+
- docs_build/dev/reports/PR_26172_OWNER_030-workstream-hygiene-governance.md
20+
- docs_build/dev/reports/PR_26172_OWNER_030-workstream-hygiene-governance-manual-validation-notes.md
21+
- docs_build/dev/reports/PR_26172_OWNER_030-workstream-hygiene-governance-instruction-compliance-checklist.md
22+
23+
## Change Summary
24+
25+
- Added Workstream Hygiene governance to require review of open PRs, draft PRs, local branches, and remote branches at closeout.
26+
- Added classifications: Active, Merged, Superseded, Abandoned, Historical/Archive.
27+
- Documented recommendation-only outcomes for merged, superseded, abandoned, and active branches.
28+
- Explicitly prohibited branch deletion in this PR.
29+
30+
## Validation
31+
32+
- git diff --check: PASS
33+
- Verified Workstream Hygiene governance exists: PASS
34+
- Verified EOD closeout remains authoritative: PASS
35+
- Verified no conflicting governance wording: PASS
36+
37+
## Skipped Lanes
38+
39+
- Playwright: skipped because this is docs/governance-only.
40+
- Samples: skipped because no runtime, sample, or UI files changed.
Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
docs_build/dev/PROJECT_INSTRUCTIONS.md
22
docs_build/dev/ProjectInstructions/addendums/multi_team.md
3-
docs_build/dev/reports/PR_26172_OWNER_028-eod-mainline-closeout-governance.md
4-
docs_build/dev/reports/PR_26172_OWNER_028-eod-mainline-closeout-governance-manual-validation-notes.md
5-
docs_build/dev/reports/PR_26172_OWNER_028-eod-mainline-closeout-governance-instruction-compliance-checklist.md
3+
docs_build/dev/reports/PR_26172_OWNER_030-workstream-hygiene-governance.md
4+
docs_build/dev/reports/PR_26172_OWNER_030-workstream-hygiene-governance-manual-validation-notes.md
5+
docs_build/dev/reports/PR_26172_OWNER_030-workstream-hygiene-governance-instruction-compliance-checklist.md
66
docs_build/dev/reports/codex_changed_files.txt
77
docs_build/dev/reports/codex_review.diff

0 commit comments

Comments
 (0)