PR_26172_MASTER_001-project-instructions-readme-and-root

docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md

@@ -0,0 +1,34 @@
+# Project Instructions Operating System
+
+Read `README.txt` first.
+
+This file is the root index for the append-first Project Instructions operating system under `docs_build/dev/ProjectInstructions/`.
+
+## Purpose
+
+The Project Instructions operating system provides additive governance for:
+
+- backlog ownership
+- team assignments
+- multi-team branch and scope rules
+- Build Path status synchronization
+- tile overlay status behavior
+- deprecation workflow
+- archive and history preservation
+
+## Preservation
+
+Existing Project Instructions remain preserved in their current locations. This operating system adds structure without deleting or rewriting existing documentation.
+
+## Folders
+
+- `addendums/` contains additive governance rules.
+- `backlog/` contains the master backlog.
+- `team_assignments/` contains current team assignment records.
+- `deprecation/` contains deprecation workflow documentation.
+- `archive/` contains retained reference material.
+- `archive/history/` contains timestamped history snapshots.
+
+## Merge Control
+
+No PR in this operating system is merged without explicit owner approval.

docs_build/dev/ProjectInstructions/README.txt

@@ -0,0 +1,28 @@
+Read this file first.
+
+Folder purpose:
+This folder is the append-first Project Instructions operating system for Game Foundry Studio. It organizes active governance, backlog, team assignment, deprecation, and history material without deleting or rewriting the existing Project Instructions files elsewhere in the repository.
+
+Preservation rules:
+Preserve all existing documentation. Add new files or append explicit references unless the owner explicitly approves deletion or rewrite. When a conflict appears, stop, explain the conflict, and request owner approval before changing existing instruction text.
+
+Backlog workflow:
+Backlog work is tracked under backlog/. BACKLOG_MASTER.md is the planned source for backlog item status, notes, and references. Backlog item text is treated as immutable once created; status and notes may change under the governance addendums.
+
+Team assignment workflow:
+Team assignments are tracked under team_assignments/. A team pulls work from BACKLOG_MASTER.md, marks the item building when assigned, and records the active assignment under the owning team. Teams work only on assigned items unless a MASTER override explicitly changes the assignment.
+
+No direct commits to main:
+Do not commit directly to main unless the owner explicitly instructs that exception. Normal work must use PR branches, draft PRs, validation evidence, and owner-controlled merge approval.
+
+MASTER override rule:
+A MASTER override must use this wording:
+MASTER override approved: <reason>
+
+The override must explain why normal team, branch, assignment, or backlog routing is being changed.
+
+History snapshot rule:
+When a governance or instruction state needs a history snapshot, add a new file under archive/history/ using:
+CCYYMMDD_HHMMSS.md
+
+Do not rewrite history snapshots after creation unless the owner explicitly approves.

docs_build/dev/ProjectInstructions/addendums/.gitkeep

@@ -0,0 +1 @@
+Tracked placeholder for Project Instructions addendums.

docs_build/dev/ProjectInstructions/archive/history/.gitkeep

@@ -0,0 +1 @@
+Tracked placeholder for Project Instructions history snapshots.

docs_build/dev/ProjectInstructions/backlog/.gitkeep

@@ -0,0 +1 @@
+Tracked placeholder for Project Instructions backlog.

docs_build/dev/ProjectInstructions/deprecation/.gitkeep

@@ -0,0 +1 @@
+Tracked placeholder for Project Instructions deprecation workflow.

docs_build/dev/ProjectInstructions/team_assignments/.gitkeep

@@ -0,0 +1 @@
+Tracked placeholder for Project Instructions team assignments.

docs_build/dev/reports/PR_26172_MASTER_001-project-instructions-readme-and-root-instruction-compliance-checklist.md

