PR_26175_OWNER_050-project-instructions-add-valid-reference-files

docs_build/dev/PROJECT_INSTRUCTIONS.md

@@ -2288,6 +2288,17 @@ OWNER follows the same safety rules:
 - OWNER may override team locks, but may not silently delete, rewrite, or remove protected instructions.
 - OWNER override must be explicitly documented.
 
+## PROJECT INSTRUCTION REFERENCE FILE RECOGNITION
+
+`docs_build/dev/ProjectInstructions/addendums/project_reference_files.md` defines additional valid project instruction/reference files.
+
+Future Project Instructions reviews must include these files when present in `ProjectInstructions.zip`, the active project instruction directory, or `docs_build/dev/admin-notes/`:
+
+- `Installs required.txt`
+- `Table layout.txt`
+
+Treat these files the same as existing instruction documents for read-set, review, preservation, and reporting purposes.
+
 ## CODEX INSTRUCTION ENFORCEMENT START GATE
 
 Codex must run this gate before every PR execution and before any file changes.

docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md

@@ -15,6 +15,7 @@ The Project Instructions operating system provides additive governance for:
 - tile overlay status behavior
 - deprecation workflow
 - archive and history preservation
+- recognized project instruction/reference files
 
 ## Preservation
 
@@ -29,6 +30,10 @@ Existing Project Instructions remain preserved in their current locations. This
 - `archive/` contains retained reference material.
 - `archive/history/` contains timestamped history snapshots.
 
+## Recognized Project Reference Files
+
+`docs_build/dev/ProjectInstructions/addendums/project_reference_files.md` defines additional valid project instruction/reference files that must be included in future Project Instructions reviews when present in `ProjectInstructions.zip`, the active project instruction directory, or `docs_build/dev/admin-notes/`.
+
 ## Merge Control
 
 No PR in this operating system is merged without explicit owner approval.

docs_build/dev/ProjectInstructions/README.txt

@@ -48,3 +48,4 @@ Addendum index:
 - Assistant Execution Modes: project-instructions/addendums/assistant-execution-modes.md
 - Codex Artifact and Reporting Standard: project-instructions/addendums/codex-artifact-and-reporting-standard.md
 - Codex Project Instructions Startup: project-instructions/addendums/codex-project-instructions-startup.md
+- Project Reference Files Governance: docs_build/dev/ProjectInstructions/addendums/project_reference_files.md

docs_build/dev/ProjectInstructions/addendums/project_reference_files.md

@@ -0,0 +1,36 @@
+# Project Reference Files Governance
+
+Status: Approved
+Owner: OWNER
+
+## Purpose
+
+Define recognized project instruction and reference documents that may live outside the active `docs_build/dev/ProjectInstructions/` addendum tree but still belong in Project Instructions reviews.
+
+## Recognized Files
+
+The following files are valid project instruction/reference documents when present in `ProjectInstructions.zip`, `docs_build/dev/ProjectInstructions/`, or the project instruction/admin-notes directory:
+
+- `Installs required.txt`
+- `Table layout.txt`
+
+Canonical repository locations:
+
+- `docs_build/dev/admin-notes/Installs required.txt`
+- `docs_build/dev/admin-notes/Table layout.txt`
+
+## Review Rule
+
+Future Project Instructions reviews must include these files automatically when they are present in either:
+
+- an extracted `ProjectInstructions.zip` bundle
+- the active project instruction directory
+- `docs_build/dev/admin-notes/`
+
+Treat these files the same as existing instruction documents for read-set, review, preservation, and reporting purposes.
+
+Missing files are not a release-gate failure unless a PR explicitly scopes those files or claims they are present.
+
+## Scope Boundary
+
+This governance addendum does not introduce runtime behavior, UI behavior, application loading, or ZIP-generation changes.

docs_build/dev/ProjectInstructions/addendums/release_gate.md

