🧠AI vývoj7 min čteníAktualizováno: 16. 11. 2026

AGENTS.md a CLAUDE.md: k čemu slouží a co do nich napsat

Soubory AGENTS.md a CLAUDE.md obsahují pokyny pro AI při práci se zdrojovým kódem. Vysvětlíme si v čem se líší, umístění a obsah na konkrétních příkladech.

👨‍💻
Roman
AboutTheApp

Shrnutí a kontext

AGENTS.md a CLAUDE.md jsou soubory s pokyny pro AI asistenty při práci v repozitáři. Popisují, jak projekt spustit a otestovat, jaké konvence dodržovat a na co si dát při úpravách pozor. Pokyny uložené v repozitáři můžete sdílet s týmem a nemusíte je opakovat při každém zadání.

1. Rozdíl mezi AGENTS.md a CLAUDE.md

AGENTS.md je otevřený formát projektových pokynů podporovaný více vývojovými nástroji. CLAUDE.md slouží k zadávání pokynů pro Claude Code. Oba soubory používají Markdown, takže do nich můžete psát běžný text, nadpisy, seznamy a ukázky příkazů.

Pokud používáte více nástrojů, můžete uložit společné pokyny do AGENTS.md a načíst je z CLAUDE.md pomocí řádku `@AGENTS.md`. Podle dokumentace Claude Code podporuje Claude Code od verze 2.1.277 také přímé načítání AGENTS.md. Ve výchozím nastavení ho načítá, pokud v pracovní složce ani v nadřazených složkách nenajde CLAUDE.md, .claude/CLAUDE.md nebo CLAUDE.local.md. Načítání závisí také na nastavení klienta; import umožňuje použít společné pokyny i vedle vlastního CLAUDE.md.

CLAUDE.md
@AGENTS.md

## Pokyny pro Claude Code
Sem doplňte pravidla, která platí pouze pro Claude Code.

2. Co má obsahovat soubor s pokyny

Zapište informace, které asistent potřebuje k úpravám projektu: pracovní adresář pro jednotlivé příkazy, způsob ověření změn a pravidla, která nejsou z kódu zřejmá. Místo obecného „dodržujte styl projektu“ uveďte konkrétní konvenci nebo odkaz na její popis.

Následující tabulka a ukázka popisují příklad projektu s frontendem v TypeScriptu. Příkazy i cesty upravte podle svého repozitáře a ověřte, že fungují.

AGENTS.md
# Pokyny pro práci v repozitáři

## Spuštění
- Příkazy pro frontend spouštěj ve složce frontend.
- Závislosti nainstaluj příkazem npm ci.
- Vývojový server spusť příkazem npm run dev.

## Ověření změn
- Spusť npm run lint a npx tsc --noEmit.
- Pokud některá kontrola selže, uveď chybu v závěrečném popisu změn.

## Konvence
- Sdílené komponenty ukládej do src/components.
- Texty rozhraní doplň do messages/cs.json i messages/en.json.
- Soubory ve složce generated neupravuj ručně.
OblastPříklad konkrétního pokynu
Spuštění projektuVe složce frontend spusť npm ci a npm run dev.
Ověření změnVe složce frontend spusť npm run lint a npx tsc --noEmit.
Struktura projektuSdílené komponenty jsou v src/components, překlady v messages.
KonvenceTexty rozhraní ukládej do překladových souborů.
Generované souboryObsah složky generated neupravuj ručně; použij npm run generate.
Omezení změnDatabázové migrace spouštěj pouze na můj pokyn.

3. Kam soubory umístit

Společné pokyny uložte do kořenové složky repozitáře. Ve větším projektu můžete přidat samostatný AGENTS.md například do složek frontend a backend. V každém souboru uveďte příkazy a konvence příslušné části projektu.

Podle specifikace AGENTS.md mají při rozporu přednost pokyny v souboru, který je blíže upravovanému kódu. Přesný způsob vyhledávání a načítání souborů si ověřte v dokumentaci používaného nástroje. Import `@AGENTS.md` je syntaxe Claude Code; u ostatních nástrojů nepředpokládejte stejnou podporu importů.

Pokyny nenahrazují automatické kontroly

Pravidlo v Markdownu samo nevynutí spuštění testů ani nezabrání nasazení. Povinné kontroly nastavte také v CI, oprávněních nebo konfiguraci příslušného nástroje.

5. Propojení repozitáře s AboutTheApp

