diff --git a/docs/WORKFLOW_STANDARDS.md b/docs/WORKFLOW_STANDARDS.md
index 47aab46..cd57904 100644
--- a/docs/WORKFLOW_STANDARDS.md
+++ b/docs/WORKFLOW_STANDARDS.md
@@ -13,7 +13,18 @@ MokoStandards-Template-Generic        →  MokoISOUpdatePortable, etc.
 MokoStandards-Template-Client         →  client-clarksvillefurs, client-kiddieland
 ```
 
-**MokoOnyx** is the living reference implementation for Joomla workflows. Template repos are the canonical source for distribution. The MokoStandards-API repo does NOT store workflow templates — it only has `bulk-repo-sync.yml` for its own CI.
+**MokoOnyx** is the living reference implementation for Joomla workflows. Template repos are the **single source of truth** for workflow content. The MokoStandards-API repo does NOT store workflow templates — its sync engine (`RepositorySynchronizer.php`) clones template repos at runtime to get the latest workflows.
+
+### How Sync Works
+
+```
+bulk-repo-sync.yml (API repo)
+  → RepositorySynchronizer.php detects platform type
+  → Clones the matching template repo to /tmp/
+  → Copies .gitea/workflows/*.yml from template → target repo
+```
+
+No workflow files are stored in the API repo. This prevents drift.
 
 ## Template Repos