Lekcia 5 / 7 · ~10 minút

AGENTS.md:
pamäť projektu

Každá úloha začína s čistou hlavou. Agent si nepamätá, čo robil včera. Riešením je súbor AGENTS.md v priečinku projektu: Codex si ho automaticky prečíta pred každou úlohou. Je to odovzdávka medzi včerajškom a dneškom.

A má jednu superschopnosť navyše: AGENTS.md je otvorený štandard: ten istý súbor číta Codex, Cursor a rad ďalších AI nástrojov. Napíšeš pravidlá raz a platia pre každého agenta, ktorého k projektu pustíš. (Ak poznáš CLAUDE.md z Claude Code, toto je jeho štandardizovaný súrodenec s rovnakou filozofiou.)

Čo doň patrí

  • Čo projekt je: jedna-dve vety.
  • Ako sa spúšťa a testuje: „otvor index.html“, „testy: npm test“.
  • Pravidlá: jazyk textov, čoho sa nedotýkať, štýl kódu.
  • Aktuálny stav: čo je hotové, čo rozrobené.

Nepíš ho ručne: príkaz /init ho založí a na konci práce stačí povedať „zapíš aktuálny stav do AGENTS.md“. Agent si vedie zošit, ty ho občas skontroluješ.

Skladačka: čo patrí do AGENTS.md?

Osem blokov pre fiktívny e-shop s kávou. Klikni na štyri, ktoré do AGENTS.md patria, a vyhodnoť.

„Projekt: e-shop Zrnko. Statické HTML v priečinku web/, produkty v data/produkty.json.“

Patrí: čo projekt je a kde čo leží. Prvá vec, ktorú agent pri každej úlohe potrebuje.

„Heslo k admin rozhraniu: Zrnko2026!“

Nepatrí. Heslá do AGENTS.md nikdy (lekcia 4). Súbor putuje s projektom a číta ho každý nástroj.

„Spustenie: otvor web/index.html. Testy: npm test, spusti ich po každej zmene.“

Patrí. Presne toto agent potrebuje, aby po sebe vedel skontrolovať prácu bez pýtania.

„V pondelok sme skúšali modrú, v utorok zelenú, Katka chcela béžovú, tak možno béžová…“

Nepatrí. Denník pokusov zaberá kontext a nepomáha. História patrí do gitu, tu drž len platné rozhodnutia.

„Pravidlá: texty po slovensky s diakritikou. Nemeň nič v priečinku fotky-original/.“

Patrí. Pravidlá a zákazy platia pre každú úlohu bez pripomínania. A keďže AGENTS.md je štandard, dodrží ich aj iný nástroj.

„Agent, pracuj prosím dôkladne, kreatívne a mysli ako senior developer.“

Nepatrí. Prázdne zaklínadlá nič nezlepšujú. Miesto v kontexte míňaj na fakty o projekte.

„Stav: katalóg a košík hotové. Rozrobené: platobná brána, čaká na testovacie údaje.“

Patrí: aktuálny stav a rozrobené veci. Ďalšia úloha presne vie, kde pokračovať.

Celý obsah app.js, prekopírovaný do AGENTS.md „nech ho agent nemusí hľadať“.

Nepatrí. Kód žije v súboroch a agent si ho prečíta sám. Kópia len zastaráva a zaberá kontext.

Zhrnutie

  • AGENTS.md číta Codex pred každou úlohou a rozumejú mu aj iné nástroje.
  • Patrí doň: čo projekt je, ako sa spúšťa a testuje, pravidlá, stav.
  • Nepatria: heslá, denníky, prekopírovaný kód, zaklínadlá.
  • Založí ho /init, aktualizácie deleguj agentovi.
← Predošlá Posledná lekcia: Úloha od A po Z →