AGENTS.md examples from real projects

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

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Worked for most · soon

AWS 1k+ stars

AWSAGENTS.md

aws-cdk

aws/aws-cdk/AGENTS.md

Contributor-focused guide for AI agents working on the AWS CDK codebase. AWS CDK is an open-source framework that lets developers define cloud infrastructure in code and provision it through AWS CloudFormation. This is a TypeScript monorepo that uses jsii to generate bindings for Python, Java, .NET, and Go. Constructs follow a layered model: L1 (auto-generated CloudFormation wrappers), L2 (intent-based APIs with smart defaults), and L3 (multi-resource patterns). See CONTRIBUTING.md for the full contributor guide. You are a CDK contributor. You…

13k18d agoReviewMount

AWSAGENTS.md

amazon-sagemaker-examples

aws/amazon-sagemaker-examples/AGENTS.md

Guidance for AI coding agents (Cursor, GitHub Copilot, Claude Code, Amazon Q Developer, Kiro, Codex, Gemini CLI, etc.) working in this repository. Follows the AGENTS.md convention (https://agents.md). This repository contains example notebooks for the Amazon SageMaker Python SDK v3. pip install sagemaker installs v3. SDK v3 is a modular redesign and is not backward compatible with v2. It is split into: Generate SageMaker Python SDK v3 code by default. Produce v2 code only when the user explicitly asks for "v2"…

11k2mo agoReviewMount

AWSAGENTS.md

karpenter-provider-aws / upgrading

aws/karpenter-provider-aws/website/content/en/docs/upgrading/AGENTS.md

These rules apply when you add or edit the per-version notes in upgrade-guide.md (the ### Upgrading to <version>+ sections). Rank notes within each group by impact as well. For metrics, that means how much observability breaks, e.g. how widely the metric is used and how many queries the change breaks. - This file isn't published: website/hugo.yaml lists AGENTS.md in ignoreFiles.

No other project uses it yet

7.7k36d agoReviewMount

AWSAGENTS.md

jsii

aws/jsii/AGENTS.md

AI agent contributor guide for the aws/jsii repository.

No other project uses it yet

2.9k33d agoReviewMount

AWSAGENTS.md

aws-lambda-web-adapter

aws/aws-lambda-web-adapter/AGENTS.md

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

2.8k8mo agoReviewMount

AWSAGENTS.md

sagemaker-python-sdk

aws/sagemaker-python-sdk/AGENTS.md

Guidance for AI coding agents (Cursor, GitHub Copilot, Claude Code, Amazon Q Developer, Kiro, Codex, Gemini CLI, etc.) working in this repository — the source of the Amazon SageMaker Python SDK. Follows the AGENTS.md convention (https://agents.md). This file has two audiences: 1. Contributors' agents editing SDK source, tests, and docs in this repo. 2. Any agent that reads this repo as a reference for how to use the SDK — so the usage guidance (v3 by default) is stated here…

Steady6 mentions in 2 weeks

No other project uses it yet

2.3k3mo agoReviewMount

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.