@@ -0,0 +1,11 @@
+# PR_26172_MASTER_001 Instruction Compliance Checklist
+
+- PASS: Read `docs_build/dev/PROJECT_INSTRUCTIONS.md`.
+- PASS: Read `docs_build/dev/PROJECT_MULTI_PC.txt`.
+- PASS: Explicit MASTER override accepted Team MASTER for this operating-system bootstrap.
+- PASS: Branch name mirrors PR ownership: `pr/26172-MASTER-001-project-instructions-readme-and-root`.
+- PASS: Implementation path is `docs_build/dev/ProjectInstructions/`.
+- PASS: Existing Project Instructions were preserved.
+- PASS: No direct commit to `main`.
+- PASS: Required review artifacts are produced.
+- PASS: Required ZIP path is `tmp/PR_26172_MASTER_001-project-instructions-readme-and-root_delta.zip`.

docs_build/dev/reports/PR_26172_MASTER_001-project-instructions-readme-and-root-manual-validation-notes.md

@@ -0,0 +1,9 @@
+# PR_26172_MASTER_001 Manual Validation Notes
+
+- Confirmed branch was created from latest `main`.
+- Confirmed only new files were added.
+- Confirmed existing Project Instructions files were not deleted or rewritten.
+- Confirmed `README.txt` includes every requested topic.
+- Confirmed placeholders are used only to track requested empty folders.
+- Did not run Playwright because this is documentation-only.
+- Did not run samples.

docs_build/dev/reports/PR_26172_MASTER_001-project-instructions-readme-and-root.md

@@ -0,0 +1,22 @@
+# PR_26172_MASTER_001-project-instructions-readme-and-root
+
+## Scope
+
+Create the Project Instructions operating system root under `docs_build/dev/ProjectInstructions/`.
+
+## Changes
+
+- Added root `README.txt` with first-read guidance, preservation rules, backlog workflow, team assignment workflow, direct-main restriction, MASTER override wording, and history snapshot rule.
+- Added root `PROJECT_INSTRUCTIONS.md` as the operating system index.
+- Added tracked placeholders for requested folders so Git carries the directory structure.
+
+## Validation
+
+- `git diff --check`
+- Markdown/text review for requested README topics.
+- Playwright skipped: no runtime UI files changed.
+- Samples skipped: not requested and no sample files changed.
+
+## ZIP
+
+`tmp/PR_26172_MASTER_001-project-instructions-readme-and-root_delta.zip`

docs_build/dev/reports/codex_changed_files.txt

@@ -1,6 +1,12 @@
-docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-instruction-compliance-checklist.md
-docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-manual-validation-notes.md
-docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup.md
+docs_build/dev/ProjectInstructions/addendums/.gitkeep
+docs_build/dev/ProjectInstructions/archive/history/.gitkeep
+docs_build/dev/ProjectInstructions/backlog/.gitkeep
+docs_build/dev/ProjectInstructions/deprecation/.gitkeep
+docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md
+docs_build/dev/ProjectInstructions/README.txt
+docs_build/dev/ProjectInstructions/team_assignments/.gitkeep
 docs_build/dev/reports/codex_changed_files.txt
 docs_build/dev/reports/codex_review.diff
-src/dev-runtime/persistence/mock-db-store.js
+docs_build/dev/reports/PR_26172_MASTER_001-project-instructions-readme-and-root.md
+docs_build/dev/reports/PR_26172_MASTER_001-project-instructions-readme-and-root-instruction-compliance-checklist.md
+docs_build/dev/reports/PR_26172_MASTER_001-project-instructions-readme-and-root-manual-validation-notes.md

docs_build/dev/reports/codex_review.diff

