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 3Worked for most · soon
DeepSeekAGENTS.md

deepseek-harness / workspace

deepseek-ai/deepseek-harness/snapshots/session/agent-instructions-budget-chains/workspace/.dsh/AGENTS.md

project. Reply in short, plain sentences and state the result first. Run the narrowest test that covers a change before reporting it as done. Never commit, push, or delete branches

Steady3 mentions in 2 weeks

No other project uses it yet

276k3mo agoReviewMountCreate a free account to mount
DeepSeekAGENTS.md

deepseek-harness / website

deepseek-ai/deepseek-harness/website/AGENTS.md

block because tab switching is unavailable; the [code-group adapter](.vitepress/code-groups.ts) and its [focused tests](tests/code-groups.spec.ts) own this behavior. Long tables with at least ten data rows receive independent text

Steady3 mentions in 2 weeks

No other project uses it yet

276k3mo agoReviewMountCreate a free account to mount
NousResearchAGENTS.md

hermes-agent / agent

NousResearch/hermes-agent/agent/AGENTS.md

CHILD_ENV_MARKER` valued as the fenced Kanban board root, not a bare flag. ## Tests Loop/phase tests go in `tests/agent/`; patch the binding the phase actually reads (siblings often `from

No other project uses it yet

262k43d agoReviewMountCreate a free account to mount
NousResearchAGENTS.md

hermes-agent / plugins

NousResearch/hermes-agent/plugins/AGENTS.md

process warning, documented replacement + migration note, ≥ 2 subsequent minor releases before removal. - Compat tests load **frozen plugins through the real discovery path** and assert outcomes — never exact registry/catalog counts, source

262k43d agoReviewMountCreate a free account to mount
NousResearchAGENTS.md

hermes-agent / pm

NousResearch/hermes-agent/pm/AGENTS.md

plugin may move a transitive core package within core's declared ranges (`tests/pm/test_workspace_build_inputs.py::test_plugin_can_move_compatible_transitive_but_not_exact_requirement`). Plugin `python_dependencies` follow the plugin

262k43d agoReviewMountCreate a free account to mount
NousResearchAGENTS.md

hermes-agent / tests

NousResearch/hermes-agent/tests/AGENTS.md

tests/ — how Hermes tests are written and run Applies on top of the root `AGENTS.md`. Read it before adding or changing any test. ## Running tests **ALWAYS use `scripts/run_tests.sh`**, never bare

262k43d agoReviewMountCreate a free account to mount
NousResearchAGENTS.md

hermes-agent / web

NousResearch/hermes-agent/web/AGENTS.md

surface; a new surface is a new `web_routers/ .py`, not a growing `web_server.py`. - Tests: Python in `tests/hermes_cli/` (routers, pty bridge); JS in the `web/` vitest suite. Python tests must

262k43d agoReviewMountCreate a free account to mount
affaan-mAGENTS.md

ECC

affaan-m/ECC/AGENTS.md

Core Principles 1. **Agent-First** — Delegate to specialized agents for domain tasks 2. **Test-Driven** — Write tests before implementation, 80%+ coverage required 3. **Security-First** — Never compromise on security; validate

Steady13 mentions in 2 weeks

No other project uses it yet

246k3mo agoReviewMountCreate a free account to mount
TheAlgorithmsAGENTS.md

Python

TheAlgorithms/Python/AGENTS.md

change code and its doctests in the same PR.** If you're only updating tests, say so and touch nothing else. ## Code conventions (enforced by CI) - **Formatting & linting:** `ruff

Steady25 mentions in 2 weeks

No other project uses it yet

226k3y agoReviewMountCreate a free account to mount
sstAGENTS.md

opencode

sst/opencode/AGENTS.md

