From 514f50128a7044adff851e4b66092778e72e6a94 Mon Sep 17 00:00:00 2001
From: mblanke <mblanke@gmail.com>
Date: Wed, 24 Dec 2025 12:54:00 -0500
Subject: [PATCH] Define visual and animation policy

---
 ui/INVARIANTS.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 ui/INVARIANTS.md

diff --git a/ui/INVARIANTS.md b/ui/INVARIANTS.md
new file mode 100644
index 0000000..bedb9db
--- /dev/null
+++ b/ui/INVARIANTS.md
@@ -0,0 +1,31 @@
+Visual intent:
+- Modern
+- Confident
+- Technical
+- High-signal
+
+Animation principles:
+- Animation communicates state or priority
+- Animation is purposeful, not decorative
+- Motion is fast and subtle
+
+Allowed animation:
+- Severity change (escalation/de-escalation)
+- New finding arrival
+- Hover affordances
+- Panel expand/collapse
+- Workflow transitions
+
+Restricted animation:
+- No looping animations
+- No animation that blocks interaction
+- No animation longer than 300ms
+- No animation on critical-path actions
+
+Graphics:
+- Data-driven visuals encouraged
+- Motion may reinforce severity or confidence
+- Visual emphasis must align with severity
+
+Rule:
+Flash is allowed when it clarifies meaning.