diff --git a/README.md b/README.md
index 563f43f..1a9a8b9 100644
--- a/README.md
+++ b/README.md
@@ -274,10 +274,15 @@ hal/
 
 ## Develop & deploy
 
-```bash
-# Deploy the MCP server (the actual product) — see docs/operations.md §2 for the full runbook
-make deploy                              # supabase functions deploy hal-mcp --no-verify-jwt + verify_deploy.sh
+Canonical entry points (root `Makefile`):
+
+- `make deploy` — deploy hal-mcp + verify it answers
+- `make verify` — probe the live hal-mcp function (no redeploy)
+- `make test` — offline checks — deno type-check (both fns) + offline pytest (mirrors CI)
 
+Full runbook: [`CLAUDE.md`](./CLAUDE.md) § Migrations & deploy, [`docs/operations.md`](./docs/operations.md).
+
+```bash
 # Apply a halcrm_* migration — use the Supabase MCP apply_migration tool or the
 # dashboard SQL editor. The Supabase CLI push is NOT safe on this shared
 # partial-ledger DB; see docs/operations.md §1 for the runbook.