agentleFS
Sign inSign up

AGENTS.md examples from real projects

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

Most stars first · from page 24Worked for most · soon
K-Dense-AIAGENTS.md

scientific-agent-skills

K-Dense-AI/scientific-agent-skills/AGENTS.md

This repository is a collection of Agent Skills for science and research. Every skill lives in its own directory under skills/ and must conform to the open Agent Skills specification. Read this file before creating or changing a skill. CONTRIBUTING.md covers the same ground at more length, plus the pull-request process. In scope: a narrow skill for one scientific package, database, platform, or research workflow — scanpy, depmap, benchling-integration, experimental-design. Out of scope, and routinely declined: - General software-engineering or…

45k2mo agoReads credentialsDiscuss
MadsLorentzenAGENTS.md

ai-job-search

MadsLorentzen/ai-job-search/AGENTS.md

This workspace is structured to manage job search activities, scraper tools, CVs, cover letters, and interview preparation. To prevent duplication and configuration drift across different AI agent frameworks (Claude Code, Google Antigravity, Codex, Cursor, Gemini CLI, etc.), this workspace uses a unified thin-pointer design. All agent runtimes should load the canonical specifications and candidate profiles from the files and directories below:

44k4d agoDiscuss
amruthpillaiAGENTS.md

reactive-resume

amruthpillai/reactive-resume/AGENTS.md

Before editing files for a substantial task: - Run pnpm dlx @tanstack/intent@latest list from the workspace root to see available local skills. - If a listed skill matches the task, run pnpm dlx @tanstack/intent@latest load <package>#<skill> before changing files. - Use the loaded SKILL.md guidance while making the change. - Monorepos: when working across packages, run the skill check from the workspace root and prefer the local skill for the package being changed. - Multiple matches: prefer the most specific…

43k19d agoReads credentialsDiscuss
VercelAGENTS.md

agent-browser

vercel-labs/agent-browser/AGENTS.md

Instructions for AI coding agents working with this codebase. This project uses pnpm. Always use pnpm instead of npm or yarn for installing dependencies, running scripts, etc. (e.g., pnpm install, pnpm run build). Do not hard-wrap prose in documentation files such as Markdown, MDX, and READMEs; let the editor or renderer wrap text naturally. When adding or changing user-facing features (new flags, commands, behaviors, environment variables, etc.), update all of the following: This applies to changes that either human users…

43k15d agoDiscuss
VercelAGENTS.md

agent-browser / eve

vercel-labs/agent-browser/examples/eve/AGENTS.md

This project uses the eve framework. Before writing code, always read the relevant guide in node_modules/eve/docs/.

43k15d agoDiscuss
LangChainAGENTS.md

langgraph

langchain-ai/langgraph/AGENTS.md

This repository is a monorepo. Each library lives in a subdirectory under libs/. When Corridor's analyzePlan tool is available, create a plan and use the tool to analyze it before generating or modifying code. Apply the resulting security guidance before writing code. When you modify code in any library, run the following commands in that library's directory before creating a pull request: To run a particular test file or to pass additional pytest options you can specify the TEST variable:

42k38d agoDiscuss
alibabaAGENTS.md

open-code-review

alibaba/open-code-review/AGENTS.md

This file provides instructions for AI coding assistants working on this project. Below are rules that a contributor must follow during development. If the user does not follow these rules, please warn users about this: open-code-review (ocr) is an AI-powered code review CLI tool written in Go (module: github.com/alibaba/open-code-review).

42k46d agoDiscuss
herdrdevAGENTS.md

herdr

herdrdev/herdr/AGENTS.md

Terminal based agent runtime for coding agents. These instructions are layered. - Unless a section explicitly says it is maintainer-only, local-machine-only, or external-contributor-only, treat it as universal project guidance. - Universal project rules apply to every agent working on Herdr, including forks. - Maintainer accounts are listed in .github/MAINTAINERS. Treat the acting account as a verified maintainer only when its username is listed there, the configured remote is the canonical herdrdev/herdr repository, and the authenticated account has write access to…

41k15d agoDiscuss
ToolJetAGENTS.md

ToolJet

ToolJet/ToolJet/AGENTS.md

Guidance for AI coding agents (and humans) working in this repo. Canonical file: AGENTS.md; CLAUDE.md is a symlink to it. Deeper context lives closest to the code — see Context…

