agentleFS

AGENTS.md examples from real projects

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

Worked for most · soon
GitHubAGENTS.md

awesome-copilot / templates

github/awesome-copilot/skills/setup-my-iq/assets/templates/AGENTS.md

These pointers tell agents where the user's personal context files live. Read only the file(s) needed to answer a question; do not load all of them by default. Run the setup-my-iq skill to populate these context files (or fill them in manually). Once they exist, update each @<path> pointer below to reference the real location. - identityProfile — name, role, org, team, manager, what the user does, what people come to them for. @<CONTEXT_DIR>/identity.md - roleAndResponsibilities — responsibilities per team,…

No other project uses it yet

41k20d agoReviewMountCreate a free account to mount
PostHogAGENTS.md

posthog

PostHog/posthog/AGENTS.md

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

No other project uses it yet

40k25d agoReviewMountCreate a free account to mount
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.

1 project uses a version of this

40k25d agoReviewMountCreate a free account to mount
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…

1 project uses a version of this

40k25d agoReviewMountCreate a free account to mount
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().

40k25d agoReviewMountCreate a free account to mount
DockerAGENTS.md

compose

docker/compose/AGENTS.md

All agents must conform to AI_POLICY.md and the Compose-specific rules in CONTRIBUTING.md. - Build: make build - Test all: make test - Test unit: go test ./pkg/... — needs no Docker daemon; the e2e suite is gated behind the e2e build tag and is not picked up - Test single: go test ./pkg/compose/ -run TestFunctionName - E2E tests: go test -tags e2e ./pkg/e2e/ -run TestName — requires a Docker daemon and the locally built binary (make build) - New e2e…

39k46d agoReviewMountCreate a free account to mount
VercelAGENTS.md

add-skill

vercel-labs/add-skill/docs/agents.md

Back to the README Skills can be installed to any of these agents:

39k19d agoReviewMountCreate a free account to mount
Hugging FaceAGENTS.md

pytorch-image-models

huggingface/pytorch-image-models/AGENTS.md

No summary in the file. Open it to read it.

Steady14 mentions in 2 weeks

No other project uses it yet

37k25d agoReviewMountCreate a free account to mount
BlockAGENTS.md

sprout / migrations

block/sprout/crates/buzz-push-gateway/migrations/AGENTS.md

Read docs/database.md before changing anything here. The existing push_gateway_* tables are also duplicated in the relay schema (migrations/ and schema/); until that duplication is removed, a change to them goes there too. The target is for the gateway to own its tables alone, so put new gateway tables only here. Never edit a merged migration.

No other project uses it yet

37k9d agoReviewMountCreate a free account to mount
BlockAGENTS.md

sprout / agents

block/sprout/desktop/src/features/agents/AGENTS.md

Scope: desktop/src/features/agents/ (config surfaces, shared config renderer, and the agent config core). Read this before changing how harness / provider / model / effort configuration is modeled, rendered, persisted, or applied. Plan of record: Buzz/Harness-Provider-Model.md in Morgan's Obsidian vault (PR sequence, decisions log). PRs: #2140 (rename), #2148 (flag reduction), #2156 (honest model states), #2158 (Agent Config Core). Harness capability facts have exactly one source: the Rust runtime catalog. KnownAcpRuntime (desktop/src-tauri/src/managed_agents/discovery/runtime_metadata.rs) declares each harness's model/provider/effort env keys and capabilities. Spawn applies…

37k9d agoReviewMountCreate a free account to mount
BlockAGENTS.md

sprout / migrations

block/sprout/migrations/AGENTS.md

Before changing anything in this directory, read docs/database.md. In short: - Add no triggers, functions, procedures, rules, or foreign keys. There are no exceptions, including the community write-fence attachment. - Put no data backfills in migrations: no UPDATE, INSERT, or DELETE over existing rows. Use the backfill framework in docs/data-backfills.md, or, until it ships, a reviewed one-off script in scripts/maintenance/. - Make each change in every schema location: migrations/, schema/tables/public/, the schema/ manifest and sibling directories, scripts/reconcile-schema-after-pgschema.sql where it applies,…

