diff --git a/docs/onboarding/production.md b/docs/onboarding/production.md
index 7523bbb..8f24d26 100644
--- a/docs/onboarding/production.md
+++ b/docs/onboarding/production.md
@@ -156,6 +156,8 @@ Upgrade procedure:
 
 ## Troubleshooting
 
+For comprehensive troubleshooting of common issues, see the [Troubleshooting Guide](../troubleshooting.md) and [Diagnostic Playbook](../troubleshooting/diagnostics.md).
+
 ### Orchestrator pods stuck in CrashLoopBack
 
 Check task store connectivity:
diff --git a/examples/README.md b/examples/README.md
index 6bd2800..e77c5b6 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -122,6 +122,8 @@ docker compose -f examples/docker-compose-dev.yml logs -f meili-0
 
 ## Troubleshooting
 
+For comprehensive troubleshooting of common issues, see the [Troubleshooting Guide](../docs/troubleshooting.md) and [Diagnostic Playbook](../docs/troubleshooting/diagnostics.md).
+
 ### Containers not starting
 
 ```bash