@@ -1,138 +1,21 @@
-diff --git a/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-instruction-compliance-checklist.md b/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-instruction-compliance-checklist.md
-new file mode 100644
-index 000000000..a07705200
---- /dev/null
-+++ b/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-instruction-compliance-checklist.md
-@@ -0,0 +1,28 @@
-+# PR_26171_GAMMA_027 Instruction Compliance Checklist
-+
-+## Start Gate
-+
-+- PASS: Read `docs_build/dev/PROJECT_INSTRUCTIONS.md`.
-+- PASS: Read `docs_build/dev/PROJECT_MULTI_PC.txt`.
-+- PASS: PR name includes TEAM token `GAMMA`.
-+- PASS: Branch name mirrors TEAM token: `pr/26171-GAMMA-027-sqlite-doc-reference-cleanup`.
-+- PASS: Scope is diagnostics/cleanup and belongs to Team Gamma.
-+- PASS: Started from fresh `main` after PR 026 merged.
-+- PASS: Repository was clean before branch creation.
-+
-+## Scope Guard
-+
-+- PASS: One PR purpose only.
-+- PASS: Cleaned active docs/seed wording only.
-+- PASS: Preserved `PROJECT_INSTRUCTIONS.md` SQLite deprecation rules.
-+- PASS: Did not rewrite historical PR/report archives.
-+- PASS: Did not run samples.
-+
-+## Completion Gate
-+
-+- PASS: PR-specific report exists.
-+- PASS: Manual validation notes exist.
-+- PASS: Instruction compliance checklist exists.
-+- PASS: `docs_build/dev/reports/codex_review.diff` exists.
-+- PASS: `docs_build/dev/reports/codex_changed_files.txt` exists.
-+- PASS: Repo-structured ZIP path is documented: `tmp/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup_delta.zip`.
-diff --git a/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-manual-validation-notes.md b/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-manual-validation-notes.md
-new file mode 100644
-index 000000000..415d83d27
---- /dev/null
-+++ b/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-manual-validation-notes.md
-@@ -0,0 +1,17 @@
-+# PR_26171_GAMMA_027 Manual Validation Notes
-+
-+Manual validation focused on active docs/seed wording.
-+
-+## Notes
-+
-+- Confirmed PR 027 branch was created from fresh `main` after PR 026 merged.
-+- Confirmed `PROJECT_INSTRUCTIONS.md` deprecation rules were preserved.
-+- Confirmed historical report and PR docs were not modified.
-+- Confirmed the only active seed wording change was the Local DB session-mode description.
-+- Confirmed remaining SQLite references in active paths are governance, validation guards, negative tests, or legacy data-preservation guard text.
-+
-+## Skipped
-+
-+- Playwright was skipped because no UI behavior changed.
-+- Samples were skipped by request.
-+- Broad tests were skipped because this is a wording-only cleanup.
-diff --git a/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup.md b/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup.md
-new file mode 100644
-index 000000000..ecb1a233d
---- /dev/null
-+++ b/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup.md
-@@ -0,0 +1,43 @@
-+# PR_26171_GAMMA_027-sqlite-doc-reference-cleanup
-+
-+TEAM ownership: GAMMA.
-+
-+## Scope
-+
-+Clean active docs/seed wording that implied SQLite is still an active persistence target.
-+
-+## Changes
-+
-+- Updated `src/dev-runtime/persistence/mock-db-store.js` session-mode description from SQLite-backed wording to neutral Local DB adapter wording.
-+- Preserved `PROJECT_INSTRUCTIONS.md` SQLite deprecation rules.
-+- Did not rewrite historical PR/report archives.
-+- Did not remove governance, validation guard, negative test, or legacy data-preservation references.
-+
-+## Validation
-+
-+Passed:
-+- `git diff --check`
-+- `node --check src/dev-runtime/persistence/mock-db-store.js`
-+- Targeted text check confirmed no active docs/seed wording still says `SQLite-backed`, `SQLite persistence`, `SQLite service`, or `backed by server SQLite storage`.
-+- Scoped active-source search confirmed remaining non-archive SQLite references are limited to:
-+  - governance rules in `PROJECT_INSTRUCTIONS.md`
-+  - validation guard patterns in `scripts/validate-browser-env-agnostic.mjs`
-+  - negative test assertions that SQLite is not exposed
-+  - Game Journey legacy SQLite data-preservation guard
-+
-+Skipped:
-+- Playwright: no UI/runtime behavior changed.
-+- Samples: skipped by request.
-+- Historical reports and PR docs: explicitly out of scope.
-+
-+## Reports
-+
-+- `docs_build/dev/reports/codex_review.diff`
-+- `docs_build/dev/reports/codex_changed_files.txt`
-+- `docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup.md`
-+- `docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-manual-validation-notes.md`
-+- `docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-instruction-compliance-checklist.md`
-+
-+## ZIP
-+
-+`tmp/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup_delta.zip`
-diff --git a/docs_build/dev/reports/codex_changed_files.txt b/docs_build/dev/reports/codex_changed_files.txt
-index 4e23ae82e..5ebd4f6a7 100644
+diff --git a/docs_build/dev/reports/codex_changed_files.txt b/docs_build/dev/reports/codex_changed_files.txt
+index 5ebd4f6a7..7bcb23257 100644
 --- a/docs_build/dev/reports/codex_changed_files.txt
 +++ b/docs_build/dev/reports/codex_changed_files.txt