37k9d agoReviewMountCreate a free account to mount
BlockAGENTS.md

sprout / schema

block/sprout/schema/AGENTS.md

This directory follows the same rules as migrations/. Read docs/database.md and migrations/AGENTS.md before changing anything here.

No other project uses it yet

37k9d agoReviewMountCreate a free account to mount
ContinueAGENTS.md

continue / cli

continuedev/continue/extensions/cli/AGENTS.md

This is a CLI tool for Continue Dev that provides an interactive AI-assisted development experience. The architecture consists of:

Steady8 mentions in 2 weeks

No other project uses it yet

36k9mo agoReviewMountCreate a free account to mount
AnthropicAGENTS.md

knowledge-work-plugins / zoom-plugin

anthropics/knowledge-work-plugins/partner-built/zoom-plugin/AGENTS.md

Cross-platform discovery file for agent tools that look for AGENTS.md. This repository contains a Zoom developer plugin centered on SKILL.md-based workflows and reference material. Primary capabilities: - choose the right Zoom surface for a use case - plan Zoom integrations across REST APIs, SDKs, webhooks, OAuth, and MCP - debug broken Zoom integrations - build focused Zoom implementations for meetings, bots, chat, phone, contact center, and virtual agent workflows - provide deep product-specific reference material under skills/

Steady8 mentions in 2 weeks

No other project uses it yet

35k10mo agoReviewMountCreate a free account to mount
Hugging FaceAGENTS.md

diffusers

huggingface/diffusers/.ai/AGENTS.md

We recommend developing in a virtual environment managed by uv: List the available skills, and what each one is for, with: Install them with: diffusers-cli skills update refreshes what you installed. Skills used to be installed through the Makefile, which symlinked the project-level .claude/skills and .agents/skills at .ai/skills in this repo. Remove those links if they exist — otherwise the install writes through them into .ai/ itself: At the start of a session, confirm the setup and tell the user…

Steady2 mentions in 2 weeks

No other project uses it yet

35k2mo agoReviewMountCreate a free account to mount
VercelAGENTS.md

agent-skills

vercel-labs/agent-skills/AGENTS.md

A collection of skills for AI coding agents working with Vercel projects. Skills are packaged instructions and scripts that extend agent capabilities. bash bash /mnt/skills/user/{skill-name}/scripts/{script}.sh [args] Skills are loaded on-demand…

1 project uses a version of this

33k6mo agoReviewMountCreate a free account to mount
VercelAGENTS.md

agent-skills / composition-patterns

vercel-labs/agent-skills/skills/composition-patterns/AGENTS.md

Version 1.0.0 Engineering January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring React codebases using composition. Humans may also find it…

Rising2 mentions in 2 weeks

131 projects use a version of this

33k6mo agoReviewMountCreate a free account to mount
VercelAGENTS.md

agent-skills / react-best-practices

vercel-labs/agent-skills/skills/react-best-practices/AGENTS.md

Version 1.0.0 Vercel Engineering January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring React and Next.js codebases. Humans may also find…

134 projects use a version of this

33k6mo agoReviewMountCreate a free account to mount
VercelAGENTS.md

agent-skills / react-native-skills

vercel-labs/agent-skills/skills/react-native-skills/AGENTS.md

Version 1.0.0 Engineering January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring React Native codebases. Humans may also find it useful,…

33k6mo agoReviewMountCreate a free account to mount
VercelAGENTS.md

agent-skills / react-view-transitions

vercel-labs/agent-skills/skills/react-view-transitions/AGENTS.md

Version 1.0.0 Vercel Engineering Note: This standalone guide is compiled from SKILL.md and its reference files for agents that consume a single AGENTS.md document. Edit the source files, not this…

Steady4 mentions in 2 weeks

No other project uses it yet

33k6mo 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.