# Cloudflare Edge Architect

> Advanced architecture skill for Cloudflare. Covers Workers, Durable Objects, R2, D1, and Edge-first data strategies.

- Skill: `diegosouzapw/cloudflare-edge-architect` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/cloudflare-edge-architect`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/cloudflare-edge-architect/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/diegosouzapw/cloudflare-edge-architect

---


# Cloudflare Edge Architect Skill

This skill (formerly `cloudflare-workers-ops`) focuses on building scalable, stateful, and performant architectures on the Cloudflare global network.

## Core Pillars

1.  **Stateful Coordination (Durable Objects)**: Use Durable Objects for real-time multiplayer coordination, game engines state synchronization, and WebSockets.
2.  **Edge Data (D1 & KV)**: Strategy for distributing relational data (D1) and low-latency configuration (KV).
3.  **Object Storage (R2)**: Serve game assets and large binaries efficiently without egress fees.
4.  **Compute-at-Edge (Workers)**: Offload API logic and game logic to the edge to minimize latency.
5.  **AI-at-Edge (Workers AI)**: Integrate on-device inference for features like move suggestions or content moderation.

## Architecture Patterns

### Real-time Multiplayer with Durable Objects

```typescript
// Durable Object implementation for Game Session
export class GameSession {
  state: DurableObjectState;
  constructor(state: DurableObjectState) {
    this.state = state;
  }
  async fetch(request: Request) {
    // Handle game state updates and WebSocket connections
  }
}
```

## Best Practices Checklist

- [ ] **Cross-Origin Isolation**: Set `Cross-Origin-Opener-Policy: same-origin` and `Cross-Origin-Embedder-Policy: require-corp` to enable `SharedArrayBuffer` for Wasm threads.
- [ ] **Smart Placement**: Enable Cloudflare Smart Placement to minimize latency between Workers and backends.
- [ ] **Bundling**: Use `esbuild` or `wrangler`'s built-in bundling to optimize script size.
- [ ] **Environment Secrets**: Securely manage keys for external APIs using `wrangler secret`.

## Advanced Commands

- `pnpm wrangler d1 migrations create <db_name> <description>`
- `pnpm wrangler r2 bucket create <bucket_name>`
- `pnpm wrangler dev --remote`: Test with real Cloudflare resources.

## Troubleshooting

- **"Durable Object not found"**: Ensure the namespace is correctly defined in `wrangler.toml`.
- **"Exceeded CPU limits"**: Optimize tight loops or offload heavy processing to asynchronous tasks.