Wiki · Funkce do hloubky
Kontextové soubory
Soubor s pravidly je nejrychlejší cesta, jak agentovi vysvětlit, jak to u vás chodí — a nejrychlejší cesta, jak si ho zkazit. Prakticky a bez teorie.
📄
Soubor s pravidly je nejrychlejší způsob, jak agentovi vysvětlit, jak u vás věci chodí — a nejrychlejší způsob, jak si ho zkazit.
Agent je čte při každé práci. Krátký a konkrétní soubor funguje; dlouhý se zkrátí a na část pravidel
se nedostane. Rozdíl je i v tom, kam co patří: jak mluvit do jednoho souboru,
jak pracovat v projektu do druhého.
Dva různé soubory, dvě různé věci
| Soubor | K čemu slouží | Kde leží |
|---|---|---|
| SOUL.md | Kdo agent je a jak mluví: tón, stručnost, přímost, čemu se vyhýbat. Platí všude | ~/.hermes/SOUL.md (jen tam, hledá se pouze v domovské složce Hermese) |
| AGENTS.md | Jak se pracuje v tomhle projektu: cesty, příkazy, konvence, co se nesmí | V projektu (kořen gitu a podsložky) |
Jednoduché pravidlo: co má platit všude, patří do SOUL.md; co patří jen jednomu projektu, do AGENTS.md. Když do SOUL.md napíšete porty a cesty konkrétního projektu, budete to za měsíc hledat a mazat.
Které soubory agent zná
| Soubor | Význam |
|---|---|
.hermes.md / HERMES.md | Pokyny k projektu s nejvyšší prioritou |
AGENTS.override.md | Vaše osobní úprava k dané složce — obvykle se nedává do gitu, takže si můžete nastavit jiná pravidla, než jaká jsou ve sdíleném souboru |
AGENTS.md | Pokyny k projektu, konvence, popis architektury |
CLAUDE.md | Soubor z jiného nástroje, který Hermes taky rozpozná |
.cursorrules, .cursor/rules/*.mdc | Pravidla z editoru Cursor — vaše stávající konvence se použijí i tady |
SOUL.md | Osobní nastavení agenta; načítá se vždy a nezávisle na ostatních |
Načte se jen jeden z projektových souborů — první nalezený v pořadí
.hermes.md → AGENTS.override.md → AGENTS.md →
CLAUDE.md → .cursorrules. Když tedy vedle sebe leží AGENTS.md
i CLAUDE.md, použije se AGENTS.md a ten druhý se ignoruje.
SOUL.md se k tomu přidává vždy jako identita agenta — to je ta výjimka.
Kdy se soubory načtou
| Kdy | Co se stane |
|---|---|
| Při spuštění | Hledá se v pracovní složce (a směrem ke kořeni gitu). Obsah se přečte, zkontroluje proti vloženým instrukcím a případně zkrátí |
| Během práce | Když agent sáhne na soubor v podsložce, přidají se pravidla z té složky a až pěti složek nad ní. Pro velké projekty se to hodí: každá část si nese vlastní pravidla |
Díky tomu nemusíte mít jedno obří zadání pro celý projekt. Frontend má svá pravidla, backend svá — a agent je dostane přesně v okamžiku, kdy v té složce začne pracovat.
Limity, o kterých se vyplatí vědět
| Limit | Hodnota |
|---|---|
| Největší délka souboru | Nastavitelná; jinak podle velikosti modelu (nejméně 20 tisíc znaků, nejvýš 500 tisíc) |
| Zkrácení příliš dlouhého souboru | Zachová se začátek (70 %) a konec (20 %), doprostřed se vloží značka s upozorněním |
| Čas na přečtení jednoho souboru | 5 vteřin. Soubor na pomalém disku (iCloud, OneDrive, síťový disk) se může přeskočit s upozorněním |
| Prázdný SOUL.md | Nepřidá se vůbec nic — což je také volba |
# takhle vypadá značka, když byl soubor zkrácen:
[...zkráceno AGENTS.md: ponecháno 14000+4000 z 25000 znaků. Pro celý soubor použij nástroje pro práci se soubory.]
Jak napsat soubor, který funguje
| Zásada | Příklad z praxe |
|---|---|
| Krátce a konkrétně | Deset konkrétních pravidel funguje lépe než pět stran popisu |
| Pište i to, co se nesmí | „Nikdy nepřidávej světlý režim, web je jen tmavý“ — bez toho si agent domýšlí |
| Uveďte příkazy a cesty, které má použít | Agent je pak nemusí hledat a nesplete si je |
| Nadpisy a odrážky | Agent se v souboru líp vyzná a vy v něm taky |
| Aktualizujte, když se projekt změní | Zastaralá pravidla jsou horší než žádná — agent se jimi řídí |
Nejjednodušší začátek: nechte agenta projít projekt a napsat první verzi, kterou si pak upravíte.
❯ Projdi tenhle projekt a navrhni AGENTS.md — jen to podstatné,
co se má dodržovat: jak spouštět testy, kde co leží a co se nemá dělat.
Pasti z našeho provozu
| Co se stalo | Co s tím |
|---|---|
| Dlouhý soubor s pravidly se zkrátil a část zmizela | Přesně proto držíme soubory krátké. Když je pravidlo důležité, ať je mezi prvními |
| Dvě pravidla si odporovala (staré v AGENTS.md, nové v SOUL.md) | Agent se přiklonil k tomu, které čte dřív. Pravidla držte na jednom místě — osobnost do SOUL.md, práci do AGENTS.md |
| Pravidla z podsložky přebila ta hlavní | Počítejte s tím, že se soubory z podsložek přidávají za běhu. Když si odporují, vyhraje konkrétnější (bližší) soubor |
| V projektu byl i CLAUDE.md a pravidla z něj se nepoužila | Načte se jen jeden projektový soubor — ten s vyšší prioritou. Ostatní nechte smazané, nebo je slučte |
| SOUL.md v projektu se ignoroval | Správně: osobnost se bere jen z domovské složky Hermese. Do projektu patří AGENTS.md |
| Soubor z náhodné změny v síťové složce se nepřečetl | Přečtení má strop 5 vteřin. Pravidla držte lokálně, ne na pomalém disku |
| Do souboru s pravidly jsme omylem vložili cizí text (například přepsaný obsah z webu) | Obsah se kontroluje proti vloženým instrukcím, ale spoléhejte na sebe: do souboru s pravidly patří jen to, co jste napsali vy |
Naše tipy
| Tip | Proč |
|---|---|
| Začněte třemi pravidly a přidávejte, až to bolí | Prázdný soubor je lepší než pětistránkový, který se zkrátí |
| Do SOUL.md napište, jak dlouhé odpovědi chcete | Jedna věta ušetří tisíce slov v každé odpovědi |
| Do AGENTS.md patří i „co nedělat“ | Zákazy fungují líp než přání |
| Soubory držte v gitu spolu s projektem | Uvidíte, kdy a proč se pravidlo změnilo |
Osobní úpravy dejte do AGENTS.override.md | Nepřepíšete týmový soubor a vaše změna zůstane jen u vás |