Skip to content

Commit a4e671e

Browse files
ToolboxAidToolboxAid
authored
Merge pull request #249 from ToolboxAid/PR_26172_OWNER_034-canonical-project-source-of-truth
PR_26172_OWNER_034-canonical-project-source-of-truth
2 parents aefe2a1 + 9065b65 commit a4e671e

6 files changed

Lines changed: 137 additions & 21 deletions

‎dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md‎

Lines changed: 34 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,42 @@
66

77
Codex and future wrappers must request this file directly. All other Project Instructions documents are loaded indirectly through the references below.
88

9+
## Canonical Source Rule
10+
11+
The repository is the canonical source of truth for project rules.
12+
13+
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.
14+
15+
If current chat instructions conflict with repository documentation, Codex must follow the active repository documentation or HARD STOP and request OWNER direction.
16+
17+
## Canonical Team Naming
18+
19+
Canonical active teams:
20+
21+
- Owner
22+
- Alfa
23+
- Bravo
24+
- Charlie
25+
- Golf
26+
27+
Official NATO spellings:
28+
29+
```text
30+
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.
31+
```
32+
33+
Rules:
34+
35+
- Use official NATO spelling for all team names.
36+
- Do not use `Alpha`, `Beta`, or `Gamma` for active teams.
37+
- Deprecated or historical names must not be used for active team routing, new work ownership, or current governance.
38+
- Historical PR names, branch names, and references may remain unchanged when they are already merged or clearly referenced as history.
39+
- New branches, PRs, reports, and documentation must use canonical team names.
40+
- Repository documentation overrides prior conversations.
41+
942
## Current Version/Date
1043

11-
- Project Instructions Version: 2026-06-28.PR_26179_OWNER_010
44+
- Project Instructions Version: 2026-06-28.PR_26172_OWNER_034
1245
- Date: 2026-06-28
1346
- Owner: OWNER
1447

‎dev/reports/PR_26172_OWNER_034-canonical-project-source-of-truth.md‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
# PR_26172_OWNER_034-canonical-project-source-of-truth
2+
3+
## Purpose
4+
5+
Make repository documentation the canonical source of truth for project rules so Codex and ChatGPT do not rely on stale conversation history.
6+
7+
## Summary
8+
9+
- Added a Canonical Source Rule near the top of `PROJECT_INSTRUCTIONS.md`.
10+
- Documented that active repository documentation overrides prior chat history, generated reports, archive material, local notes, and stale external instructions.
11+
- Added canonical active teams: Owner, Alfa, Bravo, Charlie, and Golf.
12+
- Added official NATO spelling guidance.
13+
- Documented that Alpha, Beta, and Gamma must not be used for active teams.
14+
- Preserved historical PR/branch/reference names when clearly historical.
15+
16+
## Scope Boundary
17+
18+
- Documentation/governance only.
19+
- Runtime code was not modified.
20+
- Bootstrap files were not modified.
21+
- No `PROJECT_MULTI_PC.txt` file was created or restored.
22+
23+
## Validation
24+
25+
- `git diff --check`: PASS
26+
- `npm run validate:canonical-structure`: PASS
27+
- Deprecated active-team-name scan in `dev/build/ProjectInstructions/`: PASS with only intentional prohibition/historical non-team phrase matches.

‎dev/reports/PR_26172_OWNER_034-canonical-project-source-of-truth_requirement-checklist.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# PR_26172_OWNER_034 Requirement Checklist
2+
3+
| Requirement | Result | Evidence |
4+
| --- | --- | --- |
5+
| Update `PROJECT_INSTRUCTIONS.md`. | PASS | Updated `dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md`. |
6+
| Add clear Canonical Source Rule near the top. | PASS | Added `Canonical Source Rule` section after Purpose. |
7+
| Add canonical NATO team naming. | PASS | Added canonical active teams and official NATO spelling list. |
8+
| Deprecated/historical names must not be used for active teams. | PASS | Added explicit active-team prohibition for Alpha, Beta, and Gamma. |
9+
| Prior chat history must not override repository documentation. | PASS | Added repository documentation override rule. |
10+
| Historical PR names may remain unchanged. | PASS | Added historical PR/branch/reference exception. |
11+
| New branches, PRs, reports, and documentation must use canonical names. | PASS | Added new-artifact naming rule. |
12+
| Do not modify runtime code. | PASS | Only Project Instructions and generated reports changed. |
13+
| Do not modify bootstrap files. | PASS | No `dev/bootstrap/` files changed. |
14+
| Do not recreate or add `PROJECT_MULTI_PC.txt`. | PASS | File was not created. |

