diff --git a/opencode/decisions.yaml b/opencode/decisions.yaml
index 2b6ba51e..e307c4cb 100644
--- a/opencode/decisions.yaml
+++ b/opencode/decisions.yaml
@@ -980,3 +980,20 @@ notes:
       - sensor.sparkx_i7_used_material_length
     pin: true
     status: active
+  - id: 2026-10-11-new-rfid-filaments-need-the-spoolman
+    date: 2026-10-11
+    title: New RFID filaments need the Spoolman filament Weight field set
+    decision: RFID spool app creates new Spoolman filaments with a blank Weight. For each NEW
+      material, set Filaments > Weight in Spoolman (e.g. 1000 g). A blank filament Weight
+      freezes that spool's main sensor; the spool's own weight is not enough.
+    rationale: "v1.4.0 bug: Spool._handle_coordinator_update() early-returns before
+      async_write_ha_state() when filament['weight'] is None, so the main spool sensor
+      never pushes state and used_percentage is absent; sub-sensors still update so only
+      the tile looks stale. Fix is data (set the filament Weight), which survives HACS
+      updates and needs no restart; a local code patch does not persist because HACS
+      replaces the file on update."
+    entities:
+      - sensor.spoolman_spool_7
+    integrations:
+      - spoolman
+    status: active