AGENTS.md examples from real projects

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

Best matches · from page 17Worked for most · soon

mvanhornAGENTS.md

cli-printing-press

mvanhorn/cli-printing-press/AGENTS.md

this contract (when/how to run the sweep, the `-readme-only` + author-preservation safeties) is documented in `printing-press-library/AGENTS.md` under "Bulk SKILL.md/README.md retrofits". The same lockstep applies

4.8k5mo agoDiscuss

MicrosoftAGENTS.md

WindowsAppSDK

microsoft/WindowsAppSDK/AGENTS.md

pipeline definitions \test # Test projects \tools # Development tools and utilities \specs # Feature specifications \docs # Documentation ``` - **ComponentName**: SDK component (e.g., `AppLifecycle`, `DynamicDependency`, `MRTCore`) - **Language**: Primarily C++ (C++/WinRT) with some

4.7k9mo agoDiscuss

DockerAGENTS.md

docs

docker/docs/AGENTS.md

AGENTS.md Instructions for AI agents working on Docker documentation. This site builds https://docs.docker.com/ using Hugo. ## Project structure ```text content/ # Documentation source (Markdown + Hugo front matter) ├── manuals/ # Product docs (Engine

4.7k5mo agoDiscuss

zebbernAGENTS.md

claude-code-guide / composition-patterns

zebbern/claude-code-guide/skills/composition-patterns/AGENTS.md

React Composition Patterns **Version 1.0.0** Engineering January 2026 > **Note:** > This document is mainly for agents and LLMs to follow when maintaining, > generating, or refactoring React codebases using composition. Humans

4.6k8mo agoDiscuss

zebbernAGENTS.md

claude-code-guide / react-best-practices

zebbern/claude-code-guide/skills/react-best-practices/AGENTS.md

React Best Practices **Version 1.0.0** Vercel Engineering January 2026 > **Note:** > This document is mainly for agents and LLMs to follow when maintaining, > generating, or refactoring React and Next.js codebases. Humans

4.6k8mo agoDiscuss

NateBJones-ProjectsAGENTS.md

OB1

NateBJones-Projects/OB1/AGENTS.md

implementation milestones, blockers, and verification results there. - Do not wait until the end to document decisions. If a decision changes schema, API contract, trust policy, user-facing workflow, or publishing

4.6k7mo agoDiscuss

JetBrainsAGENTS.md

koog

JetBrains/koog/AGENTS.md

Prefer functional programming patterns where appropriate - Use type-safe builders and DSLs for configuration - Document public APIs with KDoc comments - NEVER suppress compiler warnings without a good reason ## Quality Gates

4.6k5mo agoDiscuss

CloudflareAGENTS.md

workers-sdk

cloudflare/workers-sdk/AGENTS.md

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. ## Start

4.6k4mo agoDiscuss

NVIDIAAGENTS.md

nvidia-container-toolkit

NVIDIA/nvidia-container-toolkit/AGENTS.md

agents working in this repository. Human contributors should also read [CONTRIBUTING.md](CONTRIBUTING.md) and the [documentation site](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/index.html) which are the source of truth. ## Project Summary The NVIDIA Container

4.6k22d agoDiscuss

SupabaseAGENTS.md

supabase-js

supabase/supabase-js/AGENTS.md

skills or duplicate docs-site content. The TSDoc-in-source IS the canonical API documentation for the SDK packages. For higher-level Supabase guidance (the documentation site, MCP tools, schema

4.6k6mo agoDiscuss

gptmeAGENTS.md

gptme

gptme/gptme/AGENTS.md

feat:` for new features (not just docs) - `fix:` for bug fixes - `docs:` for documentation only - `refactor:`, `test:`, `chore:` as appropriate - **Stage files explicitly**: Never use `git add .` or `git commit

4.4k4mo agoDiscuss

ElasticAGENTS.md

elasticsearch-py

elastic/elasticsearch-py/AGENTS.md

client code - **elasticsearch/_async/** - Async client code (generated from sync) - **elasticsearch/dsl/** - High-level DSL and document mapping - **elasticsearch/esql/** - ES|QL query builder - **test_elasticsearch/** - Unit and integration tests ## API Code Generation

4.4k35d agoDiscuss

inkeepAGENTS.md

open-knowledge

inkeep/open-knowledge/AGENTS.md

logic - `packages/desktop` - Electron desktop app - `packages/plugin` - agent integration package - `packages/server` - local collaboration server - `docs` - documentation site ## Process safety Never signal a pid you did not spawn. Signal a held `ChildProcess

4.3k3mo agoDiscuss

robinebersAGENTS.md

openusage

robinebers/openusage/AGENTS.md

shows AI provider usage widgets (Claude, Codex, Cursor, Grok, Devin, and more). This file documents the engineering conventions for the project. Read it before contributing. ## Agent Instructions AGENTS.md

4.3k3mo agoDiscuss

arcboxlabsAGENTS.md

arcbox / engine

arcboxlabs/arcbox/engine/AGENTS.md

assets.lock` without rebuilding the daemon changes nothing. The pin semantics and failure signatures stay documented in `app/AGENTS.md` ("Boot-asset pin"). - `arcbox-snapshot` — snapshot lineage: the checkpoint catalog (`snapshot`), the device

4.3k2mo agoDiscuss

arcboxlabsAGENTS.md

arcbox / runtime

arcboxlabs/arcbox/runtime/AGENTS.md

empty & absolute. It does NOT validate namespaces, resources, seccomp, capabilities, or hook paths. Document what you rely on before treating it as a security boundary. ## Conventions & pitfalls - **ID schemes differ

4.3k2mo agoDiscuss

arcboxlabsAGENTS.md

arcbox / xtask

arcboxlabs/arcbox/xtask/AGENTS.md

tokio`/`aya`/`fc-sdk`). - **Adding a rule**: append a `Rule` whose `reason` names the document that owns it (charter decision, design doc, AGENTS.md section) — the reason is what a violation

4.3k2mo agoDiscuss

nolabs-aiAGENTS.md

nono

nolabs-ai/nono/AGENTS.md

production `.unwrap()` or `.expect()`; restrict `unsafe` to justified low-level/FFI boundaries and document each block with `// SAFETY:`. - Use checked, saturating, or overflowing arithmetic where overflow affects a security decision

4.2k24d agoDiscuss

dagucloudAGENTS.md

dagu / ui

dagucloud/dagu/ui/AGENTS.md

Error propagation control - Recovery mechanisms - Notification on errors # UI Design Guidelines for Dagu This document outlines the design principles and guidelines for the Dagu UI based on user feedback

4.2k5mo agoDiscuss

flypythoncomAGENTS.md

python

flypythoncom/python/AGENTS.md

reusable templates, reviewed catalog data, and stable public JSON contracts. ## Content rules - Prefer official documentation and primary sources. - Keep first-party Python engineering and AI-coding guidance specific, testable

4.1k20d agoDiscuss

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.