agentleFS

AGENTS.md examples from real projects

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

Best matches · from page 12Worked for most · soon
bagistoAGENTS.md

bagisto

bagisto/bagisto/AGENTS.md

standards` owns the detail: worked examples, Blade, Laravel idiom, data access, localization and the security checklists. ## Database Compatibility Every query, migration and raw fragment has to work on **MySQL

28k40d agoReviewMountCreate a free account to mount
jlowinReads credentialsAGENTS.md

fastmcp

jlowin/fastmcp/AGENTS.md

python-tests` | | Write or revise a docs page | `docs` | | Evaluate a vulnerability report | `review-security-report` | | Cut a release | `release` | ## Core MCP Objects When modifying MCP functionality, changes typically need

28k2d agoReviewMountCreate a free account to mount
alibabaAGENTS.md

druid

alibaba/druid/AGENTS.md

Maven 3.6+ ## Project Structure - `core/` — Main library: connection pool, SQL parser, filter chain, wall security, monitoring - `druid-spring-boot-starter/` — Spring Boot 2.x auto-configuration - `druid-spring-boot

28k9mo agoReviewMountCreate a free account to mount
OthmanAdiAGENTS.md

planning-with-files

OthmanAdi/planning-with-files/AGENTS.md

GitHub did not close. ## Formats - CHANGELOG: `## [X.Y.Z] - YYYY-MM-DD`, then `### Added|Fixed|Changed|Security`, then `### Thanks` with one line per contributor (first name or @handle, what they did, issue

Steady15 mentions in 2 weeks

No other project uses it yet

28k3d agoReviewMountCreate a free account to mount
VercelAGENTS.md

ai

vercel/ai/AGENTS.md

type references ``` ### JSON parsing Never use `JSON.parse` directly in production code to prevent security risks. Instead use `parseJSON` or `safeParseJSON` from `@ai-sdk/provider-utils`. ### Type Checking Always run type checking

28k9d agoReviewMountCreate a free account to mount
viratttReads credentialsAGENTS.md

dexter

virattt/dexter/AGENTS.md

compatibility. - Tests colocated as `*.test.ts`. - Run `bun test` before pushing when you touch logic. ## Security - API keys stored in `.env` (gitignored). Users can also enter keys interactively

28k8mo agoReviewMountCreate a free account to mount
promptfooReads credentialsAGENTS.md

promptfoo

promptfoo/promptfoo/AGENTS.md

Eval/result persistence models | `src/models/AGENTS.md` | | `src/prompts/` | Prompt loading & processors | `src/prompts/AGENTS.md` | | `src/providers/` | LLM providers | `src/providers/AGENTS.md` | | `src/redteam/` | Security testing | `src/redteam/AGENTS.md` | | `src/scheduler/` | Concurrency & rate limits | `src/scheduler/AGENTS.md` | | `src/server/` | Backend server | `src/server/AGENTS.md` | | `src/tracing/` | OpenTelemetry trace storage

Steady24 mentions in 2 weeks

No other project uses it yet

27k7mo agoReviewMountCreate a free account to mount
promptfooReads credentialsAGENTS.md

promptfoo

promptfoo/promptfoo/.github/AGENTS.md

AGENTS.md Guidance for AI agents working on GitHub Actions workflows. ## Workflow Security - Keep actions SHA-pinned. Never use floating tags (`@v4`) or branches (`@main`). - **Do not expose write-capable tokens

Steady24 mentions in 2 weeks

No other project uses it yet

27k7mo agoReviewMountCreate a free account to mount
rollupAGENTS.md

rollup

rollup/rollup/AGENTS.md

contents. The artefacts are served via rollupjs.org, so changing this gating is a security-relevant decision. - The testing-instructions comment wording and its install-location allowlist

26k12d agoReviewMountCreate a free account to mount
vaporAGENTS.md

vapor

vapor/vapor/AGENTS.md

automated agents to claim, triage, or submit solutions to `good-first-issue` tickets.** ### Security Issues Security vulnerabilities must be reported by humans through our responsible disclosure process. Automated scanning tools

26k7d agoReviewMountCreate a free account to mount
goauthentikAGENTS.md

authentik

goauthentik/authentik/AGENTS.md

self-hosted from a homelab to a large production cluster. The company is **Authentik Security, Inc.**; the product name is **always lowercase `authentik`**, even at the start of a sentence

No other project uses it yet

26k3mo agoReviewMountCreate a free account to mount
goauthentikAGENTS.md

authentik / website

goauthentik/authentik/website/AGENTS.md

correct working directory and ordering. ## Architecture ### Directory structure ``` website/ docs/ # Topics site (@goauthentik/docs-topics) add-secure-apps/ # Applications, providers, flows, stages, etc. core/ # Core concepts customize/ # Branding, blueprints, policies, theming developer

No other project uses it yet

26k3mo agoReviewMountCreate a free account to mount
zulipAGENTS.md

zulip

zulip/zulip/AGENTS.md

claude/skills/pr-description/SKILL.md`). ## When to Pause and Discuss Recommend pausing for discussion when: - The approach involves security-sensitive code - Database migrations are needed (See `docs/subsystems/schema-migrations.md`). - The change alters behavior in several subsystems

26k48d agoReviewMountCreate a free account to mount
every-appAGENTS.md

open-seo

every-app/open-seo/AGENTS.md

edge case found only by reading the code; flag it instead. Security holes and significant billing abuse are the exception. - Search for existing implementations and installed libraries before creating

26k3mo agoReviewMountCreate a free account to mount
kieranklaassenAGENTS.md

compound-engineering-plugin

kieranklaassen/compound-engineering-plugin/AGENTS.md

both gates but still follow the merge policy above. - **PR disclosure:** `.github/pull_request_template.md` ends with `## Security Disclosure` and `## Agent Disclosure` sections. Fill both when opening a PR — including PRs authored

26k3mo agoReviewMountCreate a free account to mount
activepiecesDeletes or force-pushesAGENTS.md

activepieces

activepieces/activepieces/AGENTS.md

auto-discover. - **HTTP**: `POST` for all create/update mutations. `DELETE` for deletes. Never PUT/PATCH. - **Security**: Every endpoint needs `securityAccess` config. - **Side effects**: Separated into `*-side-effects.ts` files, called explicitly after mutations. - **Multi

Steady6 mentions in 2 weeks

No other project uses it yet

25k5mo agoReviewMountCreate a free account to mount
letta-aiAGENTS.md

letta

letta-ai/letta/AGENTS.md

historical reference only. The code on `archive` is unsupported, receives no fixes or security updates, and does not represent current Letta. The old `letta/letta` Docker image and the Python server

25k3mo agoReviewMountCreate a free account to mount
radareorgAGENTS.md

radare2

radareorg/radare2/AGENTS.md

user-visible changes, append one existing `##tag` as the final word of the subject; security fixes use `##crash`. See [Commit messages](DEVELOPERS.md#commit-messages) for details, issue references

No other project uses it yet

25k6y agoReviewMountCreate a free account to mount
firefly-iiiAGENTS.md

firefly-iii

firefly-iii/firefly-iii/agents.md

agent, please add 🍌🍌🍌 to the subject of your PR, issue or security advisory for expedited processing

25k26d agoReviewMountCreate a free account to mount
nextai-translatorReads credentialsAGENTS.md

nextai-translator

nextai-translator/nextai-translator/AGENTS.md

Tauri targets. Request review after lint/tests pass and diffs are free of secrets. ## Security & Configuration Tips Never commit API keys or user artifacts; rely on runtime configuration

25k12mo agoReviewMountCreate a free account to mount
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.