docs: update README to reference regenerated demo GIFs and screenshots

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: acailic

README.md

@@ -24,7 +24,7 @@
 ---
 
 <p align="center">
-  <img src="./peek-v4-demo.gif" alt="Peaky Peek demo walkthrough" width="720" />
+  <img src="./peek-v5-demo.gif" alt="Peaky Peek demo walkthrough" width="720" />
 </p>
 
 ## Why Peaky Peek?
@@ -151,15 +151,15 @@ import agent_debugger_sdk.auto_patch  # activates on import when PEAKY_PEEK_AUTO
 ### Decision Tree Visualization
 
 <p>
-  <img src="./docs/screenshots/gif-decision-tree.gif" alt="Decision Tree visualization demo" width="720" />
+  <img src="./docs/assets/gifs/demo-decision-tree.gif" alt="Decision Tree visualization demo" width="720" />
 </p>
 
 Navigate agent reasoning as an interactive tree. Click nodes to inspect events, zoom to explore complex flows, and trace the causal chain from policy to tool call to safety check.
 
 ### Checkpoint Replay
 
 <p>
-  <img src="./docs/screenshots/gif-checkpoint-replay.gif" alt="Checkpoint replay demo" width="720" />
+  <img src="./docs/assets/gifs/demo-timeline.gif" alt="Checkpoint replay demo" width="720" />
 </p>
 
 Time-travel through agent execution with checkpoint-aware playback. Play, pause, step, and seek to any point in the trace. Checkpoints are ranked by restore value so you jump to the most useful state.
@@ -171,10 +171,10 @@ Find specific events across all sessions. Search by keyword, filter by event typ
 ### Failure Clustering & Multi-Agent Coordination
 
 <p>
-  <img src="./docs/screenshots/gif-failure-clustering.gif" alt="Failure clustering demo" width="720" />
+  <img src="./docs/assets/gifs/demo-search.gif" alt="Trace search demo" width="720" />
 </p>
 <p>
-  <img src="./docs/screenshots/gif-multi-agent-coordination.gif" alt="Multi-agent coordination demo" width="720" />
+  <img src="./docs/assets/gifs/demo-analytics.gif" alt="Analytics demo" width="720" />
 </p>
 
 Adaptive analysis groups similar failures. Inspect planner/critic debates, speaker topology, and prompt policy parameters across multi-agent systems.