diff --git a/ui/SEVERITY_VISUALS.md b/ui/SEVERITY_VISUALS.md
new file mode 100644
index 0000000..7fbc660
--- /dev/null
+++ b/ui/SEVERITY_VISUALS.md
@@ -0,0 +1,18 @@
+Severity visual treatment:
+
+Low:
+- Neutral color
+- No animation
+
+Medium:
+- Accent color
+- Subtle hover animation
+
+High:
+- Strong color contrast
+- Brief entrance animation on appearance
+
+Critical:
+- High-contrast color
+- One-time attention animation on arrival
+- No looping or persistent motion