firtoz

firtoz/cf-multiworker-starter-kit

Cursor rule Codex

Necessary for cloud agents.

firtoz/cf-multiworker-starter-kit

Cursor rule Codex

Necessary for cloud agents.

firtoz/cf-multiworker-starter-kit

Cursor rule Codex

Do not start dev servers or long-running watch processes unless the user explicitly asks (e.g. “run dev”, “verify in the browser”). If they do, use the project’s bun run dev from the repo root and stop or ask before leaving a server running forever.

firtoz/cf-multiworker-starter-kit

Cursor rule Codex

Agents must not manually author generated files. If generated output needs to change, edit the source-of-truth file and run the generator. If the generator fails, fix the source or generator instead of fabricating output.

firtoz/cf-multiworker-starter-kit

Cursor rule Codex

Necessary for cloud agents.

firtoz/cf-multiworker-starter-kit

Cursor rule Codex

Cloud Agents MUST run git add, git commit, and git push before ending their response when they have made code changes. Do not end your turn without pushing. ALWAYS use Pull Requests instead of pushing directly to main.

firtoz/cf-multiworker-starter-kit

Cursor rule Codex

Checklist when adding any new env secret/variable — Turbo globalEnv, GitHub sync, workflow maps, Alchemy bindings. Prevents "secret synced but worker never gets it".

firtoz/cf-multiworker-starter-kit

Cursor rule Codex

When the user has not yet personalized a copy of this monorepo, help them before building features.

firtoz/cf-multiworker-starter-kit

Cursor rule Codex

Socka-first Durable Object WebSockets, SSR-safe client URLs, no fake localhost. Use for durable-objects/, apps/web, WebSocket forwarding, or @firtoz/socka.

firtoz/cf-multiworker-starter-kit

Cursor rule Codex

Golden rule: import each symbol from the module that defines it. A package index.ts may barrel only its own ./ modules — never another package.

firtoz/cf-multiworker-starter-kit

Cursor rule Codex

Skim this on every task that touches workers, env, routes, or bindings.

firtoz/cf-multiworker-starter-kit

Skill Claude CodeCodex

Auth worker setup for Better Auth, OAuth, admin bootstrap, and env/secrets. Use when configuring auth for a fork, setting redirect URIs, or debugging auth env.

firtoz/cf-multiworker-starter-kit

Skill Claude CodeCodex

Typed HTTP clients for Cloudflare service bindings — bindingHonoClient, WorkerBindingRegistry, Worker RPC with clientApp, HonoClientApp. Use when calling env.CHATROOM or any WorkerRef/BoundWorker over fetch with @firtoz/hono-fetcher, adding a worker Hono app RPC type, or fixing JsonResponse / missing .delete on…

firtoz/cf-multiworker-starter-kit

Skill Claude CodeCodex

../workers-env-local/SKILL.md.

firtoz/cf-multiworker-starter-kit

Skill Claude CodeCodex

Component organization patterns for React applications. Use when creating components, organizing files, or structuring routes. ALWAYS keep 1 component per file and routes simple.

firtoz/cf-multiworker-starter-kit

Skill Claude CodeCodex

Guide for creating new Agent Skills when patterns emerge or improvements are needed. Use when encountering repeated patterns, making the same mistakes, discovering better approaches, or receiving user corrections. Covers keeping each skill small (one topic), when to split SKILL.md or add references/, and line-count…

firtoz/cf-multiworker-starter-kit

Skill Claude CodeCodex

Add or change a Durable Object worker package under durable-objects/ (Alchemy, env.d.ts, Hono on the DO). Use when scaffolding with turbo gen durable-object, editing durable-objects//alchemy.run.ts, workers/app.ts, or env.d.ts for a DO. Not for web app bindings or cross-worker rpc—see web-alchemy-bindings and…

firtoz/cf-multiworker-starter-kit

Skill Claude CodeCodex

Form submission patterns using useDynamicSubmitter, await submitJson, and formAction. Use when implementing forms, handling form submissions, or processing form data in React Router routes.

firtoz/cf-multiworker-starter-kit

Skill Claude CodeCodex

Fork and template gotchas (env import, routes, typegen, forms, D1, Turbo, HMR, new DO packages). Use when working on apps/web or durable-objects, or when behavior diverges from this stack’s conventions.

firtoz/cf-multiworker-starter-kit

Skill Claude CodeCodex

Repo-root commands, typegen and typecheck cadence, lint, deploy, adding packages with bun, and Alchemy app layout. Use at the start of a task, before PR, or when choosing turbo/typegen commands.

firtoz/cf-multiworker-starter-kit

Skill Claude CodeCodex

Personalizes a fork of this Cloudflare multi-worker monorepo—Alchemy application ids (await alchemy literals + --app), npm workspace names (--filter), README, and UI—so Cloudflare dashboards and Turbo filters are not confusing. Use when the user created a repo from the template, wants to deploy their own app, or asks…

firtoz/cf-multiworker-starter-kit

Skill Claude CodeCodex

React patterns for callbacks, event handlers, JSX handler typing, and module-level constants. Use when writing React components, implementing event handlers, typing JSX handlers, or defining constants.

firtoz/cf-multiworker-starter-kit

Skill Claude CodeCodex

React Router v8 routing patterns and environment variable configuration. Use whenever you touch React Router–related code (routes, links, params, loaders, actions, route config, middleware, or env in route context).

firtoz/cf-multiworker-starter-kit

Skill Claude CodeCodex

Socka + Durable Object WebSockets—defineSocka, SockaWebSocketDO, useSockaSession, SSR-safe ws URLs, web worker forwarding, live-draft vs commit, canvas/whiteboard acceptance, and pre-merge checks. Use for realtime features, /api/ws, or @firtoz/socka.