diff --git a/opencode/decisions.yaml b/opencode/decisions.yaml
index dfa21666..b1a6dd11 100644
--- a/opencode/decisions.yaml
+++ b/opencode/decisions.yaml
@@ -679,3 +679,18 @@ notes:
       - homekit_controller
     pin: true
     status: active
+  - id: 2026-08-29-tplink-kasa-entries-are-discovery-based
+    date: 2026-08-29
+    title: tplink/Kasa entries are discovery-based; IP changes handled automatically
+    decision: "tplink/Kasa entries are discovery-based (not IP-bound): if a plug's IP changes,
+      HA re-discovers it automatically; no re-pairing needed and fixed IPs are not
+      required. Do not re-pair or pin IPs in response to an IP change."
+    rationale: User asked whether IP changes would break the tplink integration. The config
+      entry (01M182SQ9M0SJDN9DTXTCG2QZA) is source 'user' with no IP pinned; HA 2024.1+
+      python-kasa discovery rebroadcasts handle IP changes. Brief 'unavailable' window is
+      normal and self-healing; a DHCP reservation is optional.
+    entities:
+      - switch.filter
+    integrations:
+      - tplink
+    status: active