agentleFS

AGENTS.md examples from real projects

How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.

Worked for most · soon
CloudflareAGENTS.md

agents / capabilities

cloudflare/agents/packages/agents/src/tests/capabilities/AGENTS.md

Harness Durable Objects for testing Lifecycle capabilities — the lower-level sibling of ../agents/ (which holds Agent-level fixture classes). One file per capability, all registered in the shared workers project (../worker.ts + ../wrangler.jsonc), all driving real Durable Objects. - harness.ts — the generic tier's bare CapabilityHarnessObject. Its driver, withCapabilityHarness() (in ../shared/capability-harness.ts), binds per-test-constructed capabilities to a real Lifecycle over real SQLite storage — a new capability gets isolation tests with zero new wiring. - lifecycle.ts — fixtures for the Lifecycle core…

Steady3 mentions in 2 weeks

No other project uses it yet

6k12d agoReviewMountCreate a free account to mount
CloudflareReads credentialsAGENTS.md

vibesdk

cloudflare/vibesdk/AGENTS.md

No summary in the file. Open it to read it.

5.4k4mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflare-docs

cloudflare/cloudflare-docs/AGENTS.md

This file helps AI agents understand the structure, tooling, and conventions of the cloudflare-docs repository so they can make correct, buildable changes. This is the source for developers.cloudflare.com. It is…

5.4k2mo agoReviewMountCreate a free account to mount
CloudflareReads credentialsAGENTS.md

cloudflare-docs

cloudflare/cloudflare-docs/.flue/AGENTS.md

.flue/ is the Cloudflare Worker that reviews pull requests for cloudflare/cloudflare-docs. It uses Flue 2.1.0, Cloudflare Workflows, R2, Workers AI, and Hono. app.ts verifies GitHub webhooks and delegates to the…

5.4k2mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workers-sdk

cloudflare/workers-sdk/AGENTS.md

This file helps AI coding agents work effectively in the Cloudflare Workers SDK monorepo. Prefer authoritative configuration and documentation over copying details into this file: copied versions, rule lists, and counts become stale. - Use pnpm, not npm or yarn. - Use the Node.js and pnpm versions declared in package.json. - Install dependencies with pnpm install. - Run commands from the workspace root unless package documentation says otherwise. - Before changing a package, read its AGENTS.md if it has one.…

4.7k6mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workers-sdk / create-cloudflare

cloudflare/workers-sdk/packages/create-cloudflare/AGENTS.md

Project scaffolding CLI for Cloudflare Workers. Main source entry: src/cli.ts. Bin entry: bin/c3.js (Node.js version gate shim).

4.7k6mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workers-sdk / miniflare

cloudflare/workers-sdk/packages/miniflare/AGENTS.md

Local dev simulator for Cloudflare Workers, powered by workerd runtime. Main class Miniflare in src/index.ts.

4.7k6mo agoReviewMountCreate a free account to mount
CloudflareReads credentialsAGENTS.md

workers-sdk / vite-plugin-cloudflare

cloudflare/workers-sdk/packages/vite-plugin-cloudflare/AGENTS.md

Vite plugin for Cloudflare Workers development. Exports cloudflare() plugin factory from src/index.ts. ESM-only output. bin/cf-vite is an experimental, internal delegate binary spawned by Cloudflare's "cf-dev" parent process — NOT part of the plugin's public API and not meant for direct end-user invocation. It is the sibling of wrangler's cf-wrangler binary, and the two MUST keep a shared spawn contract so the parent can drive either impl interchangeably. - Verb dispatch. cf-vite <verb> [flags]. dev and build are the verbs today;…

4.7k6mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workers-sdk / vitest-plugin

cloudflare/workers-sdk/packages/vitest-plugin/AGENTS.md

Custom Vitest pool for running Worker tests inside the actual workerd runtime. Do NOT repeat root AGENTS.md content (pnpm, changesets, code style, etc.). - Runs in Node.js, part of the pool bundle (no separate package export) - Validates pool options (WorkersPoolOptionsSchema) and resolves the project's Worker configuration into Miniflare options - src/pool/plugin.ts provides the cloudflareTest() Vite plugin, which injects cloudflare:test resolution and sets resolve conditions (workerd, worker, browser) parseCustomPoolOptions() in src/pool/config.ts resolves at most one configuration file: - wrangler: {…

4.7k6mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workers-sdk / workers-auth

cloudflare/workers-sdk/packages/workers-auth/AGENTS.md

OAuth-2.0-with-PKCE flow against Cloudflare's dash.cloudflare.com (or staging / custom-overridden) endpoints. Used by wrangler and (in future) other Cloudflare CLIs. Internal-only — published as prerelease: true.

4.7k6mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workers-sdk / workers-utils

cloudflare/workers-sdk/packages/workers-utils/AGENTS.md

Shared utility package used across wrangler, miniflare, and others. Two main areas: config validation and test helpers.

4.7k6mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

workers-sdk / wrangler

cloudflare/workers-sdk/packages/wrangler/AGENTS.md

