@@ -117,7 +117,7 @@ Rules:
 
 ## Current Version/Date
 
-- Project Instructions Version: 2026.06.28.006
+- Project Instructions Version: 2026.06.28.007
 - Date: 2026-06-28
 - Owner: OWNER
 
 
@@ -1,6 +1,6 @@
 # Project Instructions Version
 
-Current Project Instructions Version: 2026.06.28.006
+Current Project Instructions Version: 2026.06.28.007
 
 Last Updated: 2026-06-28
 
@@ -14,6 +14,7 @@ Last Updated: 2026-06-28
 - Added proposed repository layout architecture plan for future `www/`, `api/`, and `dev/` separation.
 - Added repository layout scaffold governance for `www/`, `api/`, and `dev/local-runtime/`.
 - Added `www/` migration map for safe browser-served application movement planning.
+- Added local route-root compatibility toggle documentation for future `www/` activation.
 - Codex must read this version file and the latest repository copy of `PROJECT_INSTRUCTIONS.md` before performing work.
 - Codex must discard previously remembered Project Instructions and treat the repository copy as authoritative.
 - Codex must validate canonical report and ZIP paths, branching model, and legacy path avoidance before work proceeds.
@@ -1,7 +1,7 @@
 # Project State
 
 ```yaml
-project_state_version: "2026.06.28.006"
+project_state_version: "2026.06.28.007"
 last_updated: "2026-06-28"
 current_main_commit: "40de767476d70cadfd1292c916844c2f31b6f185"
 repository_status:
@@ -10,18 +10,18 @@ repository_status:
   runtime_database: "Postgres"
   creator_metadata: "API to Postgres"
   creator_assets: "API to R2"
-project_instructions_version: "2026.06.28.006"
-repository_structure_version: "2026.06.28.006"
-canonical_layout_version: "2026.06.28.006"
+project_instructions_version: "2026.06.28.007"
+repository_structure_version: "2026.06.28.007"
+canonical_layout_version: "2026.06.28.007"
 active_teams:
   - "Owner"
   - "Alfa"
   - "Bravo"
   - "Charlie"
   - "Delta"
   - "Golf"
-latest_owner_pr: "PR_26180_OWNER_006-www-migration-map"
-latest_structure_pr: "PR_26180_OWNER_006-www-migration-map"
+latest_owner_pr: "PR_26180_OWNER_007-www-route-root-compatibility"
+latest_structure_pr: "PR_26180_OWNER_007-www-route-root-compatibility"
 valid_top_level_folders:
   - "account/"
   - "admin/"
 
@@ -39,8 +39,8 @@ The backlog is the authoritative source for determining the next logical PRs.
 - Team: Owner
 - Product Area: Repository Architecture Simplification
 - Status: Active
-- Percent Complete: 15%
-- Active PR: PR_26180_OWNER_006-www-migration-map
+- Percent Complete: 20%
+- Active PR: PR_26180_OWNER_007-www-route-root-compatibility
 - Next Milestone: Move browser-served application to `www/`
 - Source / Reference: `dev/build/ProjectInstructions/repository/repository_layout_architecture_plan.md`; `dev/build/ProjectInstructions/repository/www_migration_map.md`
 
 
@@ -170,6 +170,22 @@ Recommended approach for the actual move PR:
 5. Do not introduce browser redirects unless a static route cannot be served directly.
 6. Document every temporary shim with removal criteria for the legacy-layout cleanup PR.
 
+## Route Root Compatibility Toggle
+
+`PR_26180_OWNER_007-www-route-root-compatibility` installs the local compatibility switch without moving browser files.
+
+The future activation toggle is:
+
+```text
+GAMEFOUNDRY_LOCAL_WEB_ROOT=www
+```
+
+Default behavior remains current repository-root static serving when `GAMEFOUNDRY_LOCAL_WEB_ROOT` is unset, empty, `.`, `root`, or `repo-root`.
+
+When `GAMEFOUNDRY_LOCAL_WEB_ROOT=www`, local static serving prefers `www/` for public browser URLs while retaining repository-root fallback for compatibility during migration.
+
+This toggle is for local runtime and test helpers only. It does not change production deployment, public URLs, API routes, or package commands.
+
 ## Required Sequence For Safe www Move
 
 1. Freeze the public route contract.
 
@@ -0,0 +1,23 @@
+# PR_26180_OWNER_007 Branch Validation
+
+## Result
+
+PASS
+
+## Checks
+
+| Check | Result |
+|---|---|
+| Current branch is `PR_26180_OWNER_007-www-route-root-compatibility` | PASS |
+| Branch is stacked on `PR_26180_OWNER_006-www-migration-map` | PASS |
+| Startup validation completed | PASS |
+| Project Instructions version loaded | PASS: `2026.06.28.007` |
+| `PROJECT_BRANCHING_POLICY.md` loaded | PASS |
+| `BACKLOG_MASTER.md` loaded | PASS |
+| No browser-served files moved | PASS |
+| Reports path uses `dev/reports/` | PASS |
+| ZIP path uses `dev/workspace/zips/` | PASS |
+
+## Notes
+
+This is a stacked Owner PR based on `PR_26180_OWNER_006-www-migration-map`.
@@ -0,0 +1,22 @@
+# PR_26180_OWNER_007 Manual Validation Notes
+
+## Manual Review
+
+- Confirmed no browser-served files were moved.
+- Confirmed public URLs remain unchanged.
+- Confirmed the future web-root activation toggle is documented as `GAMEFOUNDRY_LOCAL_WEB_ROOT=www`.
+- Confirmed the default remains repository-root static serving until the actual `www/` move PR.
+- Confirmed route-root compatibility work is limited to local static serving and test helper support.
+
+## Manual Test Guidance
+
+After applying this PR, Owner can test:
+
+1. Start the current local development flow with no web-root override.
+2. Open `/index.html`, `/toolbox/index.html`, and an `/assets/...` URL.
+3. Confirm the routes continue to load from the current repository-root layout.
+4. In a future migration branch, set `GAMEFOUNDRY_LOCAL_WEB_ROOT=www` after browser files are moved and confirm the same public URLs load from `www/`.
+
+## Runtime Scope
+
+No UI, API, database, or product behavior changes are expected from this PR.
@@ -0,0 +1,47 @@
+# PR_26180_OWNER_007-www-route-root-compatibility Report
+
+## Executive Summary
+
+PASS. This PR prepares local static route-root compatibility for the future `www/` migration without moving browser-served files or changing public URLs.
+
+The implementation adds a shared local static route resolver that can prefer a configurable web root while preserving the current repository-root serving default. The documented future toggle is:
+
+```text
+GAMEFOUNDRY_LOCAL_WEB_ROOT=www
+```
+
+Default behavior remains current root serving when the variable is unset, empty, `.`, `root`, or `repo-root`.
+
+## Source Plan
+
+Used `dev/build/ProjectInstructions/repository/www_migration_map.md` as the source plan. The map now documents the route-root compatibility toggle and the default/future behavior split.
+
+## Changed Files
+
+- `dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md`
+- `dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS_VERSION.md`
+- `dev/build/ProjectInstructions/PROJECT_STATE.md`
+- `dev/build/ProjectInstructions/backlog/BACKLOG_MASTER.md`
+- `dev/build/ProjectInstructions/repository/www_migration_map.md`
+- `dev/scripts/start-dev.mjs`
+- `dev/tests/dev-runtime/StaticWebRootCompatibility.test.mjs`
+- `dev/tests/helpers/playwrightRepoServer.mjs`
+- `dev/tests/playwright/tools/StaticWebRootCompatibility.spec.mjs`
+- `src/dev-runtime/server/local-api-server.mjs`
+- `src/dev-runtime/server/static-web-root.mjs`
+
+## Implementation Notes
+
+- Added `src/dev-runtime/server/static-web-root.mjs` for shared local static route resolution.
+- Updated the local dev web server, Local API static fallback, and Playwright repo server helper to use the shared resolver.
+- Added configurable `webRoot` support for test helpers and local server internals.
+- Preserved public route URLs including `/index.html`, `/toolbox/index.html`, `/assets/...`, `/account/...`, `/admin/...`, and `/games/...`.
+- Preserved compatibility alias behavior such as `/tools/...` resolving to `/toolbox/...`.
+- Kept repository-root serving as the default until the actual `www/` move PR.
+- No browser-served files were moved.
+- No public URL changes were introduced.
+- No API/server architecture changes were introduced.
+
+## Owner Recommendation
+
+Ready for review as the route-root compatibility preparation step before moving browser-served files into `www/`.
@@ -0,0 +1,23 @@
+# PR_26180_OWNER_007 Requirement Checklist
+
+| Requirement | Result | Evidence |
+|---|---|---|
+| Use `www_migration_map.md` as source plan | PASS | Updated `dev/build/ProjectInstructions/repository/www_migration_map.md` with the compatibility toggle. |
+| Preserve `/index.html` | PASS | Covered by Node and Playwright route-root tests. |
+| Preserve `/toolbox/index.html` | PASS | Covered by Node and Playwright route-root tests. |
+| Preserve `/assets/...` | PASS | Covered by Node and Playwright route-root tests. |
+| Preserve `/account/...` | PASS | Covered by Node route normalization test. |
+| Preserve `/admin/...` | PASS | Covered by Node route normalization test. |
+| Preserve `/games/...` | PASS | Covered by Node route normalization test. |
+| Add configurable web root support | PASS | Added shared `resolveLocalWebRoot` / `resolveStaticRouteTarget` helper. |
+| Default remains current root serving | PASS | Default local web root is repository root. |
+| Document future toggle | PASS | Documented `GAMEFOUNDRY_LOCAL_WEB_ROOT=www`. |
+| Update targeted tests if needed | PASS | Added Node and Playwright route-root compatibility tests. |
+| No browser files moved | PASS | No root HTML/pages/assets/toolbox files moved. |
+| No public URL changes | PASS | URLs remain unchanged; only filesystem lookup is configurable. |
+| No API/server architecture change | PASS | Local static resolution was shared; API architecture was not changed. |
+| No product behavior change | PASS | Default local behavior remains root serving. |
+
+## Scope Result
+
+PASS. Changes are limited to route-root compatibility, tests/helpers, and governance/status documentation.
@@ -0,0 +1,24 @@
+# PR_26180_OWNER_007 Validation Report
+
+## Required Validation
+
+| Command | Result |
+|---|---|
+| `node --check src/dev-runtime/server/static-web-root.mjs` | PASS |
+| `node --check dev/scripts/start-dev.mjs` | PASS |
+| `node --check src/dev-runtime/server/local-api-server.mjs` | PASS |
+| `node --check dev/tests/helpers/playwrightRepoServer.mjs` | PASS |
+| `node --check dev/tests/dev-runtime/StaticWebRootCompatibility.test.mjs` | PASS |
+| `node --check dev/tests/playwright/tools/StaticWebRootCompatibility.spec.mjs` | PASS |
+| `node ./dev/scripts/run-node-test-files.mjs dev/tests/dev-runtime/StaticWebRootCompatibility.test.mjs` | PASS |
+| `npx playwright test dev/tests/playwright/tools/StaticWebRootCompatibility.spec.mjs --reporter=line` | PASS: 2/2 |
+| `git diff --check` | PASS |
+| `npm run validate:canonical-structure` | PASS |
+
+## Notes
+
+An exploratory broader Playwright route/navigation smoke was also attempted with `dev/tests/playwright/tools/ToolNavigationPrevNext.spec.mjs`. Two route-opening tests passed; one registry coverage assertion failed on a non-scope "Registry entry missing for Sprites" condition. The required focused route-root compatibility lane passed and no registry changes are included in this PR.
+
+## Result
+
+PASS