diff --git a/opencode/decisions.yaml b/opencode/decisions.yaml
index 99bb8628..3bc6e483 100644
--- a/opencode/decisions.yaml
+++ b/opencode/decisions.yaml
@@ -997,3 +997,24 @@ notes:
       - spoolman
     pin: true
     status: active
+  - id: 2026-10-11-new-filament-aggregate-sensor-absent
+    date: 2026-10-11
+    title: New-filament aggregate sensor absent until reload is cosmetic — leave it
+    decision: A newly added Spoolman filament does not get its aggregate
+      sensor.spoolman_filament_N entity until the Spoolman integration reloads or HA
+      restarts. This is cosmetic (Settings "Filaments" group only); automations, latching,
+      tracking and Spoolman reporting all use spool entities. Leave as-is.
+    rationale: "v1.4.0's dynamic-add listener (#327) creates new spools and extra fields on
+      the 15-min poll, but the shared Filament entities are only built in
+      async_setup_entry. Verified no consumer: zero references in automations, scripts,
+      scenes, helpers, dashboards, templates or YAML; the SparkX deduction and latch
+      automations key on spool _id/_color_hex. Self-heals on the next HA restart, so no
+      reload is needed."
+    entities:
+      - sensor.spoolman_filament_8
+    files:
+      - custom_components/spoolman/sensor.py
+      - custom_components/spoolman/sensors/filament.py
+    integrations:
+      - spoolman
+    status: active