Clean docs_build dev root

Author: ToolboxAid

docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md

@@ -23,6 +23,7 @@ The Project Instructions operating system provides additive governance for:
 - archive and history preservation
 - recognized project instruction/reference files
 - environment governance
+- tool and gameplay contract governance
 
 ## Preservation
 
@@ -47,6 +48,14 @@ Existing Project Instructions outside `docs_build/dev/ProjectInstructions/` rema
 
 `docs_build/dev/ProjectInstructions/addendums/environment_configuration_standards.md` defines official `.env` file names, environment variable values, host/domain configuration, API URL configuration, R2 prefix configuration, and feature flag governance.
 
+## Tool And Contract Governance
+
+`docs_build/dev/ProjectInstructions/addendums/workspace_v2_playwright_gate.md` defines the Workspace Manager V2 Playwright validation gate.
+
+`docs_build/dev/ProjectInstructions/addendums/samples2tools_adapter_guidance.md` defines the shared sample-to-tool launch and hydration guidance.
+
+`docs_build/dev/ProjectInstructions/addendums/koti_layout_contract.md` defines the King of the Iceberg layout data contract.
+
 ## Single Source and Main Lock Governance
 
 `docs_build/dev/ProjectInstructions/addendums/project_instructions_single_source_eod_lock.md` defines the single active Project Instructions source, canonical START / WORK / END branch lifecycle, EOD main lock, next-day reset, team branch creation gate, daily synchronization baseline, and mandatory hard stops.

docs_build/dev/ProjectInstructions/README.txt

@@ -56,3 +56,6 @@ Addendum index:
 - Project Reference Files Governance: docs_build/dev/ProjectInstructions/addendums/project_reference_files.md
 - Environment Governance Model: docs_build/dev/ProjectInstructions/addendums/environment_governance_model.md
 - Environment Configuration Standards: docs_build/dev/ProjectInstructions/addendums/environment_configuration_standards.md
+- Workspace V2 Playwright Gate: docs_build/dev/ProjectInstructions/addendums/workspace_v2_playwright_gate.md
+- Samples2Tools Adapter Guidance: docs_build/dev/ProjectInstructions/addendums/samples2tools_adapter_guidance.md
+- King of the Iceberg Layout Contract: docs_build/dev/ProjectInstructions/addendums/koti_layout_contract.md

docs_build/dev/koti_layout_contract.md …ctions/addendums/koti_layout_contract.mddocs_build/dev/koti_layout_contract.md renamed to docs_build/dev/ProjectInstructions/addendums/koti_layout_contract.md docs_build/dev/koti_layout_contract.md renamed to docs_build/dev/ProjectInstructions/addendums/koti_layout_contract.md

@@ -41,6 +41,9 @@ The release gate should confirm these files when relevant to the PR:
 - `docs_build/dev/ProjectInstructions/addendums/project_reference_files.md`
 - `docs_build/dev/ProjectInstructions/addendums/environment_governance_model.md`
 - `docs_build/dev/ProjectInstructions/addendums/environment_configuration_standards.md`
