Move reports and artifacts workspace

Author: ToolboxAid

.gitignore

@@ -17,8 +17,10 @@ NEXT_COMMAND.txt
 node_modules/
 tests/results/
 tests/results/**
-tmp/test-results/
-tmp/test-results/**
+dev/workspace/artifacts/tmp/
+dev/workspace/artifacts/tmp/**
+dev/workspace/artifacts/tmp/test-results/
+dev/workspace/artifacts/tmp/test-results/**
 tmp/
 scripts/untracked/
 projects/
@@ -47,4 +49,4 @@ docs/dev/reports/playwright_v8_coverage_report.txt
 
 # Game Foundry Studio project files
 assets/*.gfsp
-docs_build/dev/ProjectInstructions.zip
+dev/docs_build/dev/ProjectInstructions.zip

README.md

@@ -29,11 +29,11 @@ This repository follows a docs-first game/runtime model, combining a stable engi
 ## ▶️ Start Here
 
 1. Review the repo model in [docs/README.md](docs/README.md)
-2. Explore the roadmap in [docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE.md](docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE.md)
-3. Browse archived reference samples from [archive/v1-v2/samples/index.html](archive/v1-v2/samples/index.html)
+2. Explore active development governance in [dev/docs_build/dev/ProjectInstructions/](dev/docs_build/dev/ProjectInstructions/)
+3. Browse archived reference samples from [dev/archive/v1-v2/samples/index.html](dev/archive/v1-v2/samples/index.html)
 4. Explore tools under [toolbox/](toolbox/)
 5. Review engine and architecture boundaries in [docs/architecture/](docs/architecture/)
-6. Follow the workflow in [docs_build/dev/](docs_build/dev/) and [docs_build/pr/](docs_build/pr/)
+6. Follow the workflow in [dev/docs_build/dev/](dev/docs_build/dev/) and [dev/docs_build/dev/PR/](dev/docs_build/dev/PR/)
 
 ---
 
@@ -105,18 +105,18 @@ PLAN_PR → BUILD_PR → APPLY_PR
 - One PR per purpose
 - Small, surgical changes
 - Docs-first implementation planning
-- Delta ZIP outputs stored under `<project folder>/tmp/`
+- Delta ZIP outputs stored under `<project folder>/dev/workspace/artifacts/tmp/`
 
 ---
 
 ## 📚 Documentation Map
 
 - [docs/README.md](docs/README.md) → top-level documentation index
 - [docs/architecture/](docs/architecture/) → durable architecture and boundary contracts
-- [docs_build/pr/](docs_build/pr/) → preserved PR history and architecture evolution
-- [docs_build/dev/](docs_build/dev/) → active workflow controls and implementation planning
-- [docs_build/dev/reports/](docs_build/dev/reports/) → active report artifacts
-- [docs_build/archive/](docs_build/archive/) → archived dev-ops notes and generated reports
+- [dev/docs_build/dev/PR/](dev/docs_build/dev/PR/) → preserved PR history and architecture evolution
+- [dev/docs_build/dev/](dev/docs_build/dev/) → active workflow controls and implementation planning
+- [dev/reports/](dev/reports/) → active report artifacts
+- [dev/archive/](dev/archive/) → archived dev-ops notes and generated reports
 
 ---
 

dev/README.md

@@ -13,7 +13,9 @@ This folder is the destination shell for non-deployable development workspace ma
 
 ## Governance Workspace
 
-- `dev/docs_build/` owns active development governance, PR workflow material, and generated reports.
+- `dev/docs_build/` owns active development governance and PR workflow material.
+- `dev/reports/` owns generated reports.
+- `dev/workspace/artifacts/` owns generated non-report artifacts and local temporary workspace output.
 - `dev/archive/` owns historical development reference material.
 - `dev/project-instructions/` is deprecated reference only; active Project Instructions live under `dev/docs_build/dev/ProjectInstructions/`.
 

dev/config/playwright.config.cjs

@@ -5,23 +5,23 @@ const repoPath = (...segments) => path.join(repoRoot, ...segments);
 
 module.exports = {
   timeout: 120000,
-  outputDir: repoPath("tmp", "test-results"),
+  outputDir: repoPath("dev", "workspace", "artifacts", "tmp", "test-results"),
   projects: [
     {
       name: "ui",
       testDir: repoPath("dev", "tests", "ui"),
-      outputDir: repoPath("tmp", "test-results", "artifacts")
+      outputDir: repoPath("dev", "workspace", "artifacts", "tmp", "test-results", "artifacts")
     },
     {
       name: "playwright",
       testDir: repoPath("dev", "tests", "playwright"),
-      outputDir: repoPath("tmp", "test-results", "artifacts")
+      outputDir: repoPath("dev", "workspace", "artifacts", "tmp", "test-results", "artifacts")
     }
   ],
   reporter: [
     ["list"],
-    ["html", { outputFolder: repoPath("tmp", "test-results", "report"), open: "always" }],
-    ["json", { outputFile: repoPath("tmp", "test-results", "playwright-results.json") }]
+    ["html", { outputFolder: repoPath("dev", "workspace", "artifacts", "tmp", "test-results", "report"), open: "always" }],
+    ["json", { outputFile: repoPath("dev", "workspace", "artifacts", "tmp", "test-results", "playwright-results.json") }]
   ],
   use: {
     headless: false,

dev/docs_build/dev/PR/README.md

@@ -8,7 +8,7 @@ This folder owns reusable PR workflow material and historical PR reference docum
 - `reference/` contains historical or reference PR documents.
 
 Reusable PR templates must not live outside `dev/docs_build/dev/PR/templates/`.
-Generated PR reports must live under `dev/docs_build/dev/reports/`.
+Generated PR reports must live under `dev/reports/`.
 Permanent governance must live under `dev/docs_build/dev/ProjectInstructions/`.
 
 ## Rules

dev/docs_build/dev/PR/reference/OWNER_007_BUILD_PR.md

@@ -16,7 +16,7 @@ This `dev/docs_build/dev/pr/BUILD_PR.md`, `dev/docs_build/dev/pr/PLAN_PR.md`, an
 - Remove stale one-off PR/restart files from `dev/docs_build/dev/` root.
 - Move PR-specific docs from `dev/docs_build/dev/` root into `dev/docs_build/dev/pr/`.
 - Move active governance/contract docs from `dev/docs_build/dev/` root into `dev/docs_build/dev/ProjectInstructions/addendums/`.
-- Move audit outputs from `dev/docs_build/dev/` root into `dev/docs_build/dev/reports/audits/`.
+- Move audit outputs from `dev/docs_build/dev/` root into `dev/reports/audits/`.
 - Delete stale one-off bundle metadata from `dev/docs_build/dev/` root.
 - Add Tool MVP Stacked PR Standard under `dev/docs_build/dev/ProjectInstructions/`.
 - Update PR planning/template and report requirements for tool MVP PRs.
@@ -28,7 +28,7 @@ This `dev/docs_build/dev/pr/BUILD_PR.md`, `dev/docs_build/dev/pr/PLAN_PR.md`, an
 - Keep `dev/project-instructions/` out of this PR except for a tiny deprecated pointer.
 - Update active team start/governance docs to reference only `dev/docs_build/dev/ProjectInstructions/`.
 - Add EOD main lock, next-day reset governance, and canonical START / WORK / END branch lifecycle rules.
-- Add required reports under `dev/docs_build/dev/reports/`.
+- Add required reports under `dev/reports/`.
 
 ## Exact Targets
 
@@ -43,7 +43,7 @@ This `dev/docs_build/dev/pr/BUILD_PR.md`, `dev/docs_build/dev/pr/PLAN_PR.md`, an
 - `dev/docs_build/dev/ProjectInstructions/addendums/tool_mvp_stacked_pr_standard.md`
 - `dev/docs_build/dev/ProjectInstructions/addendums/no_mock_repository_runtime_source.md`
 - `dev/docs_build/dev/ProjectInstructions/addendums/preservation.md`
-- `dev/docs_build/dev/reports/audits/*.md`
+- `dev/reports/audits/*.md`
 - `dev/archive/docs_build/dev/dod/*.md`
 - `dev/archive/docs_build/dev/roadmaps/*.md`
 - `dev/project-instructions/README.md` (tiny deprecated pointer only)
@@ -80,10 +80,10 @@ This `dev/docs_build/dev/pr/BUILD_PR.md`, `dev/docs_build/dev/pr/PLAN_PR.md`, an
 - `dev/docs_build/dev/roadmaps/MIDI_STUDIO_V2_ROADMAP.md` (move to root archive)
 - `dev/docs_build/dev/roadmaps/phases.txt` (move to root archive)
 - `dev/docs_build/dev/roadmaps/README.md` (move to root archive)
-- `dev/docs_build/dev/reports/legacy-docs-archive-report.md`
-- `dev/docs_build/dev/reports/PR_26177_OWNER_007-project-instructions-single-source-eod-lock*.md`
-- `dev/docs_build/dev/reports/codex_review.diff`
-- `dev/docs_build/dev/reports/codex_changed_files.txt`
+- `dev/reports/legacy-docs-archive-report.md`
+- `dev/reports/PR_26177_OWNER_007-project-instructions-single-source-eod-lock*.md`
+- `dev/reports/codex_review.diff`
+- `dev/reports/codex_changed_files.txt`
 
 ## Out Of Scope
 
@@ -111,14 +111,14 @@ Test-Path dev/docs_build/dev/validation_checklist.txt
 rg -n 'only active Project Instructions source|dev/docs_build/dev/ProjectInstructions/' dev/docs_build/dev/ProjectInstructions
 rg -n 'Tool MVP Stacked PR Standard|Creator-testable outcome|What can Mr\\. Q test after applying this ZIP|What Playwright tests|What Mr\\. Q should manually test|Previous PR dependency|Next PR dependency' dev/docs_build/dev/ProjectInstructions
 rg -n 'No Mock Repository Runtime Source|Browser → API → Database|Mock repositories are 100% technical debt|Game Configuration mock repository ready|Seeded demo data is fine only when it is stored in the database and read back through the API' dev/docs_build/dev/ProjectInstructions
-rg -n 'dev/archive/docs_build/dev/ProjectInstructions/history|dev/archive/docs_build/dev/dod|dev/archive/docs_build/dev/roadmaps' dev/docs_build/dev/ProjectInstructions dev/docs_build/dev/reports/legacy-docs-archive-report.md
+rg -n 'dev/archive/docs_build/dev/ProjectInstructions/history|dev/archive/docs_build/dev/dod|dev/archive/docs_build/dev/roadmaps' dev/docs_build/dev/ProjectInstructions dev/reports/legacy-docs-archive-report.md
 Test-Path dev/docs_build/dev/archive
 Test-Path dev/docs_build/dev/dod
 Test-Path dev/docs_build/dev/dod/tool_ui_readiness_dod.md
 Test-Path dev/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE.md
 rg -n 'dev/docs_build/dev/PROJECT_INSTRUCTIONS.md.*source of truth|Codex must always read `dev/docs_build/dev/PROJECT_INSTRUCTIONS.md`|Read `dev/docs_build/dev/PROJECT_INSTRUCTIONS.md`' dev/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) -- dev/docs_build/dev/pr dev/docs_build/dev/ProjectInstructions/addendums dev/docs_build/dev/reports/audits
+git diff --name-status $(git merge-base HEAD origin/main) -- dev/docs_build/dev/pr dev/docs_build/dev/ProjectInstructions/addendums 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" dev/docs_build/dev/ProjectInstructions
 git diff --name-only -- src assets toolbox games api serverside package.json package-lock.json dev/docs_build/dev/start_of_day
 git diff --check

dev/docs_build/dev/PR/reference/OWNER_007_PLAN_PR.md

@@ -11,7 +11,7 @@ Make `dev/docs_build/dev/ProjectInstructions/` the only active Project Instructi
 - Delete stale one-off PR/restart files from `dev/docs_build/dev/` root.
 - Move PR-specific docs from `dev/docs_build/dev/` root into `dev/docs_build/dev/pr/`.
 - Move active governance/contract docs from `dev/docs_build/dev/` root into `dev/docs_build/dev/ProjectInstructions/addendums/`.
-- Move audit outputs from `dev/docs_build/dev/` root into `dev/docs_build/dev/reports/audits/`.
+- Move audit outputs from `dev/docs_build/dev/` root into `dev/reports/audits/`.
 - Delete stale one-off bundle metadata from `dev/docs_build/dev/` root.
 - Add Tool MVP Stacked PR Standard under `dev/docs_build/dev/ProjectInstructions/`.
 - Update PR planning/template and report requirements for tool MVP PRs.
@@ -24,7 +24,7 @@ Make `dev/docs_build/dev/ProjectInstructions/` the only active Project Instructi
 - Move active legacy addendums into `dev/docs_build/dev/ProjectInstructions/addendums/`.
 - Update active team start and governance docs to reference only `dev/docs_build/dev/ProjectInstructions/`.
 - Add EOD main lock, next-day reset, team PR branch creation gate, and canonical START / WORK / END branch lifecycle rules.
-- Add required Codex reports under `dev/docs_build/dev/reports/`.
+- Add required Codex reports under `dev/reports/`.
 
 ## Out Of Scope
 
@@ -40,7 +40,7 @@ Make `dev/docs_build/dev/ProjectInstructions/` the only active Project Instructi
 3. Confirm `dev/project-instructions/**` has no PR changes except the tiny deprecated pointer.
 4. Confirm dev/docs_build/dev root no longer contains active loose instruction, audit, contract, or PR files.
 5. Confirm moved active governance/contract docs are under `dev/docs_build/dev/ProjectInstructions/addendums/`.
-6. Confirm moved audit outputs are under `dev/docs_build/dev/reports/audits/`.
+6. Confirm moved audit outputs are under `dev/reports/audits/`.
 7. Confirm Tool MVP Stacked PR Standard appears in active ProjectInstructions.
 8. Confirm tool MVP PR template/report requirements include Creator-testable outcome, Playwright tests, Mr. Q manual test, stack membership, and previous/next dependency.
 9. Confirm No Mock Repository Runtime Source governance appears in active ProjectInstructions.

dev/docs_build/dev/PR/reference/pr_koti_layout_contract.md

@@ -12,9 +12,9 @@ This PR is documentation/contract only. Do not implement gameplay.
 
 Use the validated artifacts from the prior workflow pass:
 
-- `tmp/uat_exports/king_of_the_iceberg_layout_snapshot.json`
-- `tmp/uat_tool_layout_workflow_results.json`
-- `dev/docs_build/dev/reports/PR_tool_layout_workflow_baseline_report.md`
+- `dev/workspace/artifacts/tmp/uat_exports/king_of_the_iceberg_layout_snapshot.json`
+- `dev/workspace/artifacts/tmp/uat_tool_layout_workflow_results.json`
+- `dev/reports/PR_tool_layout_workflow_baseline_report.md`
 
 ---
 

dev/docs_build/dev/PR/reference/pr_tool_fix_fullscreen_exit_state.md

@@ -129,7 +129,7 @@ Browser validation:
 Create:
 
 ```txt
-tmp/pr_tool_fix_fullscreen_exit_state_validation.json
+dev/workspace/artifacts/tmp/pr_tool_fix_fullscreen_exit_state_validation.json
 ```
 
 Include:
@@ -149,7 +149,7 @@ Include:
 Create:
 
 ```txt
-dev/docs_build/dev/reports/PR_tool_fix_fullscreen_exit_state_report.md
+dev/reports/PR_tool_fix_fullscreen_exit_state_report.md
 ```
 
 Include:

dev/docs_build/dev/PR/reference/pr_tool_fix_parallax_header_metadata.md

@@ -189,7 +189,7 @@ Browser validation:
 Create:
 
 ```txt
-tmp/pr_tool_fix_parallax_header_metadata_validation.json
+dev/workspace/artifacts/tmp/pr_tool_fix_parallax_header_metadata_validation.json
 ```
 
 Include:
@@ -210,7 +210,7 @@ Include:
 Create:
 
 ```txt
-dev/docs_build/dev/reports/PR_tool_fix_parallax_header_metadata_report.md
+dev/reports/PR_tool_fix_parallax_header_metadata_report.md
 ```
 
 Include: