// dohoda
AGENTS.md
Jak by se měl Codex chovat v tomhle repozitáři.
Pro uživatele Codex CLI
AGENTS.md říká Codexu, jak má pracovat.
Ne co tam je.
AGENTS.md nastavuje pracovní dohodu. MCP umožňuje Codexu sáhnout po nástrojích. Maguyva je MCP server, který Codexu dává prohledávatelnou mapu tvého repozitáře, takže první edit není odhad struktury souborů.
Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez karty.
AGENTS.md je dohoda. MCP je kanál. Maguyva je mapa.Vrstvená architektura
Čtyři myšlenky. Každá dělá jednu věc.
// transport
MCP
Jak Codex sahá po externích nástrojích a kontextu.
// codebase
Maguyva
MCP server, který vrací podložená fakta o repozitáři.
// kdo platí
Workspaces, ne seats
Agenti neplatí za seats. Zobrazit ceník
AGENTS.md je pracovní dohoda. Používej ji.
Trvalé instrukce patří do AGENTS.md. Je to správné místo pro:
- Build, test a lint příkazy, které má Codex spouštět.
- Pravidla typu „vždy dělej X / nikdy nedělej Y“, omezená na konkrétní adresář.
- Konvence pojmenování a preference pro refaktoring.
- Odkazy na kanonické záznamy rozhodnutí a architektonické poznámky.
Drž to stručné. Ohranič to. Commitni to.
Ale AGENTS.md nikdy nebyl navržený jako prohledávatelný index každého symbolu, souboru a místa volání ve tvém repozitáři.
Kde samotný AGENTS.md ve větším měřítku zůstává statický
Čtyři selhání, jedno na kartu.
// dohody nejsou index
Říct Codexu, jak má pracovat, mu neřekne, co existuje. První edit v neznámém balíčku je odhad cest k souborům a názvů funkcí. AGENTS.md nemůže vypsat každý symbol, a ani bys to nechtěl.
// dokumentace se odchyluje od kódu
Blok v AGENTS.md popisující topologii tvé fronty je správný, dokud někdo nepřidá nového konzumenta. Kód je teď zdrojem pravdy a dokumentace je sebejistě zastaralá. Codex čte tu špatnou.
// přejmenování je grafový problém
„Co odkazuje na tuhle třídu?“ se nedá zjistit z markdown souboru. Codex buď grepuje napříč monorepem a doufá, nebo tě požádá, abys vložil místa volání do chatu.
// kontextová okna nejsou zadarmo
Cpát do AGENTS.md, dokud Codex „neví dost“, žere tokeny, které by měly platit za uvažování. Po pár KB měníš kvalitu odpovědí za statický objem kontextu.
Jak tři vrstvy zapadají do sebe
Uživatelé Codexu už takhle přemýšlí. Stránka by to měla jen zviditelnit.
AGENTS.md
dohody
jak se Codex chová
MCP
kanál
jak sahá po věcech
Maguyva
fakta o codebase
co vidí
- AGENTS.md jak se Codex chová v tomhle repozitáři.
- MCP jak Codex sahá po nástrojích a kontextu. (specifikace)
- Maguyva co Codex vidí, když se codebase na něco zeptá. Sémantické, AST, grafové a textové vyhledávání s cestami k souborům a čísly řádků.
AGENTS.md říká Codexu jak má pracovat.
Maguyva dává Codexu něco, z čeho může vycházet.
Tři workflow
Specifické pro Codex. Podložené skutečným grafem volání, ne grepem Codexu.
// workflow 01
Přejmenuj sdílenou třídu, nejdřív najdi všechny závislé
codex> přejmenuj PaymentClient → BillingClient graph::callers(PaymentClient) 12 odkazů napříč 7 balíčky graph::importers(src/payments/client.ts) 9 importérů graph::extends(PaymentClient) 2 podtřídy (RetryClient, MockClient) → Codex navrhuje migraci o 21 editech se seznamem souborů přímo v textu. [exit 0]
Codex se Maguyva zeptá na závislosti předtím, než začne editovat. Seznam migrace se vrátí podložený skutečným grafem, ne Codexovou vzpomínkou.
// workflow 02
Najdi skutečnou implementaci, ne testovací stub
codex> jak normalizePhoneNumber zachází s E.164? semantic::query("normalize phone E.164") src/util/phone.ts:88 normalizePhoneNumber() ← skutečná impl test/util/phone.spec.ts:14 jest.mock(...) ← stub [exit 0]
Jména lžou. Mocky zastiňují skutečný kód. Maguyva řadí skutečnou implementaci nad testovací mock.
// workflow 03
Zkontroluj dosah dopadu před refaktoringem
codex> co volá QueueDispatcher.publish? graph::callers(QueueDispatcher.publish) 3 in src/billing/* 1 in src/audit/* 1 in src/notifications/* [exit 0]
Místa volání napříč balíčky se objeví přímo v textu. Diff je podložený skutečnými importéry, ne grepem Codexu.
Nastavení v Codex CLI
Tři kroky. Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez karty.
// step 01
Indexuj repozitář na maguyva.ai
Vyber si repozitář, který dobře znáš, abys mohl ověřit odpovědi.
// step 02
Přidej Maguyva jako MCP server do své konfigurace Codexu
$ export MAGUYVA_API_KEY=mgv_xxxx $ codex mcp add maguyva --url https://maguyva.tools/mcp \ --bearer-token-env-var MAGUYVA_API_KEY # equivalent ~/.codex/config.toml [mcp_servers.maguyva] url = "https://maguyva.tools/mcp" bearer_token_env_var = "MAGUYVA_API_KEY"// step 03
Polož jednu otázku, jejíž odpověď už znáš
Nezačínej s celou firmou. Začni jedním repozitářem a jednou ověřitelnou otázkou.