How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.
MicrosoftAGENTS.mdmicrosoft/typespec/AGENTS.md
Your training data may be outdated — these docs match your installed version. ## Installed Package Documentation - [@alloy-js/core](./packages/http-server-csharp/node_modules/@alloy-js/core/docs/index.md) - [@alloy-js/cli](./packages/http-server-csharp/node_modules/@alloy-js/cli/docs/index.md) — Alloy
generalactionAGENTS.mdgeneralaction/emdash/AGENTS.md
Avoid `any`; if a registry or boundary needs it, keep the escape local and documented. - Use top-level `import` statements; do not use `require()`. - Never re-export as a shortcut
VercelAGENTS.mdvercel-labs/open-agents/.agents/skills/vercel-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
CloudflareAGENTS.mdcloudflare/agents/design/AGENTS.md
Diátaxis **explanation** quadrant: architecture rationale, tradeoffs, and alternatives considered. ## Two kinds of document ### Design docs Living documents that describe how a concept or subsystem works **right now**. Named by topic
CloudflareAGENTS.mdcloudflare/agents/docs/AGENTS.md
AGENTS.md — docs/ User-facing documentation for the Agents SDK monorepo. Each package owns the directory under `docs/` matching its unscoped package name. These markdown files are manually synced to [developers.cloudflare.com
Microsoft AzureAGENTS.mdAzure/azure-sdk-for-python/AGENTS.md
retries, logging, transport) - TypeSpec-based SDK generation from API specifications - Comprehensive testing, validation, and documentation infrastructure **Main Branch**: `main` **Key Documentation**: - [Azure SDK Python Design Guidelines](https://azure.github.io/azure-sdk/python_design.html) - [Contributing
GoogleAGENTS.mdgoogle/clusterfuzz/AGENTS.md
Agent Instructions This document provides instructions for agents on how to perform common development tasks in this repository. ## Initial Setup This project uses `asdf` to manage tool versions. Before
junhoyeoAGENTS.mdjunhoyeo/tokscale/AGENTS.md
Agent Guidelines This document provides context for AI agents working on the Tokscale project. ## Maintaining AGENTS.md Files When updating AGENTS.md files, follow these principles: - **No hardcoded counts** — Don't write
dotnetAGENTS.mddotnet/skills/AGENTS.md
regressions. Before pushing eval changes, run `python eng/eval-quality/check_eval_quality.py`. It blocks eleven structural defect classes documented in `eng/eval-quality/README.md` that can corrupt a real evaluation result. The distilled quality rules — what makes
maziyarpanahiAGENTS.mdmaziyarpanahi/openmed/AGENTS.md
make lint-swift`. Keep `.editorconfig`, Ruff, pre-commit, Swift format scripts, Make targets, documentation, and CI in sync when changing lint policy. A lint policy change should explain the local
VercelAGENTS.mdvercel/eve/AGENTS.md
README](./README.md) for the full overview and [`docs/`](./docs) for user-facing documentation. Always style the framework name as `eve`, lowercase, in user-facing copy, docs, prompts, comments, and headings
VercelAGENTS.mdvercel/eve/apps/templates/personal-agent-template/AGENTS.md
connections) ├── apps/web/ # Nuxt UI, Nitro API, and shared application code └── docs/ # Architecture, environment, customization ``` ## Documentation - [Architecture](docs/ARCHITECTURE.md) — System design, request flows, internal API - [Environment](docs/ENVIRONMENT.md) — Environment variables - [Customization](docs/CUSTOMIZATION.md) — Rename
VercelAGENTS.mdvercel-labs/zerolang/AGENTS.md
implementation. - `examples/`: small runnable programs and packages. - `conformance/`: language and CLI fixtures. - `docs/`: public documentation site. - `scripts/`: validation and release support tooling. ## Public Docs Policy Docs should describe current user
TencentCloudAGENTS.mdTencentCloud/Octop/AGENTS.md
version`. Resource tables (API-visible entities: `agents`, `channels`, `threads`, `cron_jobs`, `knowledge_bases`, `knowledge_documents`, `skill_packages`, `published_experts`, …) use: | Column | Role | |--------|------| | `id` | Integer surrogate PK (`AUTOINCREMENT` / `GENERATED BY DEFAULT
weave-osAGENTS.mdweave-os/router/AGENTS.md
swallow; don't log-and-continue on request path. The one documented exception is a **best-effort, off-request-path fire-and-forget** — always wrapped in [`observability.SafeGo`](internal/observability/safego.go) (bounded timeout
metalbear-coAGENTS.mdmetalbear-co/mirrord/AGENTS.md
path is something someone has to understand, maintain, and keep compatible. ## Comments and Documentation Don't write comments explaining what code does, the code should speak for itself. Instead, focus
ElasticAGENTS.mdelastic/elasticsearch-php/AGENTS.md
available. ## Project Structure - **src/** - PHP source files - **tests/** - Unit and integration tests - **docs/** - Documentation ## Development Workflow 1. Make changes to `src/` files 2. Run `composer run-script phpstan` to check
loopljAGENTS.mdlooplj/axonhub/AGENTS.md
前端 UI 组件使用规则 | | [e2e.md](.agent/rules/e2e.md) | `frontend/tests/**/*.ts` | E2E testing rules | | [docs.md](.agent/rules/docs.md) | `docs/**/*.md` | Documentation rules | | [workflows/add-channel.md](.agent/rules/workflows/add-channel.md) | Manual | Workflow for adding a new channel
magnitudedevAGENTS.mdmagnitudedev/magnitude/AGENTS.md
targeted type checks per package — do not run project-wide `tsc -b` ## Project Documents When significant bug is being reported or a large spec is being created, place under `bugs/YY-MM-DD
magnitudedevAGENTS.mdmagnitudedev/magnitude/cli/AGENTS.md
from the authoritative product resource. - Validate command syntax before acquiring runtime capabilities. Help, version, documentation, and rejected syntax must not start the application or mutate user configuration. - Keep runtime imports
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.
