AGENTS.md
AGENTS.md je otevřený formát textového souboru v repozitáři kódu. Programovací AI agenti z něj zjistí, jak projekt sestavit, otestovat a jaká pravidla v kódu platí.
AGENTS.md je obyčejný textový soubor ve formátu Markdown (jednoduchý zápis textu s nadpisy a odrážkami), který leží v repozitáři, tedy v úložišti zdrojového kódu projektu. Čtou ho programovací AI agenti: nástroje jako OpenAI Codex, Cursor, GitHub Copilot, Gemini CLI nebo Claude Code, které samy píšou a upravují kód. Autoři formátu ho přirovnávají k README (úvodnímu souboru s popisem projektu), jen psanému pro agenty. Agent v něm najde, jak projekt sestavit, jak spustit testy a jaká pravidla v kódu platí.
Odkud AGENTS.md pochází
Formát zveřejnila OpenAI v srpnu 2025 a na jeho podobě se podílely i týmy nástrojů Amp, Jules od Googlu, Cursor a Factory. Od prosince 2025 ho spravuje Agentic AI Foundation, nadace pod Linux Foundation, kam OpenAI formát předala spolu s Anthropicem a jeho protokolem MCP. Podle Linux Foundation ho tehdy používalo přes 60 000 open source projektů (projektů s veřejně dostupným kódem) a agentních nástrojů.
Podporují ho mimo jiné Codex, Cursor, GitHub Copilot, Gemini CLI, Jules a Devin. Claude Code, který používá vlastní soubor CLAUDE.md, umí v aktuálních verzích načíst i AGENTS.md, pokud CLAUDE.md v projektu chybí.
Co do AGENTS.md patří
Formát nemá povinná pole ani pevnou strukturu. Typicky obsahuje:
- příkazy pro instalaci, sestavení a spuštění testů,
- pravidla psaní kódu, například styl a pojmenování,
- jak popisovat změny před odesláním ke kontrole,
- bezpečnostní pravidla a části projektu, na které agent nemá sahat.
Velké projekty mohou mít víc souborů v podsložkách. Agent se řídí tím, který je nejblíž upravovanému souboru. Pokyn, který mu člověk zadá přímo v chatu, má přednost před souborem.
Pomáhá AGENTS.md agentům?
Přínos je menší, než se často tvrdí. Tým ETH Curych a firmy LogicStar.ai v únoru 2026 zveřejnil studii (aktualizovanou v září 2026). Soubory vygenerované jazykovým modelem podle ní úspěšnost agentů nezlepšily (v průměru byla o 0,5 až 2 % nižší, rozdíl ale nebyl statisticky průkazný) a náklady na provoz zvýšily o 20 až 23 %. Soubory napsané vývojáři zvedly úspěšnost v průměru o 2,4 %, ani to ale nebylo statisticky průkazné. Autoři doporučují psát do souboru jen to, co agent nenajde jinde, třeba v README.
Jiná studie na 124 změnách v 10 repozitářích zjistila, že s AGENTS.md agenti pracovali rychleji (medián času o 28,64 % kratší) a vygenerovali o 16,58 % méně tokenů (jednotek textu, za které se u modelů platí). Úkoly přitom dokončovali srovnatelně. Prakticky: soubor má smysl krátký, napsaný člověkem a jen o tom, co je v projektu nestandardní. Pro tyto dva přístupy se objevují zatím neustálené názvy behavior steering a capability injection.
AGENTS.md a viditelnost webu v AI
Nejčastější omyl je považovat AGENTS.md za další soubor do kořene webu, vedle robots.txt a llms.txt. Standard pro to nevznikl. Žádná AI firma neuvádí, že by její vyhledávací roboti (ChatGPT, Perplexity, Google AI Overviews) AGENTS.md na webech četli. Na to, jestli vás AI asistent najde a ocituje, proto prokazatelný vliv nemá.
Výjimkou je Shopify. Generuje každému obchodu veřejnou stránku /agents.md určenou nákupním agentům a adresy /llms.txt a /llms-full.txt ve výchozím stavu zobrazují stejný obsah. Jde o vlastní řešení Shopify, které si od formátu půjčilo jméno. Shopify ho sám odlišuje od AGENTS.md pro programovací agenty, který leží ve zdrojovém kódu šablony a na webu se nezobrazuje. Veřejná data o tom, že nákupní agenti tuto stránku skutečně čtou, jsme zatím nenašli.
Rozdíl tří souborů:
- robots.txt říká robotům, kam na webu smějí. Je to standard a vyhledávače i velké AI firmy ho u svých hlavních robotů dodržují.
- llms.txt je návrh přehledu nejdůležitějšího obsahu webu pro jazykové modely. Standardem zatím není.
- AGENTS.md je návod pro AI agenty, kteří pracují s kódem.
Pozor také na bezpečnost. Agent se pokyny ze souboru řídí, takže podvržený AGENTS.md může agenta navést ke škodlivé akci. Riziko popisuje heslo Stored Prompt Injection.
Časté otázky
Kvůli viditelnosti v AI ne. OpenAI, Perplexity ani Google neuvádějí, že by ho jejich vyhledávání na webech četlo. Smysl má v repozitáři, pokud váš web nebo aplikaci vyvíjíte s pomocí programovacích AI agentů. Pokud provozujete obchod na Shopify, stránku /agents.md vám Shopify vytvoří sám.
Není. llms.txt je návrh souboru na webu, který jazykovým modelům podává přehled obsahu. AGENTS.md je návod pro programovací agenty uložený v kódu projektu. Splývat začaly jen na Shopify, kde obě adresy ve výchozím stavu zobrazují stejný obsah.
Raději ne. Podle studie ETH Curych soubory vygenerované jazykovým modelem agentům nepomohly a provoz prodražily o víc než 20 %. Lépe funguje krátký soubor, který napíše vývojář a uvede v něm jen to, co agent sám z projektu nevyčte.
Chcete vědět, co o vás AI skutečně čte?
O viditelnosti v AI rozhoduje hlavně to, jestli vás roboti smějí přečíst a jestli na webu najdou jasná a ověřitelná fakta. Na auditu zdarma zjistíme, jestli vás ChatGPT, Claude a Perplexity znají a doporučují, a do 48 hodin dostanete doporučení, co udělat jako první.
Související pojmy
robots.txt
robots.txt je textový soubor v kořeni webu, který robotům vyhledávačů a AI říká, kam smějí. Řídí procházení, ne indexaci, a slušní roboti ho dodržují dobrovolně.
llms.txt
llms.txt je návrh textového souboru na adrese /llms.txt, který jazykovým modelům a AI agentům podává stručný přehled webu s odkazy. Standardem zatím není.
AI Agent
AI agent je systém postavený na jazykovém modelu, který dostane cíl a sám ve smyčce plánuje kroky, používá nástroje a kontroluje výsledek. Míra jeho samostatnosti se liší.
Stored Prompt Injection (SPI)
Stored prompt injection je útok, při kterém se škodlivý pokyn pro AI uloží do paměti, souboru s instrukcemi nebo dat a působí i v dalších konverzacích.
Behavior steering
Behavior steering je neustálený název pro pokyny v AGENTS.md, které programovacímu AI agentovi jen popíšou, co je v projektu jinak než obvykle, místo aby ho učily nové věci.
Capability injection
Capability injection je neustálený název pro snahu „naučit“ AI agenta přes AGENTS.md nové znalosti, místo aby mu soubor popsal jen to, co je v projektu jinak.
Newsletter
Novinky z SEO a AI vyhledávání do e-mailu
Jednou měsíčně vybereme to nejdůležitější a k tomu krátce, co to znamená pro váš web. Kdo chce víc, může dostávat každý týden celé zpravodajství.