PR_26172_OWNER_035-test-structure-standardization

docs_build/dev/ProjectInstructions/README.txt

@@ -43,3 +43,4 @@ READ THIS FIRST
 
 Addendum index:
 - Canonical Repository Structure: project-instructions/addendums/canonical-repository-structure.md
+- Test Structure Standardization: project-instructions/addendums/test-structure-standardization.md

project-instructions/addendums/test-structure-standardization.md

@@ -0,0 +1,33 @@
+# Test Structure Standardization
+
+## Purpose
+
+Standardize testing locations and ensure independent tool validation.
+
+## Canonical Test Structure
+
+Tool tests:
+- tests/toolbox/{tool-name}/
+
+Engine tests:
+- tests/engine/{feature-name}/
+
+API tests:
+- tests/api/{feature-name}/
+
+Server tests:
+- tests/server/{feature-name}/
+
+Shared JavaScript tests:
+- tests/js/shared/
+
+Regression tests:
+- tests/regression/
+
+## Rules
+
+- Every tool must be independently testable.
+- Regression tests do not replace tool tests.
+- Tool tests validate tool functionality.
+- Regression tests validate platform behavior.
+- New tests follow the canonical structure.