Codex CLI a AGENTS.md: pravidla a tipy pro týmy (2026)

Když Codex CLI používá jeden člověk na jednom projektu, stačí dobré zadání. Jakmile ho ale používá celý tým na více repozitářích, začnou se opakovat stejné problémy: agent nespustí testy, použije jiný balíčkovací nástroj, přepíše něco, na co neměl sahat, nebo nedodrží konvence projektu.

Řešením je soubor AGENTS.md — trvalé instrukce, které si Codex načte ještě předtím, než začne pracovat. Pokud s Codexem teprve začínáte, projděte si nejdřív náš návod Codex CLI pro začátečníky.

Co je AGENTS.md

AGENTS.md je obyčejný Markdown soubor s instrukcemi pro AI coding agenty. Doplňuje README: zatímco README je pro lidi, AGENTS.md obsahuje to, co potřebuje agent — příkazy pro build a testy, konvence kódu a pravidla, co se nesmí měnit.

Formát není vázaný jen na Codex. Podporuje ho řada dalších nástrojů a dnes ho spravuje Agentic AI Foundation pod Linux Foundation. Jeden dobře napsaný soubor tak může sloužit více agentům najednou.

Nemá žádná povinná pole — použijte libovolné nadpisy a pište stručně a konkrétně.

Jak Codex instrukce načítá

Podle oficiální dokumentace si Codex při spuštění sestaví řetězec instrukcí v tomto pořadí:

1. Globální úroveň — v domovském adresáři Codexu (standardně ~/.codex) načte AGENTS.override.md, pokud existuje, jinak AGENTS.md.
2. Projektová úroveň — od kořene projektu (obvykle kořen Git repozitáře) postupuje až do aktuálního adresáře a v každém adresáři vezme nejvýše jeden soubor: AGENTS.override.md, jinak AGENTS.md.
3. Spojení — soubory se spojí od kořene dolů. Instrukce blíž aktuálnímu adresáři jsou v promptu později, takže mají přednost.

Prázdné soubory Codex přeskočí a načítání zastaví po dosažení limitu velikosti (standardně 32 KiB, nastavitelné přes project_doc_max_bytes). Explicitní zadání v chatu má vždy přednost před souborem.

Tři úrovně instrukcí v praxi

AGENTS.override.md se hodí na dočasné přepsání pravidel bez mazání původního souboru — po smazání override se vrátí běžné instrukce.

Ukázkový AGENTS.md pro webový projekt

# AGENTS.md

## Projekt
- Next.js aplikace, obsah blogu je v content/blog/*.md (sk, cs, en).
- Texty komponent jsou v messages/*.json – nový klíč vždy doplň do všech jazyků.

## Příkazy
- Instalace: npm ci
- Kontrola: npm run lint
- Build: npm run build (musí projít před dokončením úkolu)

## Pravidla
- Neměň routing, redirecty ani .env bez výslovného zadání.
- Nepřidávej nové závislosti bez potvrzení.
- Dělej co nejmenší diff, bez refaktoringu mimo zadání.

## Výstup
- Na konci shrň změněné soubory a výsledek buildu.

Klíčové je uvádět příkazy, které se dají spustit. Pokud v AGENTS.md uvedete testy nebo build, agent se je pokusí spustit a opravit chyby, než úkol označí za hotový.

Tipy pro týmy

• Udržujte AGENTS.md v Gitu a měňte ho přes pull request stejně jako kód. Je to živá dokumentace.
• Pište pravidla, ne romány. Krátké odrážky fungují lépe než dlouhé odstavce a šetří limit velikosti.
• Zakázané oblasti pojmenujte konkrétně — produkční konfigurace, migrace databáze, platební logika, tajné klíče.
• V monorepu použijte vnořené soubory místo jednoho obřího souboru v kořeni.
• Ověřte, co agent opravdu načetl — například zadáním, ať shrne aktuální instrukce. Pokud jsou instrukce zastaralé, spusťte Codex znovu v cílovém adresáři.
• Nedávejte do AGENTS.md hesla ani API klíče. Soubor je součástí repozitáře a čte ho každý, kdo má k projektu přístup.

Nejčastější chyby

• Prázdný nebo příliš obecný soubor („piš kvalitní kód“), který agentovi nic neřekne.
• Zapomenutý AGENTS.override.md výš ve stromu nebo v ~/.codex, který přebíjí projektová pravidla.
• Příliš dlouhý soubor, jehož konec se kvůli limitu vůbec nenačte.
• Pravidla, která si odporují mezi globální a projektovou úrovní.

Kdy to řešit s partnerem

AGENTS.md je dobrý začátek, ale ve firmě se brzy objeví další otázky: oprávnění agentů, napojení na interní systémy, audit změn a bezpečné nasazení. Pokud chcete AI agenty zavést systematicky, podívejte se na naše zavádění agentic AI.

Shrnutí

• AGENTS.md jsou trvalé instrukce, které Codex načte před každou prací.
• Kombinujte globální, projektovou a vnořenou úroveň; bližší soubor má přednost.
• Uvádějte spustitelné příkazy, konkrétní zákazy a očekávaný výstup.
• Spravujte soubor v Gitu a nedávejte do něj tajné údaje.

Chcete nastavit AI coding agenty pro váš tým bezpečně a s jasnými pravidly? Kontaktujte nás.