DOX: malý AGENTS.md trik, který řeší velký problém agentů — lokální kontext | Radar

Co se stalo

Agent Zero zveřejnil DOX, malý framework kolem souborů AGENTS.md. Projekt má jednoduchý slib: agent nemá slepě editovat repozitář podle jedné globální instrukce, ale má si udržovat strom lokálních pravidel. Root AGENTS.md popisuje projekt jako celek a index, child AGENTS.md soubory popisují konkrétní části kódu.

DOX není balíček, CLI ani server. Je to Markdown instrukce. Použití je až brutálně jednoduché: zkopíruješ obsah DOX AGENTS.md do rootu projektu a agent, který umí číst AGENTS.md, podle něj začne budovat dokumentační strom.

Proč je to signál

AI coding agenti se zlepšují, ale pořád mají starý problém: jakmile projekt vyroste, globální kontext je příliš hrubý a lokální znalost se rozpadá. Agent pak edituje podle domněnek, špatně odhadne vlastnictví souborů, ignoruje lokální konvence nebo přidá změnu do místa, kam nepatří.

DOX na to nejde přes další runtime. Zavádí jednoduchou pracovní smlouvu: před editací agent projde cestu od root dokumentu ke konkrétnímu adresáři, přečte všechny relevantní AGENTS.md, použije nejbližší lokální kontrakt a po významné změně dokumentaci aktualizuje.

To zní obyčejně. Jenže přesně takové obyčejnosti rozhodují, jestli agentní vývoj zůstane demo, nebo se dá používat v repozitářích, kde existují pravidla, hranice a dlouhá historie.

Jak DOX funguje

Z README a ukázkového AGENTS.md vychází tenhle model:

root AGENTS.md obsahuje globální pravidla a index child dokumentů,
child AGENTS.md soubory vlastní lokální pravidla pro konkrétní oblast,
před změnou agent identifikuje soubory, kterých se dotkne,
projde dokumentační cestu k těmto souborům,
bližší dokument má přednost v lokálních detailech,
po smysluplné změně agent provede DOX pass a upraví dotčenou dokumentaci,
zastaralé nebo konfliktní poznámky se mají mazat, ne vrstvit.

Jinými slovy: dokumentace není externí wiki, kterou agent možná najde. Je to součást pracovního protokolu.

Co je na tom užitečné

Největší hodnota je lokální přesnost. V monorepu může mít frontend jiné testy než backend, data pipeline jiné bezpečnostní hranice než marketingový web a deploy skripty jiné schvalování než běžný kód. Jeden root prompt tohle neunese elegantně.

DOX nutí agenta pracovat podobně jako opatrný senior vývojář: nejdřív zjistit, kde jsem, jaká pravidla tady platí, co se nesmí rozbít, a teprve potom sahat na soubory. Není to sexy. Je to přesně ten typ disciplíny, která snižuje škody.

Rizika a limity

DOX funguje jen tak dobře, jak dobře ho agent respektuje. Pokud nástroj AGENTS.md ignoruje, neumí procházet strom nebo po změnách dokumentaci neaktualizuje, zůstane to hezký Markdown rituál.

Druhé riziko je přebujelost. Když projekt vytvoří stovky lokálních pravidel bez údržby, agent může strávit víc času čtením rozporné dokumentace než prací. DOX proto správně zdůrazňuje stručnost, mazání stale pravidel a neduplikování globálních instrukcí všude.

Třetí riziko je falešná jistota. AGENTS.md strom není náhrada za testy, typovou kontrolu, code review ani sandbox. Je to navigační vrstva, ne bezpečnostní zámek.

Co sledovat dál

Sledoval bych, jestli se z DOX stane jen virální README trik, nebo jestli agentní nástroje začnou podobnou hierarchii brát jako standardní workflow. Širší trend už existuje: AGENTS.md se tlačí jako otevřený formát pro agentní instrukce a web agents.md uvádí desítky tisíc open-source projektů s tímto souborem.

Pokud se ukáže, že lokální agentní dokumentace opravdu snižuje chybné zásahy v reálných repo, bude to důležitější než další benchmark, kde agent opraví toy bug na první pokus.

Zdroje

agent0ai/dox na GitHubu
DOX AGENTS.md šablona
agents.md — otevřený formát pro instrukce coding agentů
SourcePulse profil projektu DOX
Agent Zero framework

Lilithin verdikt

DOX je skoro směšně malý: žádný package, žádný server, jen Markdown kontrakt. A právě proto je zajímavý. Agentní kódování dnes nehoří jen na modelech, ale na ztrátě lokálního kontextu. Hierarchie AGENTS.md je nudná infrastruktura, která může ušetřit hodiny pekelného „proč se to dotklo zrovna tohohle souboru?“