How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.
CloudflareAGENTS.mdcloudflare/telescope/packages/waterfall/AGENTS.md
Guidance for AI coding agents working in this package. @cloudflare/waterfall is a standalone, framework-free web component that renders an HTTP Archive (HAR) waterfall chart. It lives at /waterfall/ in the…
CloudflareAGENTS.mdcloudflare/claude-managed-agents/AGENTS.md
STOP. Your knowledge of Cloudflare Workers APIs and limits may be outdated. Always retrieve current documentation before any Workers, KV, R2, D1, Durable Objects, Queues, Vectorize, AI, or Agents SDK task. For all limits and quotas, retrieve from the product's /platform/limits/ page. eg. /workers/platform/limits Run wrangler types after changing bindings in wrangler.jsonc. https://developers.cloudflare.com/workers/runtime-apis/nodejs/ Retrieve API references and limits from: /kv/ · /r2/ · /d1/ · /durable-objects/ · /workers-ai/ · /agents/ · /sandbox/ · /containers/
CloudflareAGENTS.mdcloudflare/containers/AGENTS.md
Guidelines for AI agents working on the @cloudflare/containers package. This is the @cloudflare/containers npm package — a TypeScript library that wraps Cloudflare's container-enabled Durable Objects. It provides lifecycle management, HTTP/WebSocket proxying, outbound interception, scheduling, and load balancing utilities on top of the Cloudflare Workers runtime. Key exports (src/index.ts): Add a new file to the .changeset directory representing a new version when wrapping up changes so they get released. Do NOT change CHANGELOG.md, that is codegenerated on a release MR that…
CloudflareAGENTS.mdcloudflare/cloudflare-prometheus-exporter/AGENTS.md
Generated: 2026-01-05 Change: p Cloudflare Prometheus exporter: Worker + Durable Objects fetching CF metrics via GraphQL/REST, exposing Prometheus format. Stack: Hono, gql.tada, Zod, urql. TypeScript (strict mode enforced): - noUncheckedIndexedAccess: true - index access returns T | undefined - verbatimModuleSyntax: true - explicit type imports required - Zod for runtime validation at boundaries Formatting (Biome): - Tabs, double quotes - Auto-organize imports DO Patterns: - State loaded in blockConcurrencyWhile constructor - Alarms for refresh scheduling (jitter applied) - Static get()…
CloudflareAGENTS.mdcloudflare/realtime-examples/AGENTS.md
These instructions apply to the entire repository. - Complete application blueprints live alongside examples as top-level directories. catalog.yaml and the local blueprint.yaml identify them. - Preserve existing example paths unless…
CloudflareAGENTS.mdcloudflare/realtime-examples/cloud-gaming/AGENTS.md
These instructions apply to cloud-gaming/. Keep this a complete but small Realtime SFU application: one Freedoom Container, multiple viewers, and one controlling browser tab. Do not turn it into a…
CloudflareAGENTS.mdcloudflare/realtime-examples/esp32-radio/AGENTS.md
Start with README.md. The main integration reference is firmware/docs/sfu.md; ESP32, the playlist, and HTTPS-to-Worker are the working implementation's choices. Run Makefile commands from esp32-radio/. Read the references for the component…
CloudflareAGENTS.mdcloudflare/realtime-examples/esp32-radio/firmware/AGENTS.md
This is a Rust application on ESP-IDF for the validated ESP32-S3 N32R16V. Read README.md and docs/ffi.md before changing hardware ownership or transport. Check ../ERRATA.md for known integration issues. Keep portable…
CloudflareAGENTS.mdcloudflare/realtime-examples/esp32-radio/worker/AGENTS.md
This directory owns the React frontend and Cloudflare backend. Use Tailwind v4 utilities for layout, typography, controls, and responsive behavior. Keep custom CSS focused on theme tokens and drawing effects.…
CloudflareAGENTS.mdcloudflare/realtime-examples/video-room/AGENTS.md
Keep this a complete but small Realtime SFU room: multiple browser participants, one Durable Object per room, and explicit authentication, authorization, reconnect, and cleanup. Do not turn it into a…
CloudflareAGENTS.mdcloudflare/workers-py/AGENTS.md
Subdirectory AGENTS.md files provide package-specific context (key classes, where-to-look tables, local conventions and anti-patterns). This repository (workers-py) contains three Python packages that are used for Cloudflare Python Workers. There is…
CloudflareAGENTS.mdcloudflare/workers-py/packages/cli/AGENTS.md
workers-py (or pywrangler) is a command-line interface for managing Python Workers. It provides commands for: - Installing packages (pywrangler sync) - Running workers locally (pywrangler dev) - Uploading workers to…
CloudflareAGENTS.mdcloudflare/workers-py/packages/django-cf/AGENTS.md
django-cf is a Python package that lets a Django application run on Cloudflare Workers and use Cloudflare products as Django backends. It is published to PyPI as django-cf and imported…
CloudflareAGENTS.mdcloudflare/workers-py/packages/runtime-sdk/AGENTS.md
workers-runtime-sdk is a Python package that provides utilities for running Python code in a Cloudflare Worker environment. This package provides utilities for:
CloudflareAGENTS.mdcloudflare/workers-py/packages/testlib/AGENTS.md
testlib holds shared helpers for tests that run pytest inside workerd. It is not published; runtime-sdk and django-cf vendor it into their test workers via ../packages/testlib in [tool.uv.sources]. - A…
CloudflareAGENTS.mdcloudflare/vibesdk-templates/AGENTS.md
No summary in the file. Open it to read it.
CloudflareAGENTS.mdcloudflare/flagship/AGENTS.md
Cloudflare Flagship SDKs — OpenFeature-compatible SDKs for Cloudflare's Flagship feature flag platform. This is a pnpm monorepo with SDKs organized by implementation language under sdks/<language>/. The TypeScript SDK is the…
CloudflareAGENTS.mdcloudflare/realtimekit-web-examples/angular-examples/AGENTS.md
3 Angular example apps demonstrating Cloudflare RealtimeKit. Deployed as a single Cloudflare Worker, same sub-path pattern as react-examples.
CloudflareAGENTS.mdcloudflare/realtimekit-web-examples/html-examples/AGENTS.md
5 vanilla HTML/JS/CSS example apps for Cloudflare RealtimeKit. No framework. Deployed as a single Cloudflare Worker.
CloudflareAGENTS.mdcloudflare/realtimekit-web-examples/react-examples/AGENTS.md
17 self-contained React+Vite+Tailwind example apps demonstrating Cloudflare RealtimeKit. All deployed together as a single Cloudflare Worker, each served at /<example-name>/.
An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.
At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.
Setup and test commands, code style, and the rules a new contributor would need to know.
Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.
