Clarify judge entry point and document demo suite

Author: Quinton Stackfield

README.md

@@ -11,6 +11,12 @@
 This is not a guardrail.  
 This is an execution boundary.
 
+**Judges: start here**
+
+Run the baseline demo to verify enforcement immediately:
+
+    python3 -m demo.run_demo
+
 ---
 
 ## The problem

demo/README.md

@@ -0,0 +1,19 @@
+## Demo entry points (judge guide)
+
+Start here:
+
+1. `python3 -m demo.run_demo`
+   - Runs the canonical enforcement demo
+   - Produces allow/deny artifacts
+   - Emits Opik trace at execution.commit
+
+Optional deep dives:
+
+2. `run_prompt_injection.py`
+   - Shows why prompt-only controls fail
+
+3. `experiment_compare.py`
+   - Compares agent-only vs execution-gated behavior
+
+4. `run_authority_drift.py`
+   - Shows time-bound authority expiration