How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.
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/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/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,…
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.
