How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.
CloudflareAGENTS.mdcloudflare/realtimekit-web-examples/demo-app/AGENTS.md
Gallery portal deployed at examples.realtime.cloudflare.com. Lists, filters, and launches all SDK examples. Not an SDK example — creates meeting rooms via RealtimeKit REST API and embeds examples in iframes.
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>/.
CloudflareAGENTS.mdcloudflare/realtimekit-web-examples/recording-sdk-app-examples/AGENTS.md
4 React + 4 Angular apps for @cloudflare/realtimekit-recording-sdk — a headless recorder/bot client that runs inside a browser automation context (e.g., Puppeteer, Playwright). Deploys to Cloudflare Workers (Vite/ng build +…
CloudflareAGENTS.mdcloudflare/realtimekit-ui/AGENTS.md
Generated: 2026-02-25 Commit: 2557985 Branch: sm/agents-md Stencil.js Web Components UI kit for Cloudflare RealtimeKit (RTK), published as @cloudflare/realtimekit-ui. Framework wrappers for React and Angular are auto-generated by Stencil output targets on every build; the Vue wrapper is deprecated and unsupported.
CloudflareAGENTS.mdcloudflare/realtimekit-ui/packages/core/AGENTS.md
Main source package for @cloudflare/realtimekit-ui. All authored Web Component source lives here; React + Angular wrappers are generated from this package on every build. Vue output target is disabled (commented out) — packages/vue-library/lib/components.ts is frozen. Three built-in themes: darkest (default), dark, light — defined in src/theme/presets/themes.ts. DesignTokens controls: spacingBase, fontFamily, googleFont, borderWidth (none|thin|fat), borderRadius (sharp|rounded|extra-rounded|circular), colors, logo, theme, tokenPrefix. All CSS variables use --rtk- prefix
CloudflareAGENTS.mdcloudflare/realtimekit-ui/packages/core/src/components/AGENTS.md
One directory per component, named rtk-<name>/. Each contains rtk-<name>.tsx (class + JSX), rtk-<name>.css (scoped Shadow DOM styles), optional *.spec.tsx tests, and a usage/ subdirectory with framework example markdown.
CloudflareAGENTS.mdcloudflare/realtimekit-ui/packages/core/src/lib/AGENTS.md
Non-component logic consumed by multiple components. All modules have an index.ts entry point. Used only by rtk-participants-audio — instantiated per meeting, tracks added/removed as participants join/leave. Pure functions — no side effects, no store access. Safe to call in render(). defaultConfig is a singleton constant — never mutate directly. Always call createDefaultConfig() which returns a deep clone. The UIConfig.root tree defines which child web components each parent renders, including state-conditional variants using CSS-selector-style keys:
CloudflareAGENTS.mdcloudflare/realtimekit-ui/packages/core/src/utils/AGENTS.md
~29 standalone utility files and the sync-with-store/ subdirectory that owns the entire reactive state system. Built on @stencil/store's createStore. Two modes: RtkUiStore shape: Mutation mechanism: A use({ set }) hook intercepts every property set and pushes the new value directly to all subscribed DOM elements: appendElement(propName, el, store) / removeElement(propName, el, store) — register/unregister a DOM element for a given prop. Called by @SyncWithStore() decorator automatically. Wraps connectedCallback / disconnectedCallback of any Stencil component property: Store discovery events: | Event…
CloudflareAGENTS.mdcloudflare/mpp-proxy/AGENTS.md
Context for AI coding agents helping users set up this MPP payment-gated proxy template. A Cloudflare Worker that adds payment gating to any origin using the Machine Payments Protocol (MPP). With Bot Management Filtering: Requires Bot Management for Enterprise to enable bot filtering. When enabled, humans can pass through free while likely automated traffic must pay. This is optional and enhances the base functionality. This template is currently wired to the Tempo payment method via mppx. When a user asks…
CloudflareAGENTS.mdcloudflare/azul/AGENTS.md
Azul is a Rust workspace implementing tiled transparency logs for deployment on Cloudflare Workers. Tech Stack: Rust (edition 2021), Cloudflare Workers (WASM via worker-build), Cargo workspace resolver v2 ✅ Always…
CloudflareAGENTS.mdcloudflare/privacypass-ts/AGENTS.md
Privacy Pass TypeScript implementation. Compliant with: Reference implementations to cross-check behavior when debugging protocol issues. See README.md for full usage. All wire types implement serialize(): Uint8Array and static deserialize(bytes: Uint8Array):…
CloudflareAGENTS.mdcloudflare/dynamic-workflows/AGENTS.md
dynamic-workflows is the glue between Cloudflare Workflows and Cloudflare Dynamic Workers. It lets a single dispatcher-owned workflow route run() calls to the correct tenant's dynamic worker, based on metadata the dispatcher attaches at create() time. Only these are re-exported from index.ts: Everything else in binding.ts / types.ts (wrapParams, unwrapParams, DispatcherEnvelope, WorkflowEventLike, WorkflowStepLike) is internal — kept purely so the library can type its own signatures without depending on a specific @cloudflare/workers-types version. Envelope encoding: wrapWorkflowBinding never merges metadata into the…
CloudflareAGENTS.mdcloudflare/tf-migrate/agents.md
This document provides accurate, code-verified context about the tf-migrate project for AI agents starting with empty context. All patterns, function names, and interfaces are taken directly from the source code. tf-migrate is a CLI tool for automatically migrating Terraform configurations between different versions of the Cloudflare Terraform Provider. State migration is handled by the provider's built-in UpgradeState/MoveState mechanisms — tf-migrate only transforms config (.tf files). Config file transformation follows a four-handler chain of responsibility: Built by BuildConfigPipeline(log, provider) in internal/pipeline/pipeline.go.
CloudflareAGENTS.mdcloudflare/ai-search-snippet/AGENTS.md
This document provides guidelines for AI coding agents working in this repository. ai-search-snippet is a pnpm monorepo containing a zero-dependency TypeScript Web Component library for search and chat interfaces with streaming support, along with a Cloudflare Workers demo site and framework integration demos.
CloudflareAGENTS.mdcloudflare/polystella/AGENTS.md
PolyStella — an Astro integration that translates content into additional locales at build time using AI, caches translations in Cloudflare R2, and injects locale-prefixed routes. This file is the entry point for coding agents working on the PolyStella package itself. Four companion docs: - PACKAGE_ARCHITECTURE.md — post-migration package ownership, dependency direction, key files, and boundary checks. - ARCHITECTURE.md — system design, invariants, glossary, per-subsystem reference. The "why" answers. - skills/polystella-contributor/SKILL.md — step-by-step recipes for common contributor tasks (add an adapter,…
CloudflareAGENTS.mdcloudflare/workers-nodejs-compat-matrix/AGENTS.md
This document provides guidelines for AI coding agents working in this repository. This project audits Node.js API compatibility across different runtimes (Node.js, Bun, Deno, Cloudflare Workers/workerd). It generates JSON dumps of runtime APIs and displays compatibility in a React-based report at https://workers-nodejs-compat-matrix.pages.dev Node built-ins first (with node: protocol), then third-party, then local:
CloudflareAGENTS.mdcloudflare/realtimekit-ui-addons/AGENTS.md
Generated: 2026-02-25 Commit: e18be41 Branch: staging TypeScript library of 11 independent UI addon plugins for @cloudflare/realtimekit-ui. Each addon follows a class-based plugin contract: static async init() factory → register(config, meeting,…
CloudflareAGENTS.mdcloudflare/kumo-astro/AGENTS.md
Updated: 2026-05-19 Cloudflare's component library system. pnpm monorepo: React component library (Base UI + Tailwind v4), Astro component library (same design system, no React), blocks showcase site, Astro docs site, Figma plugin, screenshot worker. ESM-only, Node 24+. Two npm packages are published: @cloudflare/kumo (React) and @cloudflare/kumo-astro (Astro, framework-agnostic).
CloudflareAGENTS.mdcloudflare/kumo-astro/ci/AGENTS.md
TypeScript scripts + shell scripts for validation, reporting, versioning, and deployment. 6 GitHub Actions workflows in .github/workflows/. Parent: See root AGENTS.md for monorepo context. Jobs communicate via filesystem: each writes JSON to ci/reports/{id}.json, final job reads all. getGitRefs() ad
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.