+- `docs_build/dev/ProjectInstructions/addendums/workspace_v2_playwright_gate.md`
+- `docs_build/dev/ProjectInstructions/addendums/samples2tools_adapter_guidance.md`
+- `docs_build/dev/ProjectInstructions/addendums/koti_layout_contract.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

docs_build/dev/ProjectInstructions/addendums/release_gate.md

@@ -6,14 +6,18 @@ Make `docs_build/dev/ProjectInstructions/` the only active Project Instructions
 
 ## Source Of Truth
 
-This `BUILD_PR.md`, `PLAN_PR.md`, and the user request are the source of truth for `PR_26177_OWNER_007-project-instructions-single-source-eod-lock`.
+This `docs_build/dev/pr/BUILD_PR.md`, `docs_build/dev/pr/PLAN_PR.md`, and the user request are the source of truth for `PR_26177_OWNER_007-project-instructions-single-source-eod-lock`.
 
 ## Exact Scope
 
 - Audit repo for ProjectInstructions / project instructions duplicates.
 - Establish `docs_build/dev/ProjectInstructions/` as the only active source.
 - Remove duplicate active instruction files from `docs_build/dev/` root.
 - Remove stale one-off PR/restart files from `docs_build/dev/` root.
+- Move PR-specific docs from `docs_build/dev/` root into `docs_build/dev/pr/`.
+- Move active governance/contract docs from `docs_build/dev/` root into `docs_build/dev/ProjectInstructions/addendums/`.
+- Move audit outputs from `docs_build/dev/` root into `docs_build/dev/reports/audits/`.
+- Delete stale one-off bundle metadata from `docs_build/dev/` root.
 - Keep preserved historical ProjectInstructions material reference-only.
 - Keep `project-instructions/` out of this PR except for a tiny deprecated pointer.
 - Update active team start/governance docs to reference only `docs_build/dev/ProjectInstructions/`.
@@ -22,13 +26,15 @@ This `BUILD_PR.md`, `PLAN_PR.md`, and the user request are the source of truth f
 
 ## Exact Targets
 
-- `docs_build/dev/PLAN_PR.md`
-- `docs_build/dev/BUILD_PR.md`
+- `docs_build/dev/pr/PLAN_PR.md`
+- `docs_build/dev/pr/BUILD_PR.md`
+- `docs_build/dev/pr/*.md`
 - `docs_build/dev/ProjectInstructions/README.txt`
 - `docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md`
 - `docs_build/dev/ProjectInstructions/TEAM_START_COMMANDS.md`
 - `docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md`
 - `docs_build/dev/ProjectInstructions/addendums/*.md`
+- `docs_build/dev/reports/audits/*.md`
 - `project-instructions/README.md` (tiny deprecated pointer only)
 - `docs_build/dev/PROJECT_INSTRUCTIONS.md` (delete)
 - `docs_build/dev/PROJECT_MULTI_PC.txt` (delete)
@@ -50,6 +56,8 @@ This `BUILD_PR.md`, `PLAN_PR.md`, and the user request are the source of truth f
 - `docs_build/dev/restart_notes_11_121.md` (delete)
 - `docs_build/dev/restart_notes_11_122.md` (delete)
 - `docs_build/dev/restart_notes_11_123.md` (delete)
+- `docs_build/dev/bundle_readme.md` (delete)
+- `docs_build/dev/validation_checklist.txt` (delete)
 - `docs_build/dev/reports/PR_26177_OWNER_007-project-instructions-single-source-eod-lock*.md`
 - `docs_build/dev/reports/codex_review.diff`
 - `docs_build/dev/reports/codex_changed_files.txt`
@@ -68,9 +76,19 @@ Run:
 ```powershell
 Test-Path docs_build/dev/PROJECT_INSTRUCTIONS.md
 Test-Path docs_build/dev/PROJECT_MULTI_PC.txt
+Test-Path docs_build/dev/BUILD_PR.md
+Test-Path docs_build/dev/PLAN_PR.md
+Test-Path docs_build/dev/workspace_v2_playwright_gate.md
+Test-Path docs_build/dev/samples2tools_adapter_guidance.md
+Test-Path docs_build/dev/security-audit.md
+Test-Path docs_build/dev/component-audit.md
+Test-Path docs_build/dev/css-audit.md
+Test-Path docs_build/dev/bundle_readme.md
+Test-Path docs_build/dev/validation_checklist.txt
 rg -n 'only active Project Instructions source|docs_build/dev/ProjectInstructions/' docs_build/dev/ProjectInstructions
 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
 git diff --name-status $(git merge-base HEAD origin/main) -- project-instructions
+git diff --name-status $(git merge-base HEAD origin/main) -- docs_build/dev/pr docs_build/dev/ProjectInstructions/addendums docs_build/dev/reports/audits
 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
 git diff --name-only -- src assets toolbox games api serverside package.json package-lock.json docs_build/dev/start_of_day
 git diff --check

…ld/dev/samples2tools_adapter_guidance.md …endums/samples2tools_adapter_guidance.mddocs_build/dev/samples2tools_adapter_guidance.md renamed to docs_build/dev/ProjectInstructions/addendums/samples2tools_adapter_guidance.md docs_build/dev/samples2tools_adapter_guidance.md renamed to docs_build/dev/ProjectInstructions/addendums/samples2tools_adapter_guidance.md

@@ -9,6 +9,10 @@ Make `docs_build/dev/ProjectInstructions/` the only active Project Instructions
 - Audit ProjectInstructions and project instructions duplicates.
 - Delete duplicate active instruction files from `docs_build/dev/` root.
 - Delete stale one-off PR/restart files from `docs_build/dev/` root.
+- Move PR-specific docs from `docs_build/dev/` root into `docs_build/dev/pr/`.
+- Move active governance/contract docs from `docs_build/dev/` root into `docs_build/dev/ProjectInstructions/addendums/`.
+- Move audit outputs from `docs_build/dev/` root into `docs_build/dev/reports/audits/`.
+- Delete stale one-off bundle metadata from `docs_build/dev/` root.
 - Preserve historical ProjectInstructions-style sources only as deprecated reference material.
 - Keep `project-instructions/` out of the PR except for a tiny deprecated pointer.
 - Move active legacy addendums into `docs_build/dev/ProjectInstructions/addendums/`.
@@ -28,6 +32,9 @@ Make `docs_build/dev/ProjectInstructions/` the only active Project Instructions
 1. Run targeted grep/search proving no active duplicate ProjectInstructions source remains.
 2. Confirm duplicate active root instruction files and stale one-off root files are absent.
 3. Confirm `project-instructions/**` has no PR changes except the tiny deprecated pointer.
-4. Confirm EOD/Next Day and canonical START / WORK / END branch lifecycle rules appear in active governance docs.
-5. Confirm no product/runtime files changed.
-6. Run `git diff --check`.
+4. Confirm docs_build/dev root no longer contains active loose instruction, audit, contract, or PR files.
+5. Confirm moved active governance/contract docs are under `docs_build/dev/ProjectInstructions/addendums/`.
+6. Confirm moved audit outputs are under `docs_build/dev/reports/audits/`.
+7. Confirm EOD/Next Day and canonical START / WORK / END branch lifecycle rules appear in active governance docs.
+8. Confirm no product/runtime files changed.
+9. Run `git diff --check`.