origin/dev`, target PRs at `dev`, and diff against `origin/dev` unless told otherwise. ## Live TUI Testing - Run `bun run dev:live` from a development worktree to test its TUI against

2 projects use a version of this

225k27d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode / copilotcli

microsoft/vscode/extensions/copilot/src/extension/chatSessions/copilotcli/AGENTS.md

copilotCLIPrompt.ts # Prompt reference extraction and parsing │ ├── customSessionTitleService.ts │ ├── delegationSummaryService.ts │ ├── utils.ts # SessionIdForCLI namespace (URI scheme: 'copilotcli') │ └── test/ │ ├── node/ # Node.js-specific (SDK integration, filesystem, permissions) │ ├── copilotCli.ts # ICopilotCLISDK, CopilotCLIModels, CopilotCLIAgents │ ├── copilotcliSession.ts # CopilotCLISession — main session

Steady+17 stars this week

No other project uses it yet

195k12d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode / agentHost

microsoft/vscode/src/vs/platform/agentHost/AGENTS.md

# Multi-Chat Architecture > Node runtime service construction is documented separately in [`node/serviceBootstrapping.md`](node/serviceBootstrapping.md). Host

No other project uses it yet

195k12d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode / prompts

microsoft/vscode/src/vs/platform/agentHost/node/copilot/prompts/AGENTS.md

overridden sections) and the full config at `trace`. Keep new config shapes summarizable there. - **Tests.** `../../../test/node/agentHostPromptRegistry.test.ts` covers the registry/wiring; `../../../test/node/toolInstructions.test.ts` covers the composition/gating. Add cases there, not new harnesses

Steady+17 stars this week

No other project uses it yet

195k12d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode / node

microsoft/vscode/src/vs/platform/agentHost/test/node/AGENTS.md

Agent host unit tests For tests in this area that touch the SessionDatabase, they MUST use an in-memory database, not a real database file on disk. Use `SessionDatabase.open(':memory

Steady+17 stars this week

No other project uses it yet

195k12d agoReviewMountCreate a free account to mount
instructkrAGENTS.md

claw-code / rust

instructkr/claw-code/rust/AGENTS.md

Anthropic Messages API. Prints `MOCK_ANTHROPIC_BASE_URL`. Dev-dep for CLI and analog tests. | | `runtime` | lib | Core: sessions, permissions, MCP, conversation loop. ~47 modules. | | `api` | lib | Provider clients: Anthropic

3 projects use a version of this

195k8mo agoReviewMountCreate a free account to mount
instructkrAGENTS.md

claw-code / src

instructkr/claw-code/src/AGENTS.md

Real logic (permissions, path scoping) | `permissions.py`, `path_scope.py` | | Query engine shim | `query_engine.py` | | Runtime simulation | `runtime.py` | | Tests | repo-root `tests/` (test_porting_workspace.py, test_security_scope.py) | Run tests: `python -m unittest discover -s tests` from repo

3 projects use a version of this

195k8mo agoReviewMountCreate a free account to mount
avelinoAGENTS.md

awesome-go

avelino/awesome-go/AGENTS.md

generator. - `.github/workflows/`: CI pipelines for PR quality validation, stale checks, site deployment, and Go tests. ## When Modifying the Awesome List - Read and respect `CONTRIBUTING.md` (alphabetical order, one item

Steady3 mentions in 2 weeks

No other project uses it yet

193k4y agoReviewMountCreate a free account to mount
Significant-GravitasAGENTS.md

AutoGPT

Significant-Gravitas/AutoGPT/AGENTS.md

Styling**: Tailwind CSS only, use design tokens, Hugeicons only (through the `Icon` atom) 5. **Testing**: Integration tests (Vitest + RTL + MSW) are the default (~90%, page-level). Playwright for E2E critical

Steady5 mentions in 2 weeks

No other project uses it yet

188k11d agoReviewMountCreate a free account to mount
DietrichGebertAGENTS.md

ponytail

DietrichGebert/ponytail/AGENTS.md

task and the code it touches. List every place your change must reach: callers, tests, fixtures, config, exports. Check what your change could break for users: data it would destroy

Steady22 mentions in 2 weeks

No other project uses it yet

182k5mo agoReviewMountCreate a free account to mount
twbsAGENTS.md

bootstrap

twbs/bootstrap/AGENTS.md

lint` / `npm run js-lint` — lint - `npm run docs-build` — build docs site - `npm test` — full test suite (lint + dist + tests + docs) ## Writing style Use ASD-STE100 Simplified Technical English

No other project uses it yet

175k37d 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.