@@ -36,7 +36,10 @@ The release gate should confirm these files when relevant to the PR:
 - `docs_build/dev/ProjectInstructions/backlog/BACKLOG_MASTER.md`
 - `docs_build/dev/ProjectInstructions/addendums/governance_phase1_complete.md`
 - `docs_build/dev/ProjectInstructions/addendums/pr_workflow.md`
+- `docs_build/dev/ProjectInstructions/addendums/project_reference_files.md`
 - `docs_build/dev/ProjectInstructions/team_assignments/team_ownership.md`
+- `docs_build/dev/admin-notes/Installs required.txt` when present
+- `docs_build/dev/admin-notes/Table layout.txt` when present
 
 ## Validation Result
 

docs_build/dev/admin-notes/Installs required.txt

@@ -0,0 +1,9 @@
+VS Code required tools
+
+Power Shell
+winget install --id GitHub.cli
+gh --version
+gh auth login
+
+Terminal
+Install-Script -Name winget-install -RequiredVersion 2.1.0 -Scope CurrentUser

docs_build/dev/admin-notes/Table layout.txt

@@ -0,0 +1,60 @@
+
+DB base
+Creator Table 1
+Parent Table *-1 user
+Child Table -- *-1 Parent
+
+
+No selected Items
+┌──────────────────────────────────────────────────────────────────────────────────────────────────────┐
+│ Idea Board                                                                                           │
+├───────────────┬─────────────────────────────────────────┬───────────┬────────────┬─────────┬─────────┤
+│ Idea          │ Pitch                                   │ Status    │ Updated    │ Notes   │ Actions │
+├───────────────┼─────────────────────────────────────────┼───────────┼────────────┼─────────┼─────────┤
+│ Top Thougts   │ Smartest person wins...                 │ Exploring │ 2026-06-20 │ 3 Notes │ Edit Del│
+├───────────────┬─────────────────────────────────────────┬───────────┬────────────┬─────────┬─────────┤
+│ Sky Orchard   │ Grow floating islands...                │ Exploring │ 2026-06-20 │ 3 Notes │ Edit Del│
+├───────────────┴─────────────────────────────────────────┴───────────┴────────────┴─────────┴─────────┤
+│ Clockwork...  │ Deliver messages through looping city...│ New       │ 2026-06-20 │ 0 Notes │ Edit Del│
+├───────────────┴─────────────────────────────────────────┴───────────┴────────────┴─────────┴─────────┤
+│ [ Add Idea ]                                                                                         │
+└──────────────────────────────────────────────────────────────────────────────────────────────────────┘
+
+
+Clicking {Sky Orchard {chevron down arrow}] Expands/Acording the Note(s) for that Idea
+┌────────────────────────────────────────────────────────────────────────────────────────────────────┐
+│ Idea Board                                                                                         │
+├───────────────┬─────────────────────────────────────────┬───────────┬────────────┬─────────┬─────────┤
+│ Idea          │ Pitch                                   │ Status    │ Updated    │ Notes   │ Actions │
+├───────────────┼─────────────────────────────────────────┼───────────┼────────────┼─────────┼─────────┤
+│ Top Thougts   │ Smartest person wins...                 │ Exploring │ 2026-06-20 │ 3 Notes │ Edit Del│
+├───────────────┬─────────────────────────────────────────┬───────────┬────────────┬─────────┬─────────┤
+│ Sky Orchard[^}│ Grow floating islands...                │ Exploring │ 2026-06-20 │ 3 Notes │ Edit Del│
+├───────────────┴─────────────────────────────────────────┴───────────┴────────────┴─────────┴─────────┤
+│ Notes                                                                                               │
+│ --------------------------------------------------------------------------------------------------- │
+│ note 1                                                           [Edit] [Delete]                   │
+│ System seed note: compare early ideas before project creation. [Edit]                              │
+│ Ask whether the core loop is planning, defense, or both.    [Edit] [Delete]                       │
+│                                                                                                     │
+│ [ Add Note ]                                                                                        │
+├───────────────┬─────────────────────────────────────────┬───────────┬────────────┬─────────┬─────────┤
+│ Clockwork...  │ Deliver messages through looping city...│ New       │ 2026-06-20 │ 0 Notes │ Edit Del│
+├───────────────┴─────────────────────────────────────────┴───────────┴────────────┴─────────┴─────────┤
+│ [ Add Idea ]                                                                                         │
+└──────────────────────────────────────────────────────────────────────────────────────────────────────┘
+
+Clickin Add Idea
+┌────────────────────────────────────────────────────────────────────────────────────────────────────┐
+│ Idea Board                                                                                        │
+├───────────────┬─────────────────────────────────────────┬───────────┬────────────┬─────────┬─────────┤
+│ Idea          │ Pitch                                   │ Status    │ Updated    │ Notes   │ Actions │
+├───────────────┼─────────────────────────────────────────┼───────────┼────────────┼─────────┼─────────┤
+│ Top Thougts   │ Smartest person wins...                 │ Exploring │ 2026-06-20 │ 3 Notes │ Edit Del│
+├───────────────┬─────────────────────────────────────────┬───────────┬────────────┬─────────┬─────────┤
+│ Sky Orchard   │ Grow floating islands...                │ Exploring │ 2026-06-20 │ 3 Notes │ Edit Del│
+├───────────────┴─────────────────────────────────────────┴───────────┴────────────┴─────────┴─────────┤
+│ Clockwork...  │ Deliver messages through looping city...│ New       │ 2026-06-20 │ 0 Notes │ Edit Del│
+├───────────────┴─────────────────────────────────────────┴───────────┴────────────┴─────────┴─────────┤
+│ [input.....]  │ [input.....]                            │ [Dropdown]│ [autofile] │ 0 Notes │ Save Can│
+└──────────────────────────────────────────────────────────────────────────────────────────────────────┘

