PR_26172_OWNER_034-canonical-repository-structure

docs_build/dev/ProjectInstructions/README.txt

@@ -40,3 +40,6 @@ READ THIS FIRST
 9. Follow OWNER governance decisions.
 10. When guidance conflicts, newest OWNER-approved guidance wins.
 11. Batch Governance Mode is the default for governance, documentation, and administrative work.
+
+Addendum index:
+- Canonical Repository Structure: project-instructions/addendums/canonical-repository-structure.md

project-instructions/addendums/canonical-repository-structure.md

@@ -0,0 +1,39 @@
+# Canonical Repository Structure
+
+## Purpose
+
+Establish the canonical repository structure for future development and reduce technical debt.
+
+## Canonical Structure
+
+Tools:
+- toolbox/{tool-name}/index.html
+
+Tool assets:
+- assets/toolbox/{tool-name}/js/index.js
+- assets/toolbox/{tool-name}/css/index.css
+
+Themes:
+- assets/theme-v1/
+- assets/theme-v2/
+
+Shared JavaScript:
+- assets/js/shared/
+
+Engine:
+- src/engine/{feature-name}/
+
+API:
+- api/{feature-name}/
+
+Serverside:
+- serverside/{feature-name}/
+
+## Rules
+
+- Theme first.
+- Tool CSS second.
+- Shared functionality belongs in assets/js/shared/.
+- No new scattered JS folders.
+- No new scattered CSS folders.
+- New development follows the canonical structure.