Update setup docs and scripts

Refresh setup docs, add ZXDB local setup script, and note deploy rules.

Signed-off-by: codex@lucy.xalior.com

AGENTS.md

@@ -158,6 +158,11 @@ Comment what the code does, not what the agent has done. The documentation's pur
   - Call out what to inspect visually (e.g., section names, table columns, empty states).
   - Use the local `.env` for any environment-dependent behavior.
   - Provide fully clickable links when sharing validation URLs.
+- submodule hygiene:
+  - The `ZXDB` submodule is read-only in this repo; do not commit SQL dumps from it.
+  - Use `bin/setup-zxdb-local.sh` (or `pnpm setup:zxdb-local`) to add local excludes for SQL files.
+- deploy workflow:
+  - `bin/deploy.sh` refuses to run with uncommitted or untracked files at the repo root.
 
 ### References