-@@ -1,10 +1,6 @@
--docs_build/dev/reports/PR_26171_GAMMA_026-sqlite-test-reference-cleanup-instruction-compliance-checklist.md
--docs_build/dev/reports/PR_26171_GAMMA_026-sqlite-test-reference-cleanup-manual-validation-notes.md
--docs_build/dev/reports/PR_26171_GAMMA_026-sqlite-test-reference-cleanup.md
-+docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-instruction-compliance-checklist.md
-+docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-manual-validation-notes.md
-+docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup.md
+@@ -1,6 +1,12 @@
+-docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-instruction-compliance-checklist.md
+-docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-manual-validation-notes.md
+-docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup.md
++docs_build/dev/ProjectInstructions/addendums/.gitkeep
++docs_build/dev/ProjectInstructions/archive/history/.gitkeep
++docs_build/dev/ProjectInstructions/backlog/.gitkeep
++docs_build/dev/ProjectInstructions/deprecation/.gitkeep
++docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md
++docs_build/dev/ProjectInstructions/README.txt
++docs_build/dev/ProjectInstructions/team_assignments/.gitkeep
  docs_build/dev/reports/codex_changed_files.txt
  docs_build/dev/reports/codex_review.diff
--tests/dev-runtime/DbSeedIntegrity.test.mjs
--tests/playwright/tools/AdminDbViewer.spec.mjs
--tests/playwright/tools/BrowserApiUrlConfig.spec.mjs
--tests/playwright/tools/GameJourneyTool.spec.mjs
--tests/playwright/tools/LoginSessionMode.spec.mjs
-+src/dev-runtime/persistence/mock-db-store.js
-diff --git a/src/dev-runtime/persistence/mock-db-store.js b/src/dev-runtime/persistence/mock-db-store.js
-index 2305910bc..c98c915b5 100644
---- a/src/dev-runtime/persistence/mock-db-store.js
-+++ b/src/dev-runtime/persistence/mock-db-store.js
-@@ -23,7 +23,7 @@ export const MOCK_DB_SESSION_MODES = Object.freeze([
-     adapterId: "local-db",
-     adapterName: "LocalDbAdapter",
-     configured: true,
--    description: "Uses LocalDbAdapter backed by server SQLite storage.",
-+    description: "Uses the Local DB adapter behind the server API boundary.",
-     environment: "Local DB",
-     id: "local-db",
-     label: "Local DB",
+-src/dev-runtime/persistence/mock-db-store.js
++docs_build/dev/reports/PR_26172_MASTER_001-project-instructions-readme-and-root.md
++docs_build/dev/reports/PR_26172_MASTER_001-project-instructions-readme-and-root-instruction-compliance-checklist.md
++docs_build/dev/reports/PR_26172_MASTER_001-project-instructions-readme-and-root-manual-validation-notes.md