// sopimus
AGENTS.md
Miten Codexin tulisi käyttäytyä tässä repossa.
Codex CLI -käyttäjille
AGENTS.md kertoo Codexille, miten työskennellä.
Ei sitä, mitä siellä on.
AGENTS.md asettaa työsopimuksen. MCP antaa Codexille pääsyn työkaluihin. Maguyva on MCP-palvelin, joka antaa Codexille kysyttävän kartan reposta, joten ensimmäinen muokkaus ei ole arvaus tiedostorakenteesta.
Free-taso: 3 repositoriota, Enintään 50 000 indeksoitua repo-riviä, ei korttia.
AGENTS.md on sopimus. MCP on kanava. Maguyva on kartta.Kerroksittainen pino
Neljä ideaa. Jokainen hoitaa yhden tehtävän.
// siirtotie
MCP
Miten Codex tavoittaa ulkoiset työkalut ja kontekstin.
// koodikanta
Maguyva
MCP-palvelin, joka palauttaa ankkuroituja repofaktoja.
// kuka maksaa
Työtiloja, ei käyttäjäpaikkoja
Agentit eivät maksa käyttäjäpaikoista. Katso hinnoittelu
AGENTS.md on työsopimus. Käytä sitä.
Pysyvät ohjeet kuuluvat tiedostoon AGENTS.md. Se on oikea paikka:
- Build-, testi- ja lint-komennoille, jotka Codexin tulisi ajaa.
- “Tee aina X / älä koskaan tee Y” -kaiteille, jotka on rajattu hakemistoon.
- Nimeämiskonventioille ja refaktorointimieltymyksille.
- Osoittimille kanonisiin päätöslokeihin ja arkkitehtuurimuistiinpanoihin.
Pidä se tiiviinä. Rajaa se. Committaa se.
Mutta AGENTS.md-tiedostoa ei ole koskaan suunniteltu kysyttäväksi indeksiksi jokaisesta symbolista, tiedostosta ja kutsupaikasta repossasi.
Missä pelkkä AGENTS.md muuttuu staattiseksi mittakaavassa
Neljä vikaantumistapaa, yksi per kortti.
// sopimukset eivät ole indeksi
Kertominen Codexille miten työskennellä ei kerro sille, mitä on olemassa. Ensimmäinen muokkaus tuntemattomassa paketissa on arvaus tiedostopoluista ja funktioiden nimistä. AGENTS.md ei voi listata jokaista symbolia, eikä sen pitäisikään.
// dokumentti ajautuu pois koodista
AGENTS.md-lohko, joka kuvaa jonorakennettasi, on oikein, kunnes joku ottaa käyttöön uuden kuluttajan. Koodi on nyt totuuden lähde ja dokumentti on itsevarmasti vanhentunut. Codex lukee väärän.
// nimeäminen on graafiongelma
“Mikä viittaa tähän luokkaan?” ei ole vastattavissa markdown-tiedostosta. Codex joko grep-ja-rukoilee koko monorepon läpi tai pyytää sinua liittämään kutsupaikat chattiin.
// kontekstiikkunat eivät ole ilmaisia
AGENTS.md:n täyttäminen kunnes Codex “tietää tarpeeksi” syö tokeneita, joiden pitäisi maksaa päättelystä. Muutaman kilotavun jälkeen vaihdat vastausten laadun staattiseen kontekstimäärään.
Miten kolme kerrosta sopivat yhteen
Codex-käyttäjät ajattelevat jo tässä muodossa. Sivun pitäisi tehdä siitä ilmeinen.
AGENTS.md
sopimukset
miten Codex käyttäytyy
MCP
kanava
miten se tavoittaa
Maguyva
koodikannan faktat
mitä se näkee
- AGENTS.md miten Codex käyttäytyy tässä repossa.
- MCP miten Codex tavoittaa työkalut ja kontekstin. (spesifikaatio)
- Maguyva mitä Codex näkee, kun se kysyy koodikannalta kysymyksen. Semanttinen, AST-, graafi- ja tekstihaku palautettuna tiedostopolkujen ja rivinumeroiden kera.
AGENTS.md kertoo Codexille miten työskennellä.
Maguyva antaa Codexille jotain, mistä lähteä liikkeelle.
Kolme työnkulkua
Codex-kohtainen. Ankkuroitu oikeaan kutsugraafiin, ei Codexin grepiin.
// workflow 01
Nimeä jaettu luokka uudelleen, löydä ensin jokainen riippuvainen
codex> rename PaymentClient → BillingClient graph::callers(PaymentClient) 12 references across 7 packages graph::importers(src/payments/client.ts) 9 importers graph::extends(PaymentClient) 2 subclasses (RetryClient, MockClient) → Codex proposes a 21-edit migration with the file list inline. [exit 0]
Codex kysyy huollettavien osalta Maguyva ennen kuin se aloittaa muokkaamisen. Siirtymäluettelo perustuu todelliseen kaavioon, ei Codexin muistiin.
// workflow 02
Löydä oikea toteutus, ei testitynkää
codex> how does normalizePhoneNumber handle E.164? semantic::query("normalize phone E.164") src/util/phone.ts:88 normalizePhoneNumber() ← real impl test/util/phone.spec.ts:14 jest.mock(...) ← stub [exit 0]
Nimet valehtelevat. Mockit peittävät oikean koodin. Maguyva järjestää oikean toteutuksen testimockin yläpuolelle.
// workflow 03
Tarkista vaikutusalue ennen refaktorointia
codex> what calls QueueDispatcher.publish? graph::callers(QueueDispatcher.publish) 3 in src/billing/* 1 in src/audit/* 1 in src/notifications/* [exit 0]
Pakettirajat ylittävät kutsupaikat tulevat esiin suoraan. Diffi on ankkuroitu oikeisiin tuojiin, ei Codexin grepiin.
Asennus Codex CLI:ssä
Kolme vaihetta. Free-taso: 3 repositoriota, Enintään 50 000 indeksoitua repo-riviä, ei korttia.
// step 01
Indeksoi repo osoitteessa maguyva.ai
Valitse sellainen, jonka tunnet hyvin, jotta voit tarkistaa vastaukset.
// step 02
Lisää Maguyva MCP-palvelimeksi Codex-konfiguraatioosi
$ 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
Kysy yksi kysymys, jonka vastauksen jo tiedät
Älä aloita koko yrityksestäsi. Aloita yhdestä reposta ja yhdestä todennettavasta kysymyksestä.