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 — rovnaká filozofia.)

Č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 →