diff --git a/docs/INDEX.md b/docs/INDEX.md
index 3c008c1..fb3e918 100644
--- a/docs/INDEX.md
+++ b/docs/INDEX.md
@@ -723,12 +723,15 @@ bitbylaw/
 
 | Issue | Solution |
 |-------|----------|
-| Step not registered | Check `_step.py` suffix, restart iii engine |
-| Import errors | Check logs: `grep -i importerror iii.log` |
+| Step not registered | Check `_step.py` suffix, restart: `sudo systemctl restart motia.service` |
+| Import errors | Check logs: `journalctl -u motia.service \| grep -i importerror` |
+| Code changes not applied | Auto-reload should work, force restart: `sudo systemctl restart motia.service` |
+| ApiResponse validation | Use `status=200` not `status_code=200` |
 | Redis unavailable | Service works with warnings, check `REDIS_HOST` |
-| `'_log' not found` | Inherit from `BaseSyncUtils` or implement `_log()` |
-| Webhook not triggering | Verify endpoint in iii Console, check EspoCRM config |
-| xAI upload fails | Verify `XAI_API_KEY` and `XAI_MANAGEMENT_KEY` |
+| `'_log' not found` | Inherit from `BaseSyncUtils` or implement `_log()` method |
+| Webhook not triggering | Verify endpoint: `curl http://localhost:3111/_console/functions` |
+| xAI upload fails | Set `XAI_API_KEY` and `XAI_MANAGEMENT_KEY` in `/etc/systemd/system/motia.service` |
+| View logs | `journalctl -u motia.service -f` (follow) or `--since "10 minutes ago"` |
 
 ---