docs(adr-125): Apple HomePod user guide + README badge

- Add docs/user-guide-apple-homepod.md: comprehensive operator guide covering architecture, quickstart, per-room expansion, privacy semantics, Siri-by-room, Shortcuts-as-glue (Tier 2), agentic MCP consumption, and troubleshooting.
- Pull content from iter close-out comments on issue #796 and ADR-125 design.
- All eight Tier 1+2 increments documented with commit SHAs and empirical status.
- Update README.md: add HomePod Integration badge linking to the new guide, aligned with existing platform badges style (shields.io format, Apple logo, black background).

Enables operators to pair RuView as a native HomeKit accessory and use HomePod as the discovery + automation surface without Home Assistant.

.claude-flow/metrics/performance.json

@@ -0,0 +1,17 @@
+{
+  "timestamp": "2026-05-25T05:59:05.405Z",
+  "mode": "local",
+  "memoryUsage": {
+    "rss": 9891840,
+    "heapTotal": 35598336,
+    "heapUsed": 26516560,
+    "external": 3952418,
+    "arrayBuffers": 55689
+  },
+  "uptime": 27163.5846658,
+  "optimizations": {
+    "cacheHitRate": 0.78,
+    "avgResponseTime": 45
+  },
+  "note": "Install Claude Code CLI for AI-powered optimization suggestions"
+}