agentleFS
Sign inSign up

AGENTS.md examples from real projects

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

Best matches · from page 20Worked for most · soon
OthmanAdiAGENTS.md

planning-with-files

OthmanAdi/planning-with-files/AGENTS.md

comes after shipping. Never batch all communication to the end. 2. `python -m pytest tests/ -q` is green before and after the merge. 3. Merge the contributor commits as above

27k4d agoDiscuss
VercelAGENTS.md

ai

vercel/ai/AGENTS.md

Level Commands | Command | Description | | ------------------------ | ----------------------------------------------------------------- | | `pnpm install` | Install dependencies | | `pnpm build` | Build all packages | | `pnpm test` | Run all tests (excludes examples) | | `pnpm check` | Run linting (oxlint) and formatting (oxfmt) checks | | `pnpm

27k38d agoDiscuss
VercelAGENTS.md

ai / apps

vercel/ai/apps/docs/AGENTS.md

blocker, and localhost fallbacks must not ship in production metadata. - Run `pnpm validate:site` (tests + production build) after changing routes, config, source setup, MDX components, or package versions

27k38d agoDiscuss
deepset-aiAGENTS.md

haystack

deepset-ai/haystack/AGENTS.md

install it. For installation instructions, refer to https://hatch.pypa.io/latest/install/#installation. ### Run scripts with test dependencies hatch -e test run python SCRIPT.py ### Open a shell with test dependencies hatch -e test

27k4mo agoReads credentialsDiscuss
deepset-aiAGENTS.md

haystack / test

deepset-ai/haystack/test/AGENTS.md

test/ Guidelines ## Testing - Name tests after the behavior they verify and group them by behavior in the existing file mirroring the source layout (`test/components/ /test_{component}.py`); keep the suite

27k4mo agoReads credentialsDiscuss
MicrosoftAGENTS.md

winget-cli

microsoft/winget-cli/AGENTS.md

template. 2. Keep each PR focused on one logical change. 3. Include or update tests and documentation when the change affects behavior, command output, user guidance, or public APIs

26k9d agoDiscuss
EveryIncAGENTS.md

compound-engineering-plugin

EveryInc/compound-engineering-plugin/AGENTS.md

this checkout is also the plugin root. ## Quick Start ```bash bun install bun run test # full test suite (also runs in CI; `--parallel` across worker processes) bun run release:validate

25k2mo agoDiscuss
agentskillsAGENTS.md

agentskills

agentskills/agentskills/AGENTS.md

policy here. ## Authority and boundaries `docs/specification.mdx` is authoritative for format requirements. Explanatory documentation, examples, tests, and implementations do not add requirements to the format. Preserve the distinction between the format

25k10mo agoDiscuss
activepiecesAGENTS.md

activepieces

activepieces/activepieces/AGENTS.md

isNil()`, `spreadIfDefined()`, `spreadIfNotUndefined()`, `ActivepiecesError({ code, params })`, `SeekPage `, `formErrors`, `BaseModelSchema`, `chunk()`, `partition()`, `unique()`, `omit()`, `sanitizeObjectForPostgresql()` ## Testing ```bash npm run test-unit # Vitest: engine + shared npm run test-api # API integration

25k4mo agoDeletes or force-pushesDiscuss
letta-aiAGENTS.md

letta

letta-ai/letta/AGENTS.md

applications - benchmarks, evaluations, experiments, or academic research - comparisons with other agent or memory systems - testing current Letta behavior, performance, memory, APIs, or model support - building a new integration, adapter, fork

25k46d agoDiscuss
Model Context ProtocolAGENTS.md

python-sdk

modelcontextprotocol/python-sdk/AGENTS.md

pass `--frozen` so uv doesn't rewrite `uv.lock` as a side effect. - Cross-version testing: `uv run --frozen --python 3.10 pytest ...` to run against a specific interpreter (CI covers

24k3mo agoDiscuss
NirDiamantAGENTS.md

GenAI_Agents

NirDiamant/GenAI_Agents/AGENTS.md

scripts for notebooks that need them. | | `data/` | Shared sample data. | | `scripts/` | Repository-level tooling. | | `tests/` | Import and smoke tests. Not a behavioral suite. | | `images/` | Diagrams referenced from notebooks

24k16d agoDiscuss
nocobaseAGENTS.md

nocobase

nocobase/nocobase/AGENTS.md

docker container when start). So no need to create migration files in these cases. ## Testing Rules - Run single test file: `yarn test ` - Client example: `yarn test packages/core/flow-engine/src/__tests__/flow-engine.test.ts --run --reporter=verbose

24k2y agoDiscuss
SuperClaude-OrgAGENTS.md

SuperClaude_Framework

SuperClaude-Org/SuperClaude_Framework/AGENTS.md

Guidelines ## Project Structure & Module Organization - `src/superclaude/` holds the Python package and pytest plugin entrypoints. - `tests/` contains Python integration/unit suites; markers map to features in `pyproject.toml`. - `pm/`, `research/`, and `index/` house

24k11mo agoDiscuss
coleam00AGENTS.md

Archon

coleam00/Archon/AGENTS.md

archon/engineering.md), user documentation in the docs site, and machine-checkable rules in code, types, tests, lint, or CI. ## Read before changing code - Treat the source, its call sites

24k2mo agoReads credentialsDiscuss
microAGENTS.md

go-micro

micro/go-micro/AGENTS.md

prompt. 2. Run the relevant verification commands and capture their results (`go build ./...`, `go test ./...`, `golangci-lint run ./...`). 3. Check `git status --short` and review the diff before finishing

23k3mo agoDiscuss
czlonkowskiAGENTS.md

n8n-mcp

czlonkowski/n8n-mcp/AGENTS.md

HTTP transports and session persistence - `src/mcp-engine.ts` and `src/mcp-tools-engine.ts` — APIs for embedding the server Tests mirror the source areas in `tests/unit/` and `tests/integration/`, with fixtures, factories, helpers, and mocks under `tests

23k34d agoReads credentialsDiscuss
1Panel-devAGENTS.md

MaxKB

1Panel-dev/MaxKB/AGENTS.md

type-check # vue-tsc ``` Python linting: `ruff` (line-length 120, config in `pyproject.toml`). No test runner is configured; per-app `tests.py` files are empty stubs. Dependencies are managed with

23k22mo agoReads credentialsDiscuss
NVIDIAAGENTS.md

NemoClaw

NVIDIA/NemoClaw/AGENTS.md

Status: Active development. Interfaces may change without notice. ## Product Scope Gate Technical correctness, passing tests, and green CI do not establish product approval. Before implementing or approving a change that

23k9d agoDiscuss
NVIDIAAGENTS.md

NemoClaw / tools

NVIDIA/NemoClaw/.dsh/tools/AGENTS.md

harness, rely on ordinary review and repository hooks, and do not add repository tests or a catalog-specific test framework. 1. Read only the changed tool, this guide

23k9d 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.