Skip to content

Commit 3954123

Browse files
committed
Limit deprecated ProjectInstructions pointer
1 parent a5f5d2e commit 3954123

16 files changed

Lines changed: 79 additions & 107 deletions

docs_build/dev/BUILD_PR.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ This `BUILD_PR.md`, `PLAN_PR.md`, and the user request are the source of truth f
1515
- Remove duplicate active instruction files from `docs_build/dev/` root.
1616
- Remove stale one-off PR/restart files from `docs_build/dev/` root.
1717
- Keep preserved historical ProjectInstructions material reference-only.
18+
- Keep `project-instructions/` out of this PR except for a tiny deprecated pointer.
1819
- Update active team start/governance docs to reference only `docs_build/dev/ProjectInstructions/`.
1920
- Add EOD main lock, next-day reset governance, and canonical START / WORK / END branch lifecycle rules.
2021
- Add required reports under `docs_build/dev/reports/`.
@@ -28,8 +29,7 @@ This `BUILD_PR.md`, `PLAN_PR.md`, and the user request are the source of truth f
2829
- `docs_build/dev/ProjectInstructions/TEAM_START_COMMANDS.md`
2930
- `docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md`
3031
- `docs_build/dev/ProjectInstructions/addendums/*.md`
31-
- `project-instructions/README.md`
32-
- `project-instructions/addendums/*.md`
32+
- `project-instructions/README.md` (tiny deprecated pointer only)
3333
- `docs_build/dev/PROJECT_INSTRUCTIONS.md` (delete)
3434
- `docs_build/dev/PROJECT_MULTI_PC.txt` (delete)
3535
- `docs_build/dev/BUILD_PR_LEVEL_10_6B_STANDALONE_SAMPLE_GENERIC_FAILURE_CLOSEOUT.md` (delete)
@@ -70,6 +70,7 @@ Test-Path docs_build/dev/PROJECT_INSTRUCTIONS.md
7070
Test-Path docs_build/dev/PROJECT_MULTI_PC.txt
7171
rg -n 'only active Project Instructions source|docs_build/dev/ProjectInstructions/' docs_build/dev/ProjectInstructions
7272
rg -n 'docs_build/dev/PROJECT_INSTRUCTIONS.md.*source of truth|Codex must always read `docs_build/dev/PROJECT_INSTRUCTIONS.md`|Read `docs_build/dev/PROJECT_INSTRUCTIONS.md`' docs_build/dev/ProjectInstructions project-instructions
73+
git diff --name-status $(git merge-base HEAD origin/main) -- project-instructions
7374
rg -n "Branch Lifecycle \\(Canonical\\)|Every PR follows exactly three phases|^START$|^WORK$|^END$|Mandatory Hard Stops|tomorrow's official baseline|No commits on main|Never checkout main|Only after ALL four pass" docs_build/dev/ProjectInstructions
7475
git diff --name-only -- src assets toolbox games api serverside package.json package-lock.json docs_build/dev/start_of_day
7576
git diff --check

docs_build/dev/PLAN_PR.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ Make `docs_build/dev/ProjectInstructions/` the only active Project Instructions
1010
- Delete duplicate active instruction files from `docs_build/dev/` root.
1111
- Delete stale one-off PR/restart files from `docs_build/dev/` root.
1212
- Preserve historical ProjectInstructions-style sources only as deprecated reference material.
13+
- Keep `project-instructions/` out of the PR except for a tiny deprecated pointer.
1314
- Move active legacy addendums into `docs_build/dev/ProjectInstructions/addendums/`.
1415
- Update active team start and governance docs to reference only `docs_build/dev/ProjectInstructions/`.
1516
- Add EOD main lock, next-day reset, team PR branch creation gate, and canonical START / WORK / END branch lifecycle rules.
@@ -26,6 +27,7 @@ Make `docs_build/dev/ProjectInstructions/` the only active Project Instructions
2627

