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 16Worked for most · soon
homeassistant-aiAGENTS.md

ha-mcp / homeassistant-addon-webhook-proxy

homeassistant-ai/ha-mcp/homeassistant-addon-webhook-proxy/AGENTS.md

transform (token rename + flavor-banner swap) and follows the dev-first flow like code; `CHANGELOG.md` stays per-flavor and gets a manual entry on each promote PR. ## Mutual exclusion Both

4.9k5d agoDiscuss
homeassistant-aiAGENTS.md

ha-mcp / tests

homeassistant-ai/ha-mcp/tests/AGENTS.md

Test Design Rules Every test under `tests/` follows these. Reviewers check new and changed tests against them. 1. **Test our code, not the platform.** Assert on behaviour this repository owns

4.9k5d agoDiscuss
MicrosoftAGENTS.md

fluentui-blazor

microsoft/fluentui-blazor/AGENTS.md

package version management - `.github/CODEOWNERS` - Code ownership (@vnbaaij @dvoituron) - `docs/contributing.md` - Contribution guidelines - `docs/unit-tests.md` - Detailed unit testing documentation ## Security Considerations - Do not commit sensitive data or credentials - Review the `SECURITY.md` file

4.8k57d agoDiscuss
callstackAGENTS.md

agent-device

callstack/agent-device/AGENTS.md

guards that reconstruct another source of truth. - Keep control-flow narration and review history out of implementation comments. Encode invariants in names, types, boundaries, and tests; reserve comments for public

4.8k4d agoReads credentialsDiscuss
Agenta-AIAGENTS.md

agenta / web

Agenta-AI/agenta/web/AGENTS.md

components in `web/storybook` (`stories/entity-ui/` for the data-connected `@agenta/entity-ui` surfaces). Cover the states a reviewer cannot reach by clicking — empty, error, read-only, migration. Nothing type-checks that package

4.8k2mo agoDiscuss
thunderbirdAGENTS.md

thunderbolt

thunderbird/thunderbolt/AGENTS.md

file components only ### `useEffect` Discipline **Treat every `useEffect` as a code smell until proven necessary.** Before writing or reviewing a `useEffect`, consult https://react.dev/learn/you-might-not-need-an-effect and verify it doesn

4.8k3mo agoReads credentialsDiscuss
jakubkrehelAGENTS.md

skills

jakubkrehel/skills/AGENTS.md

verification checks and the format for a standalone review. See below. Supporting `.md` files carry depth beyond the principle statements: recipes, code patterns, lookup tables. Link each one from

4.8k33d agoDiscuss
mvanhornAGENTS.md

cli-printing-press

mvanhorn/cli-printing-press/AGENTS.md

seeing the blocker. Plan documents stay local (see "Plan documents stay local" below). ## Automated code review with Greptile Every PR gets automated Greptile review alongside CI. Resolve every Greptile finding

4.8k5mo agoDiscuss
MicrosoftAGENTS.md

WindowsAppSDK

microsoft/WindowsAppSDK/AGENTS.md

Clarification - Ambiguous requirements after reviewing docs - Cross-feature impact unclear - API usage patterns not well documented ## Detailed Documentation - [Coding Guidelines](docs/Coding-Guidelines.md) – Complete coding standards and checklist - [Contributor Guide](docs/contributor-guide.md) – Contribution

4.7k9mo agoDiscuss
JetBrainsAGENTS.md

koog

JetBrains/koog/AGENTS.md

Quality Gates Read and follow the Quality Gates section in /TESTING.md before considering any code change complete. ## Architecture ### Core Framework Components **AIAgent** — Main orchestrator that executes strategies in coroutine scopes

4.6k5mo agoDiscuss
gptmeAGENTS.md

gptme

gptme/gptme/AGENTS.md

only the CC root; pass `--scope cc` when the memory must appear in Claude Code without recall. ### Inspect and manage ```bash gptme-util memory roots # Which roots are active

4.4k4mo agoDiscuss
crmneAGENTS.md

ruby_llm

crmne/ruby_llm/AGENTS.md

Ground rules - New features need an approved GitHub issue before any code. PRs without one get closed without review. - Never edit generated files: `lib/ruby_llm/models.json`, `lib/ruby_llm/aliases.json`, `docs/_reference/available-models.md`. `rake models` regenerates them

4.4k17d agoReads credentialsDiscuss
ElasticAGENTS.md

elasticsearch-py

elastic/elasticsearch-py/AGENTS.md

generate a contribution is not contributing. PRs opened this way will be closed without review. If a human asks you to "find something to work on" or points

4.4k36d agoDiscuss
inkeepAGENTS.md

open-knowledge

inkeep/open-knowledge/AGENTS.md

break`, `WARN: a sibling that silently drifts if this changes`, `UPSTREAM(electron/electron#19920): a code shape forced on us from outside this repo`. - **A validated citation**, as in `precedent

4.3k3mo agoDiscuss
archestra-aiAGENTS.md

archestra / platform

archestra-ai/archestra/platform/AGENTS.md

releases of critical packages to allow community security review. Always review `pnpm-lock.yaml` changes in PRs. ## Coding Conventions **General**: - **Prefer Classes for Stateful Modules**: When encapsulating functionality that involves state (cached

4.3k4d agoReads credentialsDiscuss
MicrosoftAGENTS.md

AI-Engineering-Coach

microsoft/AI-Engineering-Coach/AGENTS.md

VS Code extension that analyzes local AI session logs and surfaces insights in a webview dashboard. Read-only, zero telemetry, all analysis runs on the user's machine.

4.3k4mo agoReads credentialsDiscuss
robinebersAGENTS.md

openusage

robinebers/openusage/AGENTS.md

reload. The app is a long-lived menu-bar process, so **every code change requires a full rebuild and restart of the running app** to take effect — kill the running

4.3k3mo agoDiscuss
arcboxlabsAGENTS.md

arcbox

arcboxlabs/arcbox/AGENTS.md

pushes made while a PR is closed fire no events). - Review-bot findings (pullfrog/Codex/Greptile) get verified against the code first, then either fixed with a reply + thread resolution, or refuted

4.3k2mo agoReads credentialsDiscuss
nolabs-aiAGENTS.md

nono

nolabs-ai/nono/AGENTS.md

within-allow, so do not create a broad grant that defeats a required denial. - Review Linux and macOS separately when a change affects enforcement, networking, paths, processes, sockets, credentials

4.2k24d agoDiscuss
EverMind-AIAGENTS.md

Raven

EverMind-AI/Raven/AGENTS.md

contain** (same as §3.3): - `🤖 Generated with [Claude Code](https://...)` marketing banners; - `Refs: ...` to ignored/local-only paths; - internal branch names / commit-hash references (no reviewer context). **Preview-verification (required):** 1. After drafting

4.2k3mo agoDeletes or force-pushesDiscuss
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.