README

Author: wtetsu

README.md

@@ -74,6 +74,31 @@ Plenty of 'update-and-run' tools exist, but if you're coding, Gaze is the ideal
   - See also: [Parallel handling](/doc/parallel.md)
   - <img src="doc/img/p04.png" width="300">
 
+## 🤖 Perfect with AI Agents!
+
+Gaze works amazingly well with AI coding agents like Claude Code! Here's how this powerful combination works:
+
+```mermaid
+graph LR
+    A[🤖 AI Agent] -->|edits| B[📁 Files]
+    B -->|watches| C[👁️ Gaze<br/>⚡ runs commands]
+    C -->|outputs| D[📊 Results<br/>Tests • Lint • Output]
+    D -->|reads| A
+```
+
+1. **AI Agent edits your code** - Claude Code modifies your source files, configs, or data
+2. **Gaze reacts instantly** - Automatically runs tests, builds, linters, or data processing
+3. **Continuous feedback loop** - See results immediately without manual intervention
+
+
+### Common AI + Gaze Patterns:
+- 🧪 **Test-driven development**: Auto-run tests as AI writes code
+- 📊 **Data pipeline**: Regenerate charts/reports when AI updates data
+- 🔨 **Build automation**: Rebuild projects as AI modifies source
+- 🚀 **Live development**: Restart servers when AI edits configs
+
+This combo is a game-changer for AI-assisted development! 🚀
+
 
 # How to use