Pokud evidujete aplikaci v AboutTheApp, můžete asistenta odkázat na její záznam. Do AGENTS.md přidejte alias aplikace, tedy její jednoznačný identifikátor. Asistent pak může přes MCP (Model Context Protocol, protokol pro propojení AI nástrojů s externími zdroji) vyhledat evidované odkazy, verze a instalace u zákazníků.

V dashboardu otevřete na kartě aplikace panel Integrovat a část AGENTS.md a CLAUDE.md. Zkopírujte připravený text do souboru s pokyny. Následující ukázka používá zástupný alias my-app.

AGENTS.md
## AboutTheApp
This repository is the app `my-app` in AboutTheApp.
- Links (repository, environments, monitoring, documentation), versions, customer installations and components: AboutTheApp MCP server https://aboutthe.app/mcp, product `my-app`.
- Public profile: https://aboutthe.app/my-app

6. Připojení MCP serveru

Samotný zápis adresy serveru do AGENTS.md připojení nenastaví. MCP server AboutTheApp musíte přidat v používaném klientu a přihlásit se svým účtem. V dashboardu najdete konfiguraci v části Účet → AI nástroje (MCP).

Po připojení se můžete zeptat například „Kde najdu logy této aplikace?“ nebo „Jakou verzi používá zákazník v produkčním prostředí?“. Asistent použije alias ze souboru a vyhledá údaje evidované v AboutTheApp. Server poskytuje přístup pouze pro čtení podle oprávnění přihlášeného účtu; aktuálnost odpovědi závisí na aktuálnosti záznamů.

Přihlašovací údaje ukládejte odděleně

Do souborů s pokyny neukládejte hesla, API klíče ani přístupové tokeny. Před zveřejněním souboru zkontrolujte také uvedené adresy a identifikátory. Přístup k soukromým údajům nastavte v klientu pomocí přihlášení.

  1. 1

    Přidejte server do klienta

    Pro Claude Code použijte příkaz níže. Parametr --scope user uloží připojení pro váš uživatelský účet. Konfiguraci pro ostatní klienty najdete v návodu k MCP serveru.

  2. 2

    Dokončete přihlášení

    V Claude Code zadejte /mcp, vyberte abouttheapp a dokončete přihlášení a povolení přístupu v prohlížeči.

claude mcp add --scope user --transport http abouttheapp https://aboutthe.app/mcp

Časté otázky

Jaký je rozdíl mezi AGENTS.md a CLAUDE.md?

AGENTS.md je otevřený formát projektových pokynů podporovaný více nástroji. CLAUDE.md používá Claude Code. Oba soubory jsou v Markdownu; společné pokyny můžete uložit do AGENTS.md a z CLAUDE.md je importovat řádkem @AGENTS.md.

Čte Claude Code soubor AGENTS.md?

Ano, od verze 2.1.277 podporuje jeho přímé načítání. Ve výchozím nastavení ale dává přednost souborům CLAUDE.md, .claude/CLAUDE.md a CLAUDE.local.md v pracovní složce a nadřazených složkách. Podpora závisí také na nastavení klienta. Pokud používáte CLAUDE.md, můžete do něj přidat import @AGENTS.md.

Jak dlouhý má být soubor s pokyny?

Má obsahovat stručné pokyny potřebné pro práci v daném projektu. AGENTS.md nemá předepsanou délku. Podrobné postupy a popisy přesuňte do samostatné dokumentace a ze souboru na ně odkažte.

Může být v repozitáři více souborů AGENTS.md?

Ano. Společná pravidla uložte do kořenové složky a pokyny pro jednotlivé části projektu do příslušných podsložek. Způsob načítání a řešení rozporů ověřte pro konkrétní nástroj.

Patří do AGENTS.md odkazy na dokumentaci, logy a monitoring?

Ano, pokud pomáhají při práci s projektem. U často měněných nebo sdílených údajů je vhodnější odkázat na společnou evidenci, než udržovat kopie v několika repozitářích. Zohledněte také, kdo má k repozitáři přístup.

Stačí pro připojení AboutTheApp uvést adresu MCP serveru v AGENTS.md?

Ne. V souboru uvedete alias aplikace a zdroj údajů, ale MCP server musíte také přidat v klientu a přihlásit se. Asistent pak může číst údaje dostupné vašemu účtu.

Ve zkratce

Začněte příkazy pro spuštění a ověření projektu. Doplňte konkrétní konvence a odkazy na podrobnější dokumentaci. Při změně pracovního postupu upravte i soubor s pokyny.

AboutTheApp

Odkazy a verze aplikace na jednom místě

Evidujte je v AboutTheApp a zpřístupněte je svému AI asistentovi přes MCP server.