Normalize tools README V2 sections and tool listings - PR_26140_083-normalize-tools-readme-v2-sections

Author: DavidQ

docs/dev/reports/tools_readme_v2_normalization_report.md

@@ -0,0 +1,39 @@
+# PR_26140_083 Tools README V2 Normalization Report
+
+## Summary
+- Split `docs/tools/README.md` from one mixed `Primary Tool UAT Docs` section into:
+  - `Primary Tool UAT Docs - Legacy`
+  - `Primary Tool UAT Docs - V2`
+- Added Asset Manager V2 to the V2 UAT list.
+- Added Palette Manager V2 to the V2 UAT list.
+- Kept Object Vector Studio V2 and World Vector Studio V2 in the V2 section after PR_26140_082.
+- Added missing standardized UAT docs for Asset Manager V2 and Palette Manager V2 so the README links resolve.
+
+## Scope
+- Documentation only.
+- No schema changes.
+- No sample JSON changes.
+- No runtime behavior changes.
+
+## Playwright Impact
+- Playwright impacted: No.
+- No Playwright impact. This PR is docs/workflow only.
+
+## Validation
+- Ran markdown/link sanity validation for `docs/tools/README.md`.
+- Confirmed `Asset Manager V2` appears in `docs/tools/README.md`.
+- Confirmed `Palette Manager V2` appears in `docs/tools/README.md`.
+- Confirmed `Primary Tool UAT Docs - Legacy` appears in `docs/tools/README.md`.
+- Confirmed `Primary Tool UAT Docs - V2` appears in `docs/tools/README.md`.
+- Confirmed every local markdown link in `docs/tools/README.md` resolves.
+- Ran whitespace sanity validation for the changed docs files with `git diff --check`.
+- Confirmed no schema files or sample JSON files were changed by this PR.
+
+## Manual Validation
+- Open `docs/tools/README.md`.
+- Confirm legacy tools are listed under `Primary Tool UAT Docs - Legacy`.
+- Confirm V2 tools are listed under `Primary Tool UAT Docs - V2`.
+- Confirm Asset Manager V2 and Palette Manager V2 links open their UAT docs.
+
+## Full Samples Smoke Test
+- Not run. This PR is docs-only and does not affect sample runtime behavior.

docs/tools/README.md

@@ -5,9 +5,7 @@ This folder is standardized on UAT documentation.
 ## UAT Standard Path
 - `docs/tools/<tool-name>/uat.md`
 
-## Primary Tool UAT Docs
-- [World Vector Studio V2](./world-vector-studio-v2/uat.md)
-- [Object Vector Studio V2](./object-vector-studio-v2/uat.md)
+## Primary Tool UAT Docs - Legacy
 - [Tilemap Studio](./tilemap-studio/uat.md)
 - [Parallax Scene Studio](./parallax-scene-studio/uat.md)
 - [Sprite Editor](./sprite-editor/uat.md)
@@ -25,6 +23,12 @@ This folder is standardized on UAT documentation.
 - [Tool Host](./tool-host/uat.md)
 - [Tools Index And Registry](./tools-index-registry/uat.md)
 
+## Primary Tool UAT Docs - V2
+- [Asset Manager V2](./asset-manager-v2/uat.md)
+- [Palette Manager V2](./palette-manager-v2/uat.md)
+- [World Vector Studio V2](./world-vector-studio-v2/uat.md)
+- [Object Vector Studio V2](./object-vector-studio-v2/uat.md)
+
 ## UAT Reports
 - [Tool Inventory](../dev/reports/tool_inventory.md)
 - [Tool UAT Template](../dev/reports/tool_uat_template.md)

docs/tools/asset-manager-v2/uat.md

@@ -0,0 +1,13 @@
+# Asset Manager V2 - UAT
+
+Validate that Asset Manager V2 is the active V2 surface for authoring and validating manifest-owned assets.
+
+## Scope
+- Tool: `asset-manager-v2`
+- Entry point: `tools/asset-manager-v2/index.html`
+- Purpose: create and validate audio, color, data, font, image, localization, shader, and video asset entries for V2 workspace and game manifest flows.
+
+## Expected
+- Tool launches from the tools index.
+- Tool launches from Workspace Manager V2 when selected game context enables it.
+- Asset entries remain owned by the Asset Manager V2 manifest/toolState contract.

docs/tools/palette-manager-v2/uat.md

@@ -0,0 +1,13 @@
+# Palette Manager V2 - UAT
+
+Validate that Palette Manager V2 is the active V2 surface for editing validated palette swatches.
+
+## Scope
+- Tool: `palette-manager-v2`
+- Entry point: `tools/palette-manager-v2/index.html`
+- Purpose: edit user palette swatches, browse source palettes, manage tags, and publish validated palette data for V2 workspace and game manifest flows.
+
+## Expected
+- Tool launches from the tools index.
+- Tool launches from Workspace Manager V2 when selected game context enables it.
+- Palette swatches remain owned by the Palette Manager V2 manifest/toolState contract.