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

spec-kit

github/spec-kit/AGENTS.md

GitHub Spec Kit is a comprehensive toolkit for implementing Spec-Driven Development (SDD) - a methodology that emphasizes creating clear specifications before implementation. The toolkit includes templates, scripts, and workflows that guide development teams through a structured approach to building software. Specify CLI is the command-line interface that bootstraps projects with the Spec Kit framework. It sets up the necessary directory structures, templates, and AI agent integrations to support the Spec-Driven Development workflow. The toolkit supports multiple AI coding assistants, allowing…

Steady+42 stars this week

No other project uses it yet

149k12d agoReviewMountCreate a free account to mount
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: Frontmatter must be valid YAML and meet the metadata…

No other project uses it yet

41k20d agoReviewMountCreate a free account to mount
GitHubAGENTS.md

awesome-copilot / improve-history

github/awesome-copilot/skills/foundry-agentic-loop/evals/fixtures/improve-history/AGENTS.md

This workspace is built with spec-driven development. For build requests and the short commands below, load the foundry-agentic-loop skill and follow its references/sdd.md; it checks the live run first and resumes a running or paused run instead of starting a second one. - The spec and contract live in docs/spec.md, lessons in docs/LOOP.md and Azure settings only in .azure/deployment-plan.md, never here. - This section locks the build mode. Change it only when the user explicitly confirms a switch. <!-- foundry-agentic-loop:end…

No other project uses it yet

41k20d agoReviewMountCreate a free account to mount
GitHubAGENTS.md

awesome-copilot / rapid-locked

github/awesome-copilot/skills/foundry-agentic-loop/evals/fixtures/rapid-locked/AGENTS.md

Team conventions: Python formatted with ruff, TypeScript with prettier. This workspace is a rapid prototype in an existing Foundry project. For build requests, load the foundry-agentic-loop skill and follow its references/rapid.md. Short commands: - The contract lives in the root README.md, lessons in docs/LOOP.md and Azure settings only in .azure/deployment-plan.md, never here. - This section locks the build mode. Change it only when the user explicitly confirms a switch. <!-- foundry-agentic-loop:end -->

No other project uses it yet

41k20d agoReviewMountCreate a free account to mount
GitHubAGENTS.md

awesome-copilot / team-conventions

github/awesome-copilot/skills/foundry-agentic-loop/evals/fixtures/team-conventions/AGENTS.md

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

No other project uses it yet

41k20d agoReviewMountCreate a free account to mount
GitHubAGENTS.md

awesome-copilot / templates

github/awesome-copilot/skills/repo-standardizer/templates/AGENTS.md

Telegraph style. Root rules only. Guidance for AI coding agents (Claude Code, Cursor, Copilot, OpenClaw, etc.) working in this repository.

1 project uses a version of this

41k20d agoReviewMountCreate a free account to mount
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
GitHubAGENTS.md

docs / responsible-use

github/docs/content/copilot/responsible-use/agents.md

{% data reusables.rai.copilot.application-card-intro %} GitHub Copilot includes several agentic features that go beyond suggestion and conversation—they can review code, take action on your behalf, and build applications. This card covers…

21k37d agoReviewMountCreate a free account to mount
GitHubAGENTS.md

copilot-sdk / E2E

github/copilot-sdk/dotnet/test/E2E/AGENTS.md

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

No other project uses it yet

11k53d agoReviewMountCreate a free account to mount
GitHubAGENTS.md

copilot-sdk / java

github/copilot-sdk/java/AGENTS.md

This directory is the Java SDK's Maven reactor. Paths and commands below are relative to this directory, whether it is nested at src/sdk/java or exported as java. Keep API usage examples in README.md, the SDK documentation, and public Javadoc rather than duplicating them in these contributor instructions. - sdk/src/main/java/ contains the handwritten client, session, and RPC APIs. sdk/src/test/java/ contains unit and integration tests. - sdk/src/generated/java/ contains generated protocol and event types. - copilot-native/ packages platform-specific runtime artifacts separately from the…

11k53d agoReviewMountCreate a free account to mount
GitHubAGENTS.md

copilot-sdk / rust

github/copilot-sdk/rust/AGENTS.md

This directory contains the independent github-copilot-sdk crate. In standalone SDK workflows, paths and Cargo commands below are relative to this directory, and this crate's own lockfile and toolchain apply. When nested at src/sdk/rust, the runtime CLI consumes the same checked-out sources through the Bazel integration described under Development. The runtime's N-API architecture does not otherwise govern this crate. - Use the existing Error and ErrorKind in src/errors.rs. Extend that public error contract instead of adding parallel per-module error types or…

