AGENTS.md examples from real projects

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

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

NousResearchReads credentialsAGENTS.md

hermes-agent

NousResearch/hermes-agent/AGENTS.md

refactors; extending before duplicating (3+ PRs in one category → an ABC + orchestrator); behaviour-contract tests; E2E with real imports against a temp `HERMES_HOME` for resolution, config, security

No other project uses it yet

NousResearchReads credentialsAGENTS.md

hermes-agent / cron

NousResearch/hermes-agent/cron/AGENTS.md

root, so a child working against a scratch `HERMES_HOME` keeps a writable board. ## Tests `tests/cron/`, `tests/hermes_cli/test_kanban*.py`, `tests/tools/test_kanban*.py`. Schedule parsing and catch-up windows are pure functions — test

NousResearchReads credentialsAGENTS.md

hermes-agent / gateway

NousResearch/hermes-agent/gateway/AGENTS.md

exists. A sealed native stream is a regular message — `chat.update` works (live-verified). Contract tests: `tests/gateway/test_stream_final_contract.py` (mutation-checked). Slack ground truth: `chat.*Stream` speaks STANDARD markdown, not mrkdwn; `stopStream.markdown_text

NousResearchReads credentialsAGENTS.md

hermes-agent / hermes_cli

NousResearch/hermes-agent/hermes_cli/AGENTS.md

ROOT_KEYS`). For a new key: `rg -n '" "' hermes_cli/config_defaults.py` AND `rg -n ' ' --glob '!tests' .` both hit, and one invariant test sets it in a temp `config.yaml` and asserts

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

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

No other project uses it yet

NousResearchReads credentialsAGENTS.md

hermes-agent / skills

NousResearch/hermes-agent/skills/AGENTS.md

every call — ship a helper script and reference it by skill-relative path. 7. **Tests at `tests/skills/test_ _skill.py`**, stdlib + pytest + `unittest.mock` only, no live network. Run `scripts/run_tests.sh tests/skills/test_ _skill.py

No other project uses it yet

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

No other project uses it yet

NousResearchReads credentialsAGENTS.md

hermes-agent / tools

NousResearch/hermes-agent/tools/AGENTS.md

skills, terminal, todo, tts, video, vision, web, yuanbao` (don't assert the list in tests). Per-platform enable/disable via `hermes tools` (curses) or `tools. .enabled/disabled` in config.yaml. `browser_exec

NousResearchReads credentialsAGENTS.md

hermes-agent / tui_gateway

NousResearch/hermes-agent/tui_gateway/AGENTS.md

import; the dispatcher rejects unknown param keys (`4000` + key path) and, under `HERMES_TEST_ISOLATION=1`, raises `ContractViolation` when a handler's result or an emitted payload does not match

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

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

No other project uses it yet

affaan-mReads credentialsAGENTS.md

ECC

affaan-m/ECC/.codex/AGENTS.md

guidance, read `docs/CODEX-NAVIGATION-GUIDE.md` after this supplement. ## Model Recommendations | Task Type | Recommended Model | |-----------|------------------| | Routine coding, tests, formatting | GPT 5.5 | | Complex features, architecture | GPT 5.5 | | Debugging, refactoring | GPT 5.5 | | Security review

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

No other project uses it yet

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

n8n-ioReads credentialsAGENTS.md

n8n

n8n-io/n8n/AGENTS.md

Essential Commands For routine pre-commit checks, follow [Verify changes](#verify-changes). For focused tests, use `pnpm agent:test` or `pnpm agent:playwright`. Pass test files and worker limits after

firecrawlReads credentialsAGENTS.md

firecrawl

firecrawl/firecrawl/AGENTS.md

here are the general steps you should take: 1. Write some end-to-end tests that assert your win conditions, if they don't already exist - 1 happy path (more

No other project uses it yet

instructkrReads credentialsAGENTS.md

claude-code

instructkr/claude-code/AGENTS.md

Cargo workspace: 11 crates, `claw` binary ├── src/ # Python porting workspace + reference_data/ parity snapshots ├── tests/ # Python unittest validation of src/ + scripts/ (stdlib unittest) ├── docs/ # g0XX gate verification maps + topic docs