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 se stejnou filozofií.)

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 →