| name | cloudflare-worker |
| description | Diagnose a Cloudflare Worker-backed server workspace: classify runtime, binding, env, local dev, and client-linkage drift; check D1/R2 and base URL alignment; and separate local diagnosis from remote-state or shared-boundary work. Do not use for deploy-only repair or generic UI work. |
| compatibility | Intended for create-rn-miniapp repositories using the Cloudflare server provider. Assumes the generated frontend/backoffice/server topology and the repo-owned server/README.md workflow. |
| metadata | {"create-rn-miniapp.agentsLabel":"Cloudflare Worker 작업","create-rn-miniapp.category":"optional","create-rn-miniapp.order":"5"} |
Cloudflare Worker Skill
Cloudflare Worker provider를 진단할 때 쓰는 decision skill이다.
목표는 runtime/binding/env/client-linkage 문제를 먼저 분류하고, remote deploy나 tRPC boundary와 섞이지 않게 자르는 것이다.
Use when
- Worker runtime layout, binding, request surface를 점검할 때
- D1/R2/env/client base URL drift를 분류할 때
- local dev smoke path와 deployed Worker 문제를 분리할 때
Do not use for
- contract, AppRouter, client import order 변경:
trpc-boundary
- MiniApp route/page/navigation:
granite-routing
- remote deploy, binding repair,
workers.dev repair 같은 원격 mutate 실행
Read in order
server/.create-rn-miniapp/state.json
server/README.md
references/server-common.md
references/provider-overlay.md
- workspace ownership이 헷갈리면
docs/engineering/workspace-topology.md
Default checks
- shared guide 기준으로 runtime/layout, env/linkage, boundary, remote state 중 어디인지 먼저 적는다.
state.json의 trpc를 보고 client linkage 기대 파일을 고른다.
server/.env.local, frontend/.env.local, backoffice/.env.local이 같은 Worker를 가리키는지 본다.
- binding 문제가 의심되면
wrangler.jsonc, wrangler.vitest.jsonc, worker-configuration.d.ts를 같이 본다.
Failure signatures
- D1/R2 binding 오류가 타입, test, runtime 중 한쪽에서만 보인다.
- client가 wrong host, HTML, 404를 받고 Worker local dev는 멀쩡하다.
- frontend와 backoffice가 서로 다른 base URL을 쓴다.
- tRPC import/type 오류가 request layer 문제처럼 보인다.
Smoke tests
node ./scripts/check-env.mjs
node ./scripts/check-client-links.mjs
server dev
server typecheck
server build
server test
Handoff boundary
- contract/app-router/client import order면
trpc-boundary
- remote deploy, binding repair,
workers.dev 재활성화는 server/README.md Remote Ops
Report evidence
state.json 요약
- client base URL 비교 결과
- binding 관련 파일에서 확인한 차이
- local dev, build, deployed Worker 중 어디에서만 재현되는지