Lekce 5 / 7 · ~10 minut

AGENTS.md:
paměť projektu

Každý úkol začíná s čistou hlavou — agent si nepamatuje, co dělal včera. Řešením je soubor AGENTS.md v adresáři projektu: Codex si ho automaticky přečte před každým úkolem. Je to předávka mezi včerejškem a dneškem.

A má jednu superschopnost navíc: AGENTS.md je otevřený standard — tentýž soubor čte Codex, Cursor a řada dalších AI nástrojů. Napíšeš pravidla jednou a platí pro každého agenta, kterého k projektu pustíš. (Pokud znáš CLAUDE.md z Claude Code, tohle je jeho standardizovaný sourozenec — stejná filozofie.)

Co do něj patří

  • Co projekt je — jedna dvě věty.
  • Jak se spouští a testuje — „otevři index.html", „testy: npm test".
  • Pravidla — jazyk textů, čeho se nedotýkat, styl kódu.
  • Aktuální stav — co je hotové, co rozdělané.

Nepiš ho ručně: příkaz /init ho založí a na konci práce stačí říct „zapiš aktuální stav do AGENTS.md". Agent si vede sešit — ty ho občas zkontroluješ.

Skládačka: co patří do AGENTS.md?

Osm bloků pro fiktivní e-shop s kávou. Klikni na čtyři, které do AGENTS.md patří, a vyhodnoť.

„Projekt: e-shop Zrnko. Statické HTML v adresáři web/, produkty v data/produkty.json."

Patří — co projekt je a kde co leží. První věc, kterou agent u každého úkolu potřebuje.

„Heslo k admin rozhraní: Zrnko2026!"

Nepatří — hesla do AGENTS.md nikdy (lekce 4). Soubor putuje s projektem a čte ho každý nástroj.

„Spuštění: otevři web/index.html. Testy: npm test — spusť je po každé změně."

Patří — přesně tohle agent potřebuje, aby po sobě uměl zkontrolovat práci bez ptaní.

„V pondělí jsme zkoušeli modrou, v úterý zelenou, Katka chtěla béžovou, tak možná béžová…"

Nepatří — deník pokusů zabírá kontext a nepomáhá. Historie patří do gitu; tady drž jen platná rozhodnutí.

„Pravidla: texty česky s diakritikou. Neměň nic v adresáři fotky-original/."

Patří — pravidla a zákazy platí pro každý úkol bez připomínání. A protože AGENTS.md je standard, dodrží je i jiný nástroj.

„Agente, pracuj prosím důkladně, kreativně a mysli jako senior developer."

Nepatří — prázdná zaklínadla nic nezlepšují. Místo v kontextu utrácej za fakta o projektu.

„Stav: katalog a košík hotové. Rozdělané: platební brána — čeká na testovací údaje."

Patří — aktuální stav a rozdělané věci. Další úkol přesně ví, kde pokračovat.

Celý obsah app.js, překopírovaný do AGENTS.md „ať ho agent nemusí hledat".

Nepatří — kód žije v souborech a agent si ho přečte sám. Kopie jen zastarává a zabírá kontext.

Shrnutí

  • AGENTS.md čte Codex před každým úkolem — a rozumí mu i jiné nástroje.
  • Patří do něj: co projekt je, jak se spouští a testuje, pravidla, stav.
  • Nepatří: hesla, deníky, překopírovaný kód, zaklínadla.
  • Založí ho /init; aktualizace deleguj agentovi.
← Předchozí Poslední lekce: Úkol od A do Z →