docs_build/dev/admin-notes/index.txt

@@ -30,6 +30,8 @@ Owned paths:
 - `docs_build/dev/admin-notes/other/index.txt` is the simple subnote fixture.
 - `docs_build/dev/admin-notes/quick-reference.txt` is a linked text-note fixture.
 - `docs_build/dev/admin-notes/sample.txt` is a root-relative link example note.
+- `docs_build/dev/admin-notes/Installs required.txt` is a recognized Project Instructions reference file.
+- `docs_build/dev/admin-notes/Table layout.txt` is a recognized Project Instructions reference file.
 - `docs_build/dev/admin-notes/notes/index.txt` is retained historical admin-note content.
 
 Runtime boundary:
@@ -48,4 +50,3 @@ Runtime boundary:
 - name is up for discuttion  (this is my ideas, things I want to fix, undecided question)
 [ ] Correction Notes update
 [subnote] should be /[subnote]/note.txt
-

docs_build/dev/reports/PR_26175_OWNER_050-project-instructions-add-valid-reference-files.md

@@ -0,0 +1,70 @@
+# PR_26175_OWNER_050-project-instructions-add-valid-reference-files
+
+Date: 2026-06-24
+Team: OWNER
+Scope: Documentation/governance only
+Status: PASS
+
+## Summary
+
+- Added Project Reference Files Governance for recognized project instruction/reference documents.
+- Recognized `Installs required.txt` and `Table layout.txt` when present in `ProjectInstructions.zip`, the active project instruction directory, or `docs_build/dev/admin-notes/`.
+- Indexed the new addendum from the active Project Instructions README and operating-system root.
+- Updated the release gate, legacy startup guidance, root enforcement instructions, and admin-note ownership list so future reviews include these files automatically.
+- Added the two canonical admin-note reference files.
+- No runtime code changes and no UI changes were made.
+
+## Branch Validation
+
+PASS. Current branch is `codex/pr-26175-owner-050-project-instructions-add-valid-reference-files`, created from clean synchronized `main` at `99c53e368`.
+
+## Instruction Compliance
+
+- PASS: PR name includes OWNER team token.
+- PASS: Team OWNER owns governance/instruction-routing work.
+- PASS: Scope is documentation/governance only.
+- PASS: No runtime, UI, engine, backlog, or roadmap changes.
+- PASS: Required reports and ZIP artifact are produced for the BUILD.
+
+## Changed Files
+
+- `docs_build/dev/PROJECT_INSTRUCTIONS.md`
+- `docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md`
+- `docs_build/dev/ProjectInstructions/README.txt`
+- `docs_build/dev/ProjectInstructions/addendums/project_reference_files.md`
+- `docs_build/dev/ProjectInstructions/addendums/release_gate.md`
+- `docs_build/dev/admin-notes/index.txt`
+- `docs_build/dev/admin-notes/Installs required.txt`
+- `docs_build/dev/admin-notes/Table layout.txt`
+- `project-instructions/addendums/codex-project-instructions-startup.md`
+- `docs_build/pr/PLAN_PR_26175_OWNER_050-project-instructions-add-valid-reference-files.md`
+- `docs_build/dev/reports/PR_26175_OWNER_050-project-instructions-add-valid-reference-files.md`
+- `docs_build/dev/reports/PR_26175_OWNER_050-project-instructions-add-valid-reference-files_branch-validation.md`
+- `docs_build/dev/reports/PR_26175_OWNER_050-project-instructions-add-valid-reference-files_requirement-checklist.md`
+- `docs_build/dev/reports/PR_26175_OWNER_050-project-instructions-add-valid-reference-files_validation-lane.md`
+- `docs_build/dev/reports/PR_26175_OWNER_050-project-instructions-add-valid-reference-files_manual-validation-notes.md`
+- `docs_build/dev/reports/codex_changed_files.txt`
+- `docs_build/dev/reports/codex_review.diff`
+
+## Required Reports
+
+- `docs_build/dev/reports/codex_review.diff`
+- `docs_build/dev/reports/codex_changed_files.txt`
+- `docs_build/dev/reports/PR_26175_OWNER_050-project-instructions-add-valid-reference-files.md`
+- `docs_build/dev/reports/PR_26175_OWNER_050-project-instructions-add-valid-reference-files_branch-validation.md`
+- `docs_build/dev/reports/PR_26175_OWNER_050-project-instructions-add-valid-reference-files_requirement-checklist.md`
+- `docs_build/dev/reports/PR_26175_OWNER_050-project-instructions-add-valid-reference-files_validation-lane.md`
+- `docs_build/dev/reports/PR_26175_OWNER_050-project-instructions-add-valid-reference-files_manual-validation-notes.md`
+
+## Validation
+
+- PASS: `git status --short --branch`.
+- PASS: `git rev-list --left-right --count origin/main...HEAD`.
+- PASS: `git diff --name-only`.
+- PASS: `git diff --check`.
+- PASS: Targeted reference checks confirmed both filenames and the new addendum are referenced from active instruction surfaces.
+- PASS: File presence checks confirmed both canonical admin-note reference files exist.
+
+## Artifact
+
+- `tmp/PR_26175_OWNER_050-project-instructions-add-valid-reference-files_delta.zip`

docs_build/dev/reports/PR_26175_OWNER_050-project-instructions-add-valid-reference-files_branch-validation.md

@@ -0,0 +1,22 @@
+# PR_26175_OWNER_050-project-instructions-add-valid-reference-files Branch Validation
+
+## Branch
+`codex/pr-26175-owner-050-project-instructions-add-valid-reference-files`
+
+## Base
+- Base branch: `origin/main`
+- Base commit at branch creation: `99c53e368`
+
+## Checks
+- Current branch is the scoped OWNER_050 branch: PASS.
+- Branch was created from clean synchronized `main`: PASS.
+- Local/origin sync at branch creation was `0 0`: PASS.
+- Scope is limited to Project Instructions governance, admin-note reference files, plan, reports, and Codex review artifacts: PASS.
+- No runtime files changed: PASS.
+- No UI files changed: PASS.
+- No engine core files changed: PASS.
+- No backlog files changed: PASS.
+- No roadmap files changed: PASS.
+
+## Result
+PASS