2728
1. Run targeted grep/search proving no active duplicate ProjectInstructions source remains.
2829
2. Confirm duplicate active root instruction files and stale one-off root files are absent.
29-
3. Confirm EOD/Next Day and canonical START / WORK / END branch lifecycle rules appear in active governance docs.
30-
4. Confirm no product/runtime files changed.
31-
5. Run `git diff --check`.
30+
3. Confirm `project-instructions/**` has no PR changes except the tiny deprecated pointer.
31+
4. Confirm EOD/Next Day and canonical START / WORK / END branch lifecycle rules appear in active governance docs.
32+
5. Confirm no product/runtime files changed.
33+
6. Run `git diff --check`.

docs_build/dev/reports/PR_26177_OWNER_007-project-instructions-single-source-eod-lock.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,8 @@ Status: PASS
1515
- Added mandatory hard stops for main-before-commit, dirty branch creation, non-synced main, baseline mismatch, unvalidated merge, and starting new PR work before synchronized main return.
1616
- Deleted duplicate active instruction files from docs_build/dev root.
1717
- Deleted stale one-off PR/restart files listed by OWNER review from docs_build/dev root.
18+
- Corrected project-instructions/** scope so the PR only adds a tiny deprecated pointer README there.
19+
- Preserved project-instructions/addendums/** unchanged in the PR; unique current governance content is carried by docs_build/dev/ProjectInstructions/addendums/.
1820
- Updated active governance docs so the only active Project Instructions source is docs_build/dev/ProjectInstructions/.
1921
- Preserved docs_build/dev/ProjectInstructions/**, docs_build/dev/reports/**, current PR reports, and active validation/audit docs.
2022
- No product/runtime, start_of_day, feature, or legacy SQLite file changes were made.
@@ -45,10 +47,18 @@ Deleted stale one-off root files:
4547
- docs_build/dev/restart_notes_11_122.md
4648
- docs_build/dev/restart_notes_11_123.md
4749

50+
## Ambiguous Old Docs Handling
51+
52+
- Reviewed old project-instructions addendum files before changing them.
53+
- Moved/currentized active governance into docs_build/dev/ProjectInstructions/addendums/ during this PR.
54+
- Removed project-instructions/addendums/** edits from the PR so old files remain historical reference, not a second active source.
55+
- Added only project-instructions/README.md as a tiny deprecated pointer to docs_build/dev/ProjectInstructions/.
56+
4857
## Validation
4958

5059
- PASS: current branch is PR_26177_OWNER_007-project-instructions-single-source-eod-lock.
5160
- PASS: targeted path checks confirm duplicate root instruction files and listed stale one-off files are absent.
61+
- PASS: project-instructions/** PR diff is limited to project-instructions/README.md.
5262
- PASS: targeted grep found no active duplicate ProjectInstructions source-of-truth claim outside the active source.
5363
- PASS: targeted grep confirmed canonical lifecycle language appears in active governance docs.
5464
- PASS: product/runtime and start_of_day changed-file check returned no files.

docs_build/dev/reports/PR_26177_OWNER_007-project-instructions-single-source-eod-lock_branch-validation.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ Status: PASS
55
- PASS: Current branch is PR_26177_OWNER_007-project-instructions-single-source-eod-lock.
66
- PASS: Branch is not main during WORK.
77
- PASS: Worktree changes are scoped to governance/docs cleanup, reports, and the required delta artifact.
8+
- PASS: project-instructions/** is limited to a tiny deprecated pointer README in the PR diff.
89
- PASS: No product/runtime files changed.
910
- PASS: No start_of_day files changed.
1011
- PASS: docs_build/dev/ProjectInstructions/ remains present and active.

docs_build/dev/reports/PR_26177_OWNER_007-project-instructions-single-source-eod-lock_manual-validation-notes.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ Status: PASS
55
- Reviewed cleanup scope against OWNER-provided file list.
66
- Removed only duplicate active instruction files and stale one-off root docs from docs_build/dev root.
77
- Removed docs_build/dev/next_command.txt only as an exact untracked/ignored stale file; it is not included in the git commit.
8+
- Reviewed ambiguous old project-instructions addendum files and left them unchanged in this PR.
9+
- Confirmed active/current governance content is under docs_build/dev/ProjectInstructions/.
810
- Confirmed docs_build/dev/ProjectInstructions/** was preserved.
911
- Confirmed docs_build/dev/reports/** and current PR reports were preserved/regenerated.
1012
- Confirmed no product/runtime files changed.

docs_build/dev/reports/PR_26177_OWNER_007-project-instructions-single-source-eod-lock_requirement-checklist.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,9 @@ Status: PASS
66
- PASS: Active source is docs_build/dev/ProjectInstructions/.
77
- PASS: Duplicate active instruction files in docs_build/dev root were deleted.
88
- PASS: Stale PR/restart one-off files listed in OWNER review were deleted or removed from local disk when untracked.
9+
- PASS: project-instructions/** changes were removed from this PR except for a tiny deprecated pointer README.
10+
- PASS: Ambiguous old docs were reviewed before cleanup; project-instructions/addendums/** remains unchanged in the PR.
11+
- PASS: Unique current governance content exists under docs_build/dev/ProjectInstructions/ before old reference material is ignored as inactive.
912
- PASS: docs_build/dev/ProjectInstructions/** was not deleted.
1013
- PASS: docs_build/dev/reports/** and current PR reports were preserved/regenerated.
1114
- PASS: Active validation/audit docs were not deleted without migration.

docs_build/dev/reports/PR_26177_OWNER_007-project-instructions-single-source-eod-lock_validation-lane.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ git branch --show-current
99
git status --short --branch --untracked-files=all
1010
Test-Path docs_build/dev/PROJECT_INSTRUCTIONS.md
1111
Test-Path docs_build/dev/PROJECT_MULTI_PC.txt
12+
git diff --name-status $(git merge-base HEAD origin/main) -- project-instructions
1213
rg -n 'docs_build/dev/PROJECT_INSTRUCTIONS.md.*source of truth|Codex must always read docs_build/dev/PROJECT_INSTRUCTIONS.md|Read docs_build/dev/PROJECT_INSTRUCTIONS.md' docs_build/dev/ProjectInstructions project-instructions
1314
rg -n 'only active Project Instructions source|docs_build/dev/ProjectInstructions/' docs_build/dev/ProjectInstructions
1415
rg -n "Branch Lifecycle \\(Canonical\\)|Every PR follows exactly three phases|^START$|^WORK$|^END$|Mandatory Hard Stops|tomorrow's official baseline|No commits on main|Never checkout main|Only after ALL four pass" docs_build/dev/ProjectInstructions
@@ -19,6 +20,7 @@ git diff --check
1920
Results:
2021
- PASS: Branch is PR_26177_OWNER_007-project-instructions-single-source-eod-lock.
2122
- PASS: Duplicate/stale root file path checks returned absent for every listed cleanup file.
23+
- PASS: project-instructions/** diff returned only A project-instructions/README.md.
2224
- PASS: Active-source grep did not find old root instruction source-of-truth wording.
2325
- PASS: Positive grep found active ProjectInstructions and branch lifecycle governance language.
2426
- PASS: Product/runtime/start_of_day changed-file check returned no files.

docs_build/dev/reports/codex_changed_files.txt

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -45,9 +45,3 @@ D docs_build/dev/restart_notes_11_121.md
4545
D docs_build/dev/restart_notes_11_122.md
4646
D docs_build/dev/restart_notes_11_123.md
4747
A project-instructions/README.md
48-
M project-instructions/addendums/assistant-execution-modes.md
49-
M project-instructions/addendums/canonical-repository-structure.md
50-
M project-instructions/addendums/codex-artifact-and-reporting-standard.md
51-
M project-instructions/addendums/codex-project-instructions-startup.md
52-
M project-instructions/addendums/legacy-migration-policy.md
53-
M project-instructions/addendums/test-structure-standardization.md

0 commit comments

Comments
 (0)