How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.
MicrosoftAGENTS.mdmicrosoft/agent-framework/dotnet/samples/AGENTS.md
Samples Structure & Design Choices — .NET > This file documents the structure and conventions of the .NET samples so that > agents (AI or human) can maintain them without rediscovering decisions. ## Directory layout
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/AGENTS.md
AGENTS.md Instructions for AI coding agents working in the Python codebase. **Key Documentation:** - [DEV_SETUP.md](DEV_SETUP.md) - Development environment setup and available poe tasks - [CODING_STANDARD.md](CODING_STANDARD.md) - Coding standards, docstring format, and performance
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/ag-ui/AGENTS.md
Multimodal user inputs support both legacy (`text`, `binary`) and draft-style (`image`, `audio`, `video`, `document`) shapes. - Interrupted runs complete with `RUN_FINISHED.outcome.type == "interrupt"` and canonical `outcome.interrupts`; do not document
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/azure-ai-search/AGENTS.md
Retrieval-Augmented Generation) and vector storage. ## Main Classes - **`AzureAISearchContextProvider`** - Context provider that retrieves relevant documents from Azure AI Search - **`AzureAISearchSettings`** - TypedDict settings for Azure AI Search configuration - **`AzureAISearchCollection`** - Experimental async
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/azure-contentunderstanding/AGENTS.md
into the Agent Framework as a context provider. It automatically analyzes file attachments (documents, images, audio, video) and injects structured results into the LLM context. ## Public API | Symbol | Type | Description
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/monty/AGENTS.md
format` — keyword-only `Literal["compact", "json"] | Mapping[str, Literal["compact", "json"]] = "compact"`. Selects parameter documentation in both the description and instructions. Compact includes scalar types, required/optional status, descriptions, enums
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/packages/redis/AGENTS.md
credentials. - **`RedisCollection` / `RedisStore`** - Experimental generic vector storage and search over native HASH and JSON documents. `_vector_store.py` contains settings, connection/codec/schema/filter helpers, the collection, and the store, separate from the preexisting history/context
MicrosoftAGENTS.mdmicrosoft/agent-framework/python/samples/AGENTS.md
Samples Structure & Design Choices — Python > This file documents the structure and conventions of the Python samples so that > agents (AI or human) can maintain them without rediscovering decisions. ## Directory layout
Hugging FaceAGENTS.mdhuggingface/speech-to-speech/AGENTS.md
asked to rewrite history. - Keep release pull requests focused on version metadata and release documentation. - Do not commit local build artifacts such as `dist/`, `build/`, or generated wheel/sdist files. ## Publishing
AWSAGENTS.mdaws/aws-cdk/AGENTS.md
from '../../core'; import * as cxapi from '../../cx-api'; if (FeatureFlags.of(this).isEnabled(cxapi.MY_NEW_FLAG)) { ... } ``` ## Documentation ### JSDoc - Document all public APIs (classes, methods, properties, interfaces) when first introduced - Summary line, blank
CloudflareAGENTS.mdcloudflare/quiche/AGENTS.md
foo.rs`). - **Debug symbols in release** (`profile.release.debug = true`). - **`#![warn(missing_docs)]`** -- public items must be documented. ## ANTI-PATTERNS (THIS PROJECT) - **Do not use `any` types or type assertions** -- this is Rust
ElasticAGENTS.mdelastic/beats/AGENTS.md
github.com/gofrs/uuid/v5` - Write unit tests for new functionality. Use table-driven tests when appropriate - Document exported functions and types - Keep comments concise, focused on "why" not "what" - Update documentation when
VercelAGENTS.mdvercel-labs/portless/AGENTS.md
avoid dashes entirely. The only exception is CLI flags (e.g. `--port`). ## Boolean Environment Variables Document boolean env vars using only `0` and `1` in CLI help, SKILL.md, docs pages
corsairdevAGENTS.mdcorsairdev/corsair/AGENTS.md
docs.corsair.dev/llm-gateway. ## Product note The hosted product moved from `corsairdev/hosted` to `corsairdev/hub`. `hosted` receives documentation updates only
Untrivial-aiAGENTS.mdUntrivial-ai/agent-orchestrator/AGENTS.md
this repository. Keep changes small, match the current rewrite architecture, and prefer the documented daemon/API boundaries over behavior from the old TypeScript implementation. ## Repo layout - `backend/` — Go rewrite of Agent
NVIDIAAGENTS.mdNVIDIA/cosmos/cookbooks/cosmos3/nim/AGENTS.md
instructions help customers deploy, call, and troubleshoot the Cosmos3 Certified NIM from this public documentation directory. For guided customer workflows, load `.agents/skills/cosmos3-nim-user/SKILL.md`. ## Default behavior - Start by asking whether the customer
BeehiveInnovationsAGENTS.mdBeehiveInnovations/pal-mcp-server/AGENTS.md
driven scenarios and log utilities are in `simulator_tests/` with the `communication_simulator_test.py` harness. Authoritative documentation and samples live in `docs/`, and runtime diagnostics are rotated in `logs/`. ## Build, Test
MemTensorAGENTS.mdMemTensor/MemOS/AGENTS.md
LoRA parametric) plus scheduling, version management, and vector & graph storage. - **Repository**: https://github.com/MemTensor/MemOS - **Documentation**: https://memos-docs.openmem.net/home/overview/ - **PyPI**: https://pypi.org/project/MemoryOS/ - **License**: Apache-2.0 - **Top-level package**: `src/memos/`. Distribution
cocoindex-ioAGENTS.mdcocoindex-io/cocoindex/AGENTS.md
Chunk), schema.py │ │ └── ops/ # Operations: text.py (RecursiveSplitter), sentence_transformers.py │ └── tests/ # Python tests │ ├── examples/ # Example applications ├── docs/ # Documentation └── dev/ # Development utilities ``` ## Key Concepts ### Mental model: declarative data pipelines CocoIndex uses a **declarative** programming
OpenAIAGENTS.mdopenai/openai-node/AGENTS.md
maintained model, endpoint, capability, or schema lists unless the contract requires them. Prefer the documented API/schema and server-side validation over brittle client-side guesses. ## Preserve SDK contracts and compatibility
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.
