diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md
new file mode 100644
index 0000000..52a72db
--- /dev/null
+++ b/docs/TROUBLESHOOTING.md
@@ -0,0 +1,3 @@
+# 🛠️ Troubleshooting Guide
+
+Handling external DDC/CI displays, HDR brightness clamping, and Windows Smart App Control.