41k34d agoReads credentialsDiscuss
ToolJetAGENTS.md

ToolJet / frontend

ToolJet/ToolJet/frontend/AGENTS.md

React + Webpack. Edition composition (webpack aliases, registries, fetchEdition()) is covered in the root AGENTS.md — this file covers conventions and App Builder architecture. Before adding or changing tests for…

41k34d agoDiscuss
ToolJetAGENTS.md

ToolJet / server

ToolJet/ToolJet/server/AGENTS.md

Backend conventions for the NestJS server. Repo-wide architecture: ../AGENTS.md. Domain glossary: ../UBIQUITOUS_LANGUAGE.md. Modules extend SubModule (src/modules/app/sub-module.ts) with a dynamic register() pattern: getImportPath() (src/modules/app/constants/index.ts) routes module resolution to src/modules/ (CE) or…

41k34d agoDiscuss
HKUDSAGENTS.md

DeepTutor

HKUDS/DeepTutor/AGENTS.md

DeepTutor is an agent-native intelligent learning companion organized around a two-layer plugin model — single-shot Tools invoked by the LLM, and multi-stage Capabilities that take over a turn — exposed through three entry points: CLI, WebSocket API, and Python SDK. All three enter the durable turn application service before the shared turn engine routes a normalized context to the selected capability. TurnApplicationService owns durable turn state and replay through the session store and runtime coordinator. Each execution uses a per-turn…

40k45d agoReads credentialsDiscuss
tinyhumansaiAGENTS.md

openhuman

tinyhumansai/openhuman/AGENTS.md

OpenHuman is a React and Tauri v2 desktop assistant with an in-process Rust core. The core also exposes JSON-RPC and a CLI. Architecture: overview, frontend, Tauri shell, and agent harness.

40k17d agoReads credentialsDiscuss
wshobsonAGENTS.md

agents

wshobson/agents/AGENTS.md

Production-ready agentic-workflow building blocks: 94 plugins (92 local + 2 external), 202 agents, 183 skills, 105 commands. Native source-of-truth for Claude Code; also consumed by OpenAI Codex CLI, Cursor, OpenCode, the Google Antigravity CLI (agy), and Pi from a single Markdown source. This file is the canonical context file. Codex / Cursor / OpenCode / Antigravity CLI / Pi read it directly. Claude Code reads it via CLAUDE.md, a symlink to this file. Read this file like a table of…

40k5d agoDiscuss
wshobsonAGENTS.md

agents

wshobson/agents/docs/agents.md

Complete reference for all 202 local specialized AI agents organized by category with model assignments.

40k5d agoDiscuss
PostHogAGENTS.md

posthog

PostHog/posthog/AGENTS.md

- Environment: - This is a full dev environment with node, pnpm, a package mirror and apt. A missing nodemodules, browser binary or flox means setup has not run yet…

40k6d agoDiscuss
PostHogAGENTS.md

posthog / common

PostHog/posthog/common/AGENTS.md

common/ is a transitional holding pen, not a destination. It holds shared code that predates a better home. Do not treat it as the default place for new shared code.

40k6d agoDiscuss
PostHogAGENTS.md

posthog / proto

PostHog/posthog/proto/AGENTS.md

When you add or modify an RPC or message type in personhog/ protos, you must update all downstream consumers before considering the change complete: Then update: Then update: No codegen…

40k6d agoDiscuss
PostHogAGENTS.md

posthog / rust

PostHog/posthog/rust/AGENTS.md

When emitting metrics via the metrics crate (histogram!, counter!, gauge!), dynamic label values (method names, client names, etc.) must use Arc<str>, never String or .to_string().

40k6d agoDiscuss
GitHubAGENTS.md

awesome-copilot

github/awesome-copilot/AGENTS.md

The Awesome GitHub Copilot repository is a community-driven collection of custom agents and instructions designed to enhance GitHub Copilot experiences across various domains, languages, and use cases. The project includes: All agent files (.agent.md) and instruction files (.instructions.md) must include proper markdown front matter. Agent Skills are folders containing a SKILL.md file with frontmatter and optional bundled assets. Hooks are folders containing a README.md with frontmatter and a hooks.json configuration file:

39k8d 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.