11k53d agoReviewMountCreate a free account to mount
GitHubAGENTS.md

codeql / unified

github/codeql/unified/AGENTS.md

This is a CodeQL extractor that maps a language's parse tree onto a shared AST using the yeast desugaring engine. Swift, the only language so far, is parsed by Apple's swift-syntax rather than by tree-sitter. - The raw parse tree's shape is described by extractor/swift_node_types.yml, which is generated from swift-syntax by swift-syntax-rs/schemagen. Do not edit it by hand; regenerate it with scripts/regenerate-node-types.sh after changing the pinned swift-syntax version, then review the diff alongside the mapping in extractor/src/languages/swift/swift.rs. - To run…

10k4y agoReviewMountCreate a free account to mount
GitHubAGENTS.md

gh-aw

github/gh-aw/AGENTS.md

GitHub Agentic Workflows (gh-aw) is a GitHub CLI extension that compiles markdown workflows into GitHub Actions. To keep first-turn context small, only these repository root instruction files should be considered ambient: Everything else should be loaded lazily through skills only when needed. Workflows that declare a source: frontmatter entry (for example source: githubnext/agentic-ops@<ref>) are provenance-managed from an upstream bundle.

5.6k6mo agoReviewMountCreate a free account to mount
GitHubReads credentialsAGENTS.md

squad

github/squad/.github/agents.md

Agent-facing guide to using Squad — the multi-agent team orchestrator for GitHub Copilot. Covers installation, slash commands, planning lifecycle, structured artifacts, and safe-output constraints.

No other project uses it yet

3.4k2mo agoReviewMountCreate a free account to mount
GitHubAGENTS.md

copilot-cli-for-beginners

github/copilot-cli-for-beginners/AGENTS.md

Beginner-friendly course teaching GitHub Copilot CLI. Educational content, not software.

Steady3 mentions in 2 weeks

No other project uses it yet

2.9k5mo agoReviewMountCreate a free account to mount
GitHubAGENTS.md

gh-stack

github/gh-stack/AGENTS.md

A GitHub CLI (gh) extension for managing stacked branches and pull requests. Written in Go, it automates creating branches, keeping them rebased, setting PR base branches, and navigating between stack layers. Repository operations require Git 2.36 or later. Always run go vet before tests. See CONTRIBUTING.md for the alternative canonical go test command, targeted tests, and timing artifacts. CI runs the full platform-applicable suite with race detection on Linux, macOS, and Windows, with a cross-shard completion gate. There is no…

Steady7 mentions in 2 weeks

No other project uses it yet

1.8k19d agoReviewMountCreate a free account to mount
GitHubAGENTS.md

branch-deploy

github/branch-deploy/AGENTS.md

This file applies to the entire repository. It is the repository-specific instruction source for coding agents and automated contributors. Keep this file durable, small, and focused on rules that should apply every time work happens in this repository. Do not add one-off task plans, temporary investigation notes, local machine details, or long procedure transcripts here. Move detailed operating procedures to docs/, reusable workflows to skills, and directory-specific rules to a closer nested AGENTS.md if that scope ever appears. Codex loads…

5794mo agoReviewMountCreate a free account to mount
GitHubAGENTS.md

gh-actions-lock

github/gh-actions-lock/AGENTS.md

Write Go that follows the Google Go Style Guide and lines up with cli/cli conventions. Keep it readable and simple. Doc comments earn their keep by saying something the code doesn't. Skip: When in doubt, fewer words. If a comment reads like marketing or a victory lap, delete it. There are two test layers with different guarantees. Put a test in the cheapest layer that can actually prove the thing, and don't restate the same claim in both. - Go…

3044mo agoReviewMountCreate a free account to mount
GitHubAGENTS.md

replica

github/replica/AGENTS.md

Replica contains the self-hosted Hub, selectable prototype starters, and the shared prototype build action. Read Contributing and the shared documentation index, then read the affected project's instructions and guides before editing. Keep shared rules in root guides and project-specific rules in the affected project. Do not apply Hub's Rails, Primer, or devcontainer requirements to the starter, build action, or shared packages. The starter's copied instructions must remain usable without this monorepo. Follow the commit and PR conventions and the repository's…

23023d agoReviewMountCreate a free account to mount
GitHubAGENTS.md

replica / hub

github/replica/hub/AGENTS.md

Replica Hub is a self-hosted Rails application where teams review prototype branches. GitHub owns source code and repository access. Hub stores Builds and review data. Prototype code runs on isolated preview origins. Read the root instructions and shared guides, then the Hub documentation index and guides for the work:

23023d 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.