diff --git a/dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md b/dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md index 5b1b8f9a6..c6f5c5744 100644 --- a/dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md +++ b/dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md @@ -6,9 +6,42 @@ Codex and future wrappers must request this file directly. All other Project Instructions documents are loaded indirectly through the references below. +## Canonical Source Rule + +The repository is the canonical source of truth for project rules. + +Codex, ChatGPT, wrappers, and team operators must use the current repository documentation under `dev/build/ProjectInstructions/` as authority for active rules. Prior chat history, remembered conversation context, generated reports, archived documents, local notes, or stale external instructions must not override repository documentation. + +If current chat instructions conflict with repository documentation, Codex must follow the active repository documentation or HARD STOP and request OWNER direction. + +## Canonical Team Naming + +Canonical active teams: + +- Owner +- Alfa +- Bravo +- Charlie +- Golf + +Official NATO spellings: + +```text +Alfa, Bravo, Charlie, Delta, Echo, Foxtrot, Golf, Hotel, India, Juliett, Kilo, Lima, Mike, November, Oscar, Papa, Quebec, Romeo, Sierra, Tango, Uniform, Victor, Whiskey, Xray, Yankee, Zulu. +``` + +Rules: + +- Use official NATO spelling for all team names. +- Do not use `Alpha`, `Beta`, or `Gamma` for active teams. +- Deprecated or historical names must not be used for active team routing, new work ownership, or current governance. +- Historical PR names, branch names, and references may remain unchanged when they are already merged or clearly referenced as history. +- New branches, PRs, reports, and documentation must use canonical team names. +- Repository documentation overrides prior conversations. + ## Current Version/Date -- Project Instructions Version: 2026-06-28.PR_26179_OWNER_010 +- Project Instructions Version: 2026-06-28.PR_26172_OWNER_034 - Date: 2026-06-28 - Owner: OWNER diff --git a/dev/reports/PR_26172_OWNER_034-canonical-project-source-of-truth.md b/dev/reports/PR_26172_OWNER_034-canonical-project-source-of-truth.md new file mode 100644 index 000000000..fac366a67 --- /dev/null +++ b/dev/reports/PR_26172_OWNER_034-canonical-project-source-of-truth.md @@ -0,0 +1,27 @@ +# PR_26172_OWNER_034-canonical-project-source-of-truth + +## Purpose + +Make repository documentation the canonical source of truth for project rules so Codex and ChatGPT do not rely on stale conversation history. + +## Summary + +- Added a Canonical Source Rule near the top of `PROJECT_INSTRUCTIONS.md`. +- Documented that active repository documentation overrides prior chat history, generated reports, archive material, local notes, and stale external instructions. +- Added canonical active teams: Owner, Alfa, Bravo, Charlie, and Golf. +- Added official NATO spelling guidance. +- Documented that Alpha, Beta, and Gamma must not be used for active teams. +- Preserved historical PR/branch/reference names when clearly historical. + +## Scope Boundary + +- Documentation/governance only. +- Runtime code was not modified. +- Bootstrap files were not modified. +- No `PROJECT_MULTI_PC.txt` file was created or restored. + +## Validation + +- `git diff --check`: PASS +- `npm run validate:canonical-structure`: PASS +- Deprecated active-team-name scan in `dev/build/ProjectInstructions/`: PASS with only intentional prohibition/historical non-team phrase matches. diff --git a/dev/reports/PR_26172_OWNER_034-canonical-project-source-of-truth_requirement-checklist.md b/dev/reports/PR_26172_OWNER_034-canonical-project-source-of-truth_requirement-checklist.md new file mode 100644 index 000000000..6a0c23718 --- /dev/null +++ b/dev/reports/PR_26172_OWNER_034-canonical-project-source-of-truth_requirement-checklist.md @@ -0,0 +1,14 @@ +# PR_26172_OWNER_034 Requirement Checklist + +| Requirement | Result | Evidence | +| --- | --- | --- | +| Update `PROJECT_INSTRUCTIONS.md`. | PASS | Updated `dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md`. | +| Add clear Canonical Source Rule near the top. | PASS | Added `Canonical Source Rule` section after Purpose. | +| Add canonical NATO team naming. | PASS | Added canonical active teams and official NATO spelling list. | +| Deprecated/historical names must not be used for active teams. | PASS | Added explicit active-team prohibition for Alpha, Beta, and Gamma. | +| Prior chat history must not override repository documentation. | PASS | Added repository documentation override rule. | +| Historical PR names may remain unchanged. | PASS | Added historical PR/branch/reference exception. | +| New branches, PRs, reports, and documentation must use canonical names. | PASS | Added new-artifact naming rule. | +| Do not modify runtime code. | PASS | Only Project Instructions and generated reports changed. | +| Do not modify bootstrap files. | PASS | No `dev/bootstrap/` files changed. | +| Do not recreate or add `PROJECT_MULTI_PC.txt`. | PASS | File was not created. | diff --git a/dev/reports/PR_26172_OWNER_034-canonical-project-source-of-truth_validation-report.md b/dev/reports/PR_26172_OWNER_034-canonical-project-source-of-truth_validation-report.md new file mode 100644 index 000000000..11cf2e982 --- /dev/null +++ b/dev/reports/PR_26172_OWNER_034-canonical-project-source-of-truth_validation-report.md @@ -0,0 +1,15 @@ +# PR_26172_OWNER_034 Validation Report + +| Lane | Command | Result | +| --- | --- | --- | +| Diff whitespace | `git diff --check` | PASS | +| Canonical structure | `npm run validate:canonical-structure` | PASS, 0 blocking violations | +| Deprecated active-team names | `rg -n "\b(Alpha|Beta|Gamma)\b" dev\build\ProjectInstructions` | PASS with intentional matches only | + +## Deprecated Name Scan Notes + +Intentional matches: +- `PROJECT_INSTRUCTIONS.md` contains the new rule: `Do not use Alpha, Beta, or Gamma for active teams.` +- Existing governance docs contain the non-team historical phrase `Alfa/Beta/User isolation framework`, already marked as a non-team phrase that should not be rewritten unless explicitly scoped. + +No active team ownership/routing references to Alpha, Beta, or Gamma were found in governance docs. diff --git a/dev/reports/codex_changed_files.txt b/dev/reports/codex_changed_files.txt index 04ad28f6a..afe6337e7 100644 --- a/dev/reports/codex_changed_files.txt +++ b/dev/reports/codex_changed_files.txt @@ -1,6 +1 @@ -PR_26179_OWNER_012-gitignore-env-simplification -Updated: 2026-06-28T03:47:16Z -Branch: PR_26179_OWNER_012-gitignore-env-simplification - -Changed files: -M .gitignore +dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md diff --git a/dev/reports/codex_review.diff b/dev/reports/codex_review.diff index 0b805ea5b..b517e1966 100644 --- a/dev/reports/codex_review.diff +++ b/dev/reports/codex_review.diff @@ -1,15 +1,47 @@ -diff --git a/.gitignore b/.gitignore -index 3ac762a04..1207a12fc 100644 ---- a/.gitignore -+++ b/.gitignore -@@ -48,8 +48,8 @@ docs/dev/reports/playwright_v8_coverage_report.txt - *.mp4 - *.mkv +diff --git a/dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md b/dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md +index 5b1b8f9a6..c6f5c5744 100644 +--- a/dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md ++++ b/dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md +@@ -6,9 +6,42 @@ --.env --.env.* -+# Environment files -+.env* - !.env.example - !.env.sample - !.env.template + Codex and future wrappers must request this file directly. All other Project Instructions documents are loaded indirectly through the references below. + ++## Canonical Source Rule ++ ++The repository is the canonical source of truth for project rules. ++ ++Codex, ChatGPT, wrappers, and team operators must use the current repository documentation under `dev/build/ProjectInstructions/` as authority for active rules. Prior chat history, remembered conversation context, generated reports, archived documents, local notes, or stale external instructions must not override repository documentation. ++ ++If current chat instructions conflict with repository documentation, Codex must follow the active repository documentation or HARD STOP and request OWNER direction. ++ ++## Canonical Team Naming ++ ++Canonical active teams: ++ ++- Owner ++- Alfa ++- Bravo ++- Charlie ++- Golf ++ ++Official NATO spellings: ++ ++```text ++Alfa, Bravo, Charlie, Delta, Echo, Foxtrot, Golf, Hotel, India, Juliett, Kilo, Lima, Mike, November, Oscar, Papa, Quebec, Romeo, Sierra, Tango, Uniform, Victor, Whiskey, Xray, Yankee, Zulu. ++``` ++ ++Rules: ++ ++- Use official NATO spelling for all team names. ++- Do not use `Alpha`, `Beta`, or `Gamma` for active teams. ++- Deprecated or historical names must not be used for active team routing, new work ownership, or current governance. ++- Historical PR names, branch names, and references may remain unchanged when they are already merged or clearly referenced as history. ++- New branches, PRs, reports, and documentation must use canonical team names. ++- Repository documentation overrides prior conversations. ++ + ## Current Version/Date + +-- Project Instructions Version: 2026-06-28.PR_26179_OWNER_010 ++- Project Instructions Version: 2026-06-28.PR_26172_OWNER_034 + - Date: 2026-06-28 + - Owner: OWNER