diff --git a/.github/workflows/deploy-web.yml b/.github/workflows/deploy-web.yml
index 6b5282d..8fdebab 100644
--- a/.github/workflows/deploy-web.yml
+++ b/.github/workflows/deploy-web.yml
@@ -35,7 +35,7 @@ jobs:
           cache-dependency-path: web/pnpm-lock.yaml
       - run: pnpm install --frozen-lockfile
       - name: Deploy
-        run: pnpm deploy
+        run: pnpm run deploy
         env:
           CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
           CLOUDFLARE_ACCOUNT_ID: ${{ vars.CLOUDFLARE_ACCOUNT_ID }}
diff --git a/web/AGENTS.md b/web/AGENTS.md
index bb5e9ac..d03c10e 100644
--- a/web/AGENTS.md
+++ b/web/AGENTS.md
@@ -28,7 +28,7 @@ pnpm build      # production build
 pnpm preview    # preview build locally
 pnpm test       # run tests
 pnpm cf-typegen # regenerate wrangler/cloudflare types
-pnpm deploy     # deploy to Cloudflare Workers
+pnpm run deploy # deploy to Cloudflare Workers
 ```
 
 ## Architecture
diff --git a/web/README.md b/web/README.md
index abfd379..f27cd19 100644
--- a/web/README.md
+++ b/web/README.md
@@ -55,7 +55,7 @@ pnpm build      # production build
 pnpm preview    # preview built app
 pnpm test       # vitest
 pnpm cf-typegen # regenerate Cloudflare types
-pnpm deploy     # build and deploy with wrangler
+pnpm run deploy # build and deploy with wrangler
 ```
 
 ## Data model