Wrangler-specific context only. See root AGENTS.md for monorepo conventions. Main CLI for Cloudflare Workers. ~2k-line yargs command tree in src/index.ts. Entry point is src/cli.ts (NOT src/index.ts). - No console.* — use logger singleton - No __dirname / __filename — use getBasePath() - No global fetch — use undici's fetch - Route Cloudflare v4 API calls through the existing cfetch helpers such as fetchResult, fetchListResult, and fetchPagedListResult when possible; do not use global or undici fetch directly. Prefer these helpers over…

4.7k6mo agoReviewMountCreate a free account to mount
CloudflareReads credentialsAGENTS.md

kumo

cloudflare/kumo/AGENTS.md

Generated: 2026-03-18 | Commit: 38518e34 | Branch: rozenmd/fix-preview Cloudflare's React component library (@cloudflare/kumo). pnpm monorepo: component library (Base UI + Tailwind v4), Astro docs site, Figma plugin, screenshot worker. ESM-only, Node 24+. - Kumo floating components portal to document.body. Consumers should create an app-root stacking context with isolation: isolate (Tailwind: className="isolate"). - Do not fix a popup that appears below consumer content by adding z-index to Kumo popup components, targeting Base UI internal data attributes, or applying isolation to <body>.

Steady20 mentions in 2 weeks

No other project uses it yet

4.2k4mo agoReviewMountCreate a free account to mount
CloudflareReads credentialsAGENTS.md

kumo / ci

cloudflare/kumo/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

Steady20 mentions in 2 weeks

No other project uses it yet

4.2k4mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

kumo / kumo

cloudflare/kumo/packages/kumo/AGENTS.md

React component library: Base UI + Tailwind v4 + Vite library mode. ESM-only, tree-shakeable per-component exports. Parent: See root AGENTS.md for monorepo context.

Steady20 mentions in 2 weeks

No other project uses it yet

4.2k4mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

kumo / kumo-docs-astro

cloudflare/kumo/packages/kumo-docs-astro/AGENTS.md

Generated: 2026-09-03 | Commit: 9b4eb70 | Branch: rozenmd/test-preview Astro documentation site for @cloudflare/kumo. Static output uses React islands, MDX reference pages, Tailwind v4, and Cloudflare Workers static assets. Parent: See root AGENTS.md for monorepo-wide rules. vp run build:docs builds @cloudflare/kumo first. Production Astro builds use the package output, while development aliases Kumo imports to source for HMR. - Use ~/* for package-local imports; it maps to src/*. - Standard component pages use MdxDocLayout, then present the primary demo, installation, usage,…

Steady20 mentions in 2 weeks

No other project uses it yet

4.2k4mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

kumo / demos

cloudflare/kumo/packages/kumo-docs-astro/src/components/demos/AGENTS.md

Executable Kumo examples used by documentation pages, the homepage showcase, visual regression, and component registry generation. - Registry files must use {Component}Demo.tsx names. - Registry exports must end in Demo. Both exported function declarations and exported arrow functions are supported. - Add JSDoc to exported function declarations when registry consumers need a description. The extractor does not collect arrow-function JSDoc. - Keep returned JSX self-contained and suitable for copying. The extractor reads the top-level return expression, not arbitrary runtime behavior.…

Steady20 mentions in 2 weeks

No other project uses it yet

4.2k4mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

kumo / kumo-figma

cloudflare/kumo/packages/kumo-figma/AGENTS.md

Generates production-quality Figma components from component-registry.json. Destructive sync: purges and recreates all components per run. Parent: See root AGENTS.md for monorepo context.

Steady20 mentions in 2 weeks

No other project uses it yet

4.2k4mo agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

kumo / generators

cloudflare/kumo/packages/kumo-figma/src/generators/AGENTS.md

37 component generators creating Figma components from component-registry.json. Registry is source of truth. Parent: See packages/kumo-figma/AGENTS.md for plugin context. Every generator follows this structure: ALL magic numbers and constants MUST live here: Key utilities:

Steady20 mentions in 2 weeks

1 project uses a version of this

4.2k4mo agoReviewMountCreate a free account to mount
CloudflareReads credentialsAGENTS.md

kumo / kumo-screenshot-worker

cloudflare/kumo/packages/kumo-screenshot-worker/AGENTS.md

Cloudflare Worker that uses Puppeteer + Browser Rendering to capture screenshots of Kumo docs pages. Used for visual regression testing. Parent: See root AGENTS.md for monorepo context. Never commit secret values. .dev.vars is gitignored at the root level. All requests require X-API-Key: <API_KEY> header. Returns { results: ScreenshotResult[] } where each result has a base64-encoded image or an error string. Limits: max 50 pages per batch, max 64 KB per css action payload. When captureSections: true, the worker looks for…

Steady20 mentions in 2 weeks

No other project uses it yet

4.2k4mo agoReviewMountCreate a free account to mount
CLAUDE.md vs AGENTS.md

About AGENTS.md

What is AGENTS.md?

An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.

Where does it go?

At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.

What should it contain?

Setup and test commands, code style, and the rules a new contributor would need to know.

Does Claude Code read it?

Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.