agentleFS
Sign inSign up

AGENTS.md examples from real projects

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

Popular:code reviewtestingpdfMCP serverfrontendsecuritydocumentation
Best matchesWorked for most · soon
“security” remove filterKnown publishers remove filterHiding risky files remove filter
Yakoub-aiAGENTS.md

Tech-Skills / security

Yakoub-ai/Tech-Skills/skills/security/AGENTS.md

Coordinates security and compliance - manages Security Architects, Compliance Officers, and Security Hardeners

05mo agoDiscuss
Agent-Rules-EcosystemAGENTS.md

security-agent-skill

Agent-Rules-Ecosystem/security-agent-skill/AGENTS.md

Transversal Cybersecurity, SecOps, OWASP Audit, Secret Scanning, and Encryption Skill for AI Agents.

039d agoDiscuss
affaan-mAGENTS.md

ECC

affaan-m/ECC/AGENTS.md

domain tasks 2. **Test-Driven** — Write tests before implementation, 80%+ coverage required 3. **Security-First** — Never compromise on security; validate all inputs 4. **Immutability** — Always create new objects, never mutate

246k30d agoDiscuss
DeepSeekAGENTS.md

deepseek-harness / experimental

deepseek-ai/deepseek-harness/packages/experimental/AGENTS.md

packages through `devDependencies`; examples may load them explicitly. - Experimental status does not relax engineering, security, documentation, lifecycle, testing, invariant, or snapshot requirements. - Publishing an experimental package does not promote

238k51d agoDiscuss
MicrosoftAGENTS.md

vscode / references

microsoft/vscode/extensions/copilot/assets/prompts/skills/agent-customization/references/agents.md

/hooks.md)). ### Supported Events `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `PreCompact`, `SubagentStart`, `SubagentStop`, `Stop` ### Example ```yaml --- description: "Secure code reviewer that blocks dangerous commands" tools: [read, search, execute] hooks: PreToolUse: - type: command command

193k21d agoDiscuss
MicrosoftAGENTS.md

vscode / copilotcli

microsoft/vscode/extensions/copilot/src/extension/chatSessions/copilotcli/AGENTS.md

Operations * Search Operations * Agent & Task Operations * User Interaction * Code Review & Git * Data, Memory & MCP * Security ### `common/copilotCLIPrompt.ts` Parses raw user prompts and extracts structured chat prompt references (files, locations, diagnostics) ### `node/copilotcliPromptResolver.ts

193k21d agoDiscuss
MicrosoftAGENTS.md

vscode / prompts

microsoft/vscode/src/vs/platform/agentHost/node/copilot/prompts/AGENTS.md

FAMILY`, which is process-scoped and would leak across every session in the window. > **Security note.** The setting is application-scoped (not workspace-configurable) and forwarded to the agent host

193k21d agoDiscuss
DietrichGebertAGENTS.md

ponytail

DietrichGebert/ponytail/AGENTS.md

efficiency), input validation at trust boundaries, error handling that prevents data loss, security, accessibility, the calibration real hardware needs (the platform is never the spec ideal, a clock drifts

143k4mo agoDiscuss
MicrosoftAGENTS.md

PowerToys

microsoft/PowerToys/AGENTS.md

Top-level AI contributor guidance for developing PowerToys - a collection of Windows productivity utilities

139k8mo agoDiscuss
addyosmaniAGENTS.md

agent-skills

addyosmani/agent-skills/AGENTS.md

parallel fan-out with a merge step** — used by `/ship` to run `code-reviewer`, `security-auditor`, and `test-engineer` concurrently and synthesize their reports. Do not build a "router" persona

100k5d agoDiscuss
addyosmaniAGENTS.md

agent-skills

addyosmani/agent-skills/docs/agents.md

Role | Best for | |---------|------|----------| | [code-reviewer](../agents/code-reviewer.md) | Senior Staff Engineer | Five-axis review before merge | | [security-auditor](../agents/security-auditor.md) | Security Engineer | Vulnerability detection, OWASP-style audit | | [test-engineer](../agents/test-engineer.md) | QA Engineer | Test

100k5d agoDiscuss
nexu-ioAGENTS.md

open-design

nexu-io/open-design/.github/AGENTS.md

burying branching in shell fragments. ## Fork PR approval `fork-pr-workflow-approval.yml` and `scripts/approve-fork-pr-workflows.ts` are a separate security boundary. They may approve low-risk fork PR `pull_request` runs, but must not approve

96k4mo agoDiscuss
AstralAGENTS.md

uv

astral-sh/uv/AGENTS.md

webhook events instead of adding `pull_request_target` workflows - NEVER suppress the `dangerous-triggers` security lint; extend the automation dispatcher in a separate pull request if it does not support

90k2mo agoDiscuss
koala73AGENTS.md

worldmonitor

koala73/worldmonitor/AGENTS.md

solutions](docs/solutions/) when the affected area has a prior fix — organized by category directory (`security-issues/`, `logic-errors/`, `conventions/`, …) with YAML frontmatter (`module`, `component`, `problem_type`, `tags`) to grep

87k17d agoDiscuss
ElasticAGENTS.md

elasticsearch

elastic/elasticsearch/AGENTS.md

jobs expect ephemeral hosts; do not run packaging suites on your workstation. - **Security**: Default dev clusters enable security; use `elastic-admin:elastic-password` or disable with `-Dtests.es.xpack.security.enabled=false`. - **Cursor/Copilot rules

78k5mo agoDiscuss
code-yeongyuAGENTS.md

oh-my-openagent

code-yeongyu/oh-my-openagent/.agents/AGENTS.md

form of the `/publish` command | | `remove-deadcode/` | NEW | Skill form of the `/remove-deadcode` command | | `security-research/` | NEW | Team Mode security research audit: 3 vulnerability hunters + 2 PoC engineers | | `codex

70k10d agoDiscuss

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.