AGENTS.md examples from real projects

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

Most stars first · from page 44Worked for most · soon

MicrosoftAGENTS.md

agent-framework / ollama

microsoft/agent-framework/python/packages/ollama/AGENTS.md

Integration with Ollama for local LLM inference.

14k8mo agoDiscuss

MicrosoftAGENTS.md

agent-framework / openai

microsoft/agent-framework/python/packages/openai/AGENTS.md

OpenAI integration package for Agent Framework. Contains OpenAI Responses API and Chat Completions API clients. All clients follow the Raw + Full-Featured pattern (e.g., RawOpenAIChatClient + OpenAIChatClient). For Responses API continuation with service-side storage, a prior hosted functionapprovalrequest is server-issued and must not be replayed inline, while the new hosted functionapprovalresponse is serialized as mcpapprovalresponse so the user's approved or rejected decision reaches the service. Local FunctionTool approval controls are resolved in-process and must not be serialized as MCP items.…

14k8mo agoReads credentialsDiscuss

MicrosoftAGENTS.md

agent-framework / purview

microsoft/agent-framework/python/packages/purview/AGENTS.md

Integration with Microsoft Purview for data governance and policy enforcement.

14k8mo agoDiscuss

MicrosoftAGENTS.md

agent-framework / redis

microsoft/agent-framework/python/packages/redis/AGENTS.md

Redis-based storage for agent threads and context. - RedisHistoryProvider - Persistent chat history provider using scoped Redis keys. Scoped mode requires an application ID and non-empty session ID, and can additionally isolate tenants and agents. Use explicit legacy mode only while deliberately migrating historical keys; scoped mode never accesses them automatically. - RedisContextProvider - Context provider with Redis-backed retrieval - RedisSettings - TypedDict connection settings for vector stores, resolved with core loadsettings from explicit URL overrides, an optional .env file,…

14k8mo agoReads credentialsDiscuss

MicrosoftAGENTS.md

agent-framework / samples

microsoft/agent-framework/python/samples/AGENTS.md

This file documents the structure and conventions of the Python samples so that agents (AI or human) can maintain them without rediscovering decisions. Durable Task and Azure Functions samples are maintained in the Durable Agent Framework extension. 1. Progressive complexity: Sections 01→05 build from "hello world" to production. Within 01-get-started, files are numbered 01–07 and each step adds exactly one concept. 3. Workflows preserved: 03-workflows/ keeps the upstream folder names and file names intact. Do not rename or restructure workflow…

14k8mo agoDiscuss

siteboonAGENTS.md

claudecodeui

siteboon/claudecodeui/AGENTS.md

For every task that creates, modifies, refactors, or reviews backend code under server/, load and follow $backend-module-standards from .agents/skills/backend-module-standards/SKILL.md. Apply it only to backend code; do not impose those architecture…

14k30d agoDiscuss

XiaomiMiMoAGENTS.md

MiMo-Code

XiaomiMiMo/MiMo-Code/AGENTS.md

Development focuses on the TUI (packages/opencode/src/cli/cmd/tui/) and the engine core it runs on. The Web, App and Desktop surfaces are not currently maintained. In practice this means an operation should default to checking the TUI path first. Reduce total variable count by inlining when a value is only used once. Avoid unnecessary destructuring. Use dot notation to preserve context. Prefer const over let. Use ternaries or early returns instead of reassignment. Avoid else statements. Prefer early returns. Use snake_case for…

14k4mo agoDiscuss

Hugging FaceAGENTS.md

speech-to-speech

huggingface/speech-to-speech/AGENTS.md

PyPI publishing is handled by GitHub Actions in .github/workflows/publish.yml. The workflow runs on pushed tags that match v*, builds the package with uv build, checks the artifacts with twine check --strict, and publishes through the configured pypi environment. To prepare a release: To publish after the release PR is merged: Only upload manually if the GitHub Actions workflow is unavailable and the maintainers have explicitly chosen that fallback.

13k52d agoDiscuss

sirmallocAGENTS.md

ccstatusline

sirmalloc/ccstatusline/AGENTS.md

ccstatusline is a customizable status line formatter for Claude Code CLI that displays model info, git branch, token usage, and other metrics. It functions as both: 1. A piped command processor for Claude Code status lines 2. An interactive TUI configuration tool when run without input The project has dual runtime compatibility - works with both Bun and Node.js: Widget Interface: All widgets must implement: - getDefaultColor(): Default color for the widget - getDescription(): Description shown in TUI - getDisplayName():…

13k2mo agoReads credentialsDiscuss

AWSAGENTS.md

aws-cdk

aws/aws-cdk/AGENTS.md

Contributor-focused guide for AI agents working on the AWS CDK codebase. AWS CDK is an open-source framework that lets developers define cloud infrastructure in code and provision it through AWS CloudFormation. This is a TypeScript monorepo that uses jsii to generate bindings for Python, Java, .NET, and Go. Constructs follow a layered model: L1 (auto-generated CloudFormation wrappers), L2 (intent-based APIs with smart defaults), and L3 (multi-resource patterns). See CONTRIBUTING.md for the full contributor guide. You are a CDK contributor. You…

13k20d agoDiscuss

GoogleAGENTS.md

oss-fuzz

google/oss-fuzz/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.