‎dev/reports/PR_26172_OWNER_034-canonical-project-source-of-truth_validation-report.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# PR_26172_OWNER_034 Validation Report
2+
3+
| Lane | Command | Result |
4+
| --- | --- | --- |
5+
| Diff whitespace | `git diff --check` | PASS |
6+
| Canonical structure | `npm run validate:canonical-structure` | PASS, 0 blocking violations |
7+
| Deprecated active-team names | `rg -n "\b(Alpha|Beta|Gamma)\b" dev\build\ProjectInstructions` | PASS with intentional matches only |
8+
9+
## Deprecated Name Scan Notes
10+
11+
Intentional matches:
12+
- `PROJECT_INSTRUCTIONS.md` contains the new rule: `Do not use Alpha, Beta, or Gamma for active teams.`
13+
- 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.
14+
15+
No active team ownership/routing references to Alpha, Beta, or Gamma were found in governance docs.

‎dev/reports/codex_changed_files.txt‎

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1 @@
1-
PR_26179_OWNER_012-gitignore-env-simplification
2-
Updated: 2026-06-28T03:47:16Z
3-
Branch: PR_26179_OWNER_012-gitignore-env-simplification
4-
5-
Changed files:
6-
M .gitignore
1+
dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md

‎dev/reports/codex_review.diff‎

Lines changed: 46 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,47 @@
1-
diff --git a/.gitignore b/.gitignore
2-
index 3ac762a04..1207a12fc 100644
3-
--- a/.gitignore
4-
+++ b/.gitignore
5-
@@ -48,8 +48,8 @@ docs/dev/reports/playwright_v8_coverage_report.txt
6-
*.mp4
7-
*.mkv
1+
diff --git a/dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md b/dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md
2+
index 5b1b8f9a6..c6f5c5744 100644
3+
--- a/dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md
4+
+++ b/dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md
5+
@@ -6,9 +6,42 @@
86

9-
-.env
10-
-.env.*
11-
+# Environment files
12-
+.env*
13-
!.env.example
14-
!.env.sample
15-
!.env.template
7+
Codex and future wrappers must request this file directly. All other Project Instructions documents are loaded indirectly through the references below.
8+
9+
+## Canonical Source Rule
10+
+
11+
+The repository is the canonical source of truth for project rules.
12+
+
13+
+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.
14+
+
15+
+If current chat instructions conflict with repository documentation, Codex must follow the active repository documentation or HARD STOP and request OWNER direction.
16+
+
17+
+## Canonical Team Naming
18+
+
19+
+Canonical active teams:
20+
+
21+
+- Owner
22+
+- Alfa
23+
+- Bravo
24+
+- Charlie
25+
+- Golf
26+
+
27+
+Official NATO spellings:
28+
+
29+
+```text
30+
+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.
31+
+```
32+
+
33+
+Rules:
34+
+
35+
+- Use official NATO spelling for all team names.
36+
+- Do not use `Alpha`, `Beta`, or `Gamma` for active teams.
37+
+- Deprecated or historical names must not be used for active team routing, new work ownership, or current governance.
38+
+- Historical PR names, branch names, and references may remain unchanged when they are already merged or clearly referenced as history.
39+
+- New branches, PRs, reports, and documentation must use canonical team names.
40+
+- Repository documentation overrides prior conversations.
41+
+
42+
## Current Version/Date
43+
44+
-- Project Instructions Version: 2026-06-28.PR_26179_OWNER_010
45+
+- Project Instructions Version: 2026-06-28.PR_26172_OWNER_034
46+
- Date: 2026-06-28
47+
- Owner: OWNER

0 commit comments

Comments
 (0)