One search for your own team's files and the public ecosystem. See how real projects write their agent instructions, and bring the good ideas home.
CloudflareSkillcloudflare/sandbox-sdk/.agents/skills/testing/SKILL.md
Use when writing or running tests for this project. Covers unit vs E2E test decisions, test file locations, mock patterns, and project-specific testing conventions. (project)
CloudflareAGENTS.mdcloudflare/sandbox-sdk/bridge/AGENTS.md
This directory contains a deployable Cloudflare Worker that uses @cloudflare/sandbox/bridge to expose the sandbox HTTP API. It is a thin wrapper — all route handling, authentication, pool management, and OpenAPI…
CloudflareAGENTS.mdcloudflare/sandbox-sdk/bridge/examples/basic/AGENTS.md
This directory contains a single-file uv script (main.py) that demonstrates the OpenAI Agents SDK with a Cloudflare Sandbox backend. - Single file: everything lives in main.py with inline # ///…
CloudflareAGENTS.mdcloudflare/sandbox-sdk/bridge/examples/workspace-chat/AGENTS.md
This directory contains a two-process workspace chat demo: a Python backend and a React frontend. - Framework: Starlette (not FastAPI) served with uvicorn. - Dependencies: managed via uv with pyproject.toml.…
CloudflareAGENTS.mdcloudflare/sandbox-sdk/bridge/harness/AGENTS.md
Agent-driven QA test harness for the cloudflare-sandbox-bridge Cloudflare Worker. Uses the OpenAI Agents SDK (openai-agents[cloudflare]) to exercise sandbox exec, file I/O, process management, and session persistence against a production deployment.
CloudflareAGENTS.mdcloudflare/sandbox-sdk/packages/sandbox-container/src/control-plane/AGENTS.md
This directory is the primary home for container-side control API methods used by the Sandbox Durable Object. Add control operations here. Use service methods directly rather than routing through HTTP…
CloudflareAGENTS.mdcloudflare/sandbox-sdk/packages/sandbox/src/bridge/AGENTS.md
The bridge is the library layer that powers @cloudflare/sandbox/bridge. It provides a bridge() factory that wraps a user's Worker with sandbox API routes, warm pool management, and authentication — all…
CloudflareAGENTS.mdcloudflare/sandbox-sdk/packages/sandbox/src/clients/transport/AGENTS.md
This directory is compatibility-only for the HTTP and custom WebSocket route-based API. Do not add transport-layer capabilities here unless the task explicitly requires HTTP/WebSocket compatibility maintenance. DO-to-container control-channel work belongs…
CloudflareAGENTS.mdcloudflare/sandbox-sdk/packages/sandbox/src/container-control/AGENTS.md
This directory is the primary home for Sandbox Durable Object to container control-channel code. Use role-based names such as ContainerControlClient, ContainerControlConnection, and SandboxControlAPI. Treat capnweb/RPC as an implementation detail unless…
CloudflareAGENTS.mdcloudflare/artifact-fs/AGENTS.md
Repository-specific guidance for artifact-fs.
CloudflareSkillcloudflare/artifact-fs/.agents/skills/artifact-fs/SKILL.md
Mounts Git remotes with ArtifactFS as local working trees without a full clone. Use when asked to mount a remote repo, explain committed state versus dirty overlay state, or mount multiple repos under one daemon.
CloudflareAGENTS.mdcloudflare/nimbus/apps/www/AGENTS.md
Agent-facing context. If you're picking up work on this site, start here. Astro-based docs site. The nimbus-docs package provides the integration, content schemas, navigation/sidebar/TOC computation, MDX→markdown rendering, build hooks, and the nimbus CLI. Everything you see in src/ is user-owned and yours to edit. For Cloudflare deploys, also: wrangler.jsonc at project root. Frontmatter must validate against docsSchema from nimbus-docs/schemas. Required: title. The schema includes optional fields for description, sidebar overrides, drafts, dates, edit-link suppression — read the schema for the…
CloudflareCLAUDE.mdcloudflare/nimbus/CLAUDE.md
Read this first if you're an AI agent picking up work on the Nimbus codebase. Sister file CLAUDE.md mirrors this content — keep them in sync. Nimbus builds documentation sites on Astro. The architecture splits into three tiers: Cloudflare is a first-class deploy target (the scaffolder defaults to it and ships wrangler.jsonc), but the framework is deploy-target agnostic — static output runs anywhere. Root build runs at default concurrency; pnpm -r topo order builds nimbus-docs first. apps/www's build no longer…
CloudflareCLAUDE.mdcloudflare/nimbus/packages/nimbus-starter-source/CLAUDE.md
Read and follow AGENT.md. It is the canonical project guidance for editing, auditing, upgrading, and validating this Nimbus site.
CloudflareAGENTS.mdcloudflare/mcp/AGENTS.md
cloudflare-mcp is a token-efficient Model Context Protocol (MCP) server that exposes the entire Cloudflare API (~2,500 endpoints) using Cloudflare's Code Mode pattern. Instead of registering thousands of MCP tools, it uses just two tools (search and execute) that let agents write JavaScript to query the OpenAPI spec and call APIs — fitting all 2,500 endpoints into ~1,000 tokens. Production URL: mcp.cloudflare.com When modifying MCP or OAuth functionality, always check the latest published MCP specification: Node 22+ required.
CloudflareCLAUDE.mdcloudflare/mcp/CLAUDE.md
No summary in the file. Open it to read it.
CloudflareAGENTS.mdcloudflare/chanfana/AGENTS.md
Chanfana is an OpenAPI 3/3.1 schema generator and request validator for Hono and itty-router on Cloudflare Workers. It uses Zod v4 for schemas and provides auto CRUD endpoints with D1 support. Tests run inside @cloudflare/vitest-pool-workers with a real D1 binding. Config: tests/vitest.config.mts. Formatter/Linter: Biome (biome.json). Key settings: - 2-space indent, 120 char line width, double quotes, always semicolons, trailing commas on multiline - noExplicitAny is OFF — any is used deliberately throughout TypeScript (tsconfig.json): strict: true, verbatimModuleSyntax: true (requires import…
Cloudflarellms.txtcloudflare/chanfana/llms.txt
OpenAPI 3 and 3.1 schema generator and validator for Hono, itty-router, and Cloudflare Workers. Chanfana automatically generates OpenAPI specs from Zod v4 schemas, validates requests, and provides auto CRUD endpoints with built-in D1 database support. This package includes source code and documentation to help AI tools understand the library:
CloudflareSkillcloudflare/chanfana/skills/write-endpoints/SKILL.md
Comprehensive guide for building OpenAPI endpoints with chanfana - schema definition, request validation, CRUD operations, D1 database integration, and exception handling
CloudflareAGENTS.mdcloudflare/chanfana/template/AGENTS.md
A starter Cloudflare Worker using Chanfana (OpenAPI), Hono, D1, and Zod v4. This is a copyable template — users clone it and build on top. Tests use @cloudflare/vitest-pool-workers with a local miniflare D1 binding. Config: vitest.config.mts. Follow the same conventions as the parent chanfana library: - 2-space indent, double quotes, always semicolons - import type for type-only imports (verbatimModuleSyntax: true) - Classes: PascalCase — endpoint classes named after their action (TaskCreate, TaskList) - Named exports everywhere, no default exports (except…
Plain text files in a repository that tell a coding agent how the project works: commands to run, conventions to follow and things to avoid. CLAUDE.md, AGENTS.md, cursor rules and skills are the common kinds.
CLAUDE.md is read by Claude Code. AGENTS.md is an open format that Codex, Cursor and other agents read. Many projects keep one and point the other at it.
A folder with a SKILL.md that describes one capability, such as filling PDFs or reviewing code. The agent loads it only when the task calls for it.
Your agents already can, over MCP, limited to the files you're allowed to read. Searching them from this page is coming.
