DOX daje agentom lokalny kontekst przez AGENTS.md

Agent Zero opublikował DOX, minimalistyczny framework dla hierarchii plików AGENTS.md. Nie dodaje nowego runtime. Wymusza prostą dyscyplinę: agent przed edycją czyta lokalne reguły i aktualizuje je po istotnych zmianach.

DOX wkłada kontekst do katalogów, w których agent pracuje

Agent Zero opisuje DOX jako zestaw instrukcji wokół plików AGENTS.md. Dokument w katalogu głównym opisuje projekt i odsyła do lokalnych dokumentów w konkretnych częściach repozytorium. Agent nie ma działać według jednej globalnej notatki. Ma przejść ścieżkę reguł od korzenia do katalogu, który zaraz zmieni.

DOX nie jest paczką, CLI ani serwerem. Konfiguracja jest celowo prosta: skopiować instrukcje do głównego AGENTS.md i pozwolić agentowi tworzyć albo utrzymywać dokumenty potomne. Właśnie ta prostota jest tu ważna. Kontekst leży obok kodu, którego dotyczy, a nie w zewnętrznej wiki.

Lokalne reguły rozwiązują problem, którego globalny prompt nie uniesie

Coding agents są coraz lepsze, ale duże repozytoria pokazują stary limit. Frontend, backend, pipeline danych i skrypty deployu często mają inne testy, inne granice bezpieczeństwa i inne zasady akceptacji. Jeden prompt w katalogu głównym szybko miesza te różnice w szarą masę.

DOX popycha agenta do zachowania ostrożnego senior engineera: najpierw sprawdź, gdzie jesteś, jakie reguły tu obowiązują i czego nie wolno zepsuć, a dopiero potem zmieniaj pliki. W monorepo z 5 zespołami taka nudna dyscyplina jest cenniejsza niż kolejne efektowne demo.

Markdownowy kontrakt działa tylko wtedy, gdy agent go utrzymuje

Słaby punkt jest taki sam jak przy każdej dokumentacji: może się zestarzeć. Jeśli agent nie aktualizuje reguł po zmianie albo ludzie dokładają sprzeczne notatki, DOX staje się kolejną warstwą szumu. Ten workflow zależy od usuwania starych reguł tak samo jak od dodawania nowych.

Znaczenie ma też wsparcie narzędzi. DOX ma sens wtedy, gdy agent naprawdę czyta AGENTS.md, śledzi ścieżkę do zmienianych plików i potrafi po pracy zrobić dokumentacyjny pass. Bez tego to tylko ładny Markdown w repozytorium.

Prawdziwe repozytoria pokażą, czy stanie się z tego nawyk

Najważniejszym sygnałem nie będzie liczba gwiazdek na GitHubie. Będzie nim to, czy zespoły zaczną pisać lokalne reguły dla agentów tak naturalnie, jak dziś piszą instrukcje testów albo README usługi.

Jeśli DOX się przyjmie, nie będzie wyglądał jak produkt. Będzie małą barierką dla agentic coding: tanią, nudną i najlepiej widoczną wtedy, gdy powstrzyma agenta przed zmianą w złym miejscu.

Werdykt Lilith

DOX wygląda prawie śmiesznie skromnie: tylko markdownowy kontrakt w repozytorium. Właśnie dlatego może działać. Agent, który wie, w którym pokoju stoi, rzadziej tłucze meble.