// mga agreement
AGENTS.md
Kung paano dapat kumilos si Codex sa repo na ito.
Para sa mga user ng Codex CLI
Sinasabi ng AGENTS.md kay Codex kung paano magtrabaho.
Hindi kung ano ang nandiyan.
Itinatakda ng AGENTS.md ang working agreement. Hinahayaan ng MCP si Codex na abutin ang mga tool. Ang Maguyva ang MCP server na nagbibigay kay Codex ng queryable na mapa ng repo mo, kaya ang unang edit ay hindi isang hula sa file structure.
May Free tier: 3 repository, Hanggang 50K na naka-index na linya ng repo, walang card.
Ang AGENTS.md ang agreement. Ang MCP ang channel. Ang Maguyva ang mapa.Ang layered stack
Apat na ideya. Isang trabaho ang ginagawa ng bawat isa.
// ang transport
MCP
Kung paano inaabot ni Codex ang mga external tool at context.
// ang codebase
Maguyva
Ang MCP server na nagbabalik ng naka-ground na repo facts.
// sino ang nagbabayad
Workspaces, hindi seats
Hindi nagbabayad ng seats ang mga agent. Tingnan ang pricing
Ang AGENTS.md ay isang working agreement. Gamitin ito.
Ang mga persistent na instruction ay nabibilang sa AGENTS.md. Ito ang tamang lugar para sa:
- Build, test, at lint commands na dapat patakbuhin ni Codex.
- Mga guardrail na “laging gawin ang X / huwag kailanman gawin ang Y” na naka-scope sa isang directory.
- Naming conventions at refactor preferences.
- Mga pointer sa canonical decision logs at architecture notes.
Panatilihing maikli. I-scope ito. I-commit ito.
Pero ang AGENTS.md ay hindi kailanman idinisenyo para maging queryable na index ng bawat symbol, file, at call site sa repo mo.
Kung saan nagiging static ang AGENTS.md mag-isa sa scale
Apat na failure mode, isa kada card.
// hindi index ang mga agreement
Ang pagsasabi kay Codex kung paano magtrabaho ay hindi nagsasabi sa kanya kung ano ang umiiral. Ang unang edit sa isang hindi pamilyar na package ay isang hula tungkol sa file paths at function names. Hindi kayang ilista ng AGENTS.md ang bawat symbol, at hindi mo naman gugustuhin iyon.
// nagd-drift ang doc mula sa code
Tama ang isang AGENTS.md block na naglalarawan sa queue topology mo hanggang may magpakilala ng bagong consumer. Ang code na ngayon ang source of truth at lipas na nang tiwala ang doc. Ang mali ang binabasa ni Codex.
// isang graph problem ang rename
“Ano ang tumutukoy sa class na ito?” ay hindi kayang sagutin ng isang markdown file. Mag-grep-and-pray si Codex sa buong monorepo o hihilingin sa iyong i-paste ang mga call site sa chat.
// hindi libre ang context window
Ang pagpuno sa AGENTS.md hanggang “sapat na” ang alam ni Codex ay kumakain ng mga token na dapat sana ay para sa reasoning. Lampas sa ilang KB, ipinagpapalit mo ang kalidad ng sagot para sa static na context volume.
Paano magkasya ang tatlong layer
Nag-iisip na sa ganitong hugis ang mga user ng Codex. Dapat gawing malinaw ito ng pahina.
AGENTS.md
mga agreement
kung paano kumilos si Codex
MCP
ang channel
kung paano ito umaabot
Maguyva
mga fact ng codebase
kung ano ang nakikita nito
- AGENTS.md kung paano kumikilos si Codex sa repo na ito.
- MCP kung paano inaabot ni Codex ang mga tool at context. (spec)
- Maguyva kung ano ang nakikita ni Codex kapag nagtatanong siya sa codebase. Ibinabalik ang semantic, AST, graph, at text search na may file paths at line numbers.
Sinasabi ng AGENTS.md kay Codex kung paano magtrabaho.
Binibigyan ng Maguyva si Codex ng isang bagay na pagbabatayan.
Tatlong workflow
Codex-specific. Naka-ground laban sa aktwal na call graph, hindi sa grep ni Codex.
// workflow 01
Palitan ang pangalan ng isang shared class, hanapin muna ang bawat dependent
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) → Nagmumungkahi si Codex ng 21-edit na migration na may file list na inline. [exit 0]
Tinatanong ni Codex ang Maguyva tungkol sa mga dependent bago siya magsimulang mag-edit. Bumabalik ang migration list na naka-ground sa aktwal na graph, hindi sa alaala ni Codex.
// workflow 02
Hanapin ang tunay na implementation, hindi ang test stub
codex> paano hinahandle ng normalizePhoneNumber ang 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]
Nagsisinungaling ang mga pangalan. Nagbabalot ang mocks sa tunay na code. Inilalagay ng Maguyva ang tunay na implementation sa itaas ng test mock.
// workflow 03
Suriin ang saklaw ng epekto bago ang isang refactor
codex> ano ang tumatawag sa QueueDispatcher.publish? graph::callers(QueueDispatcher.publish) 3 in src/billing/* 1 in src/audit/* 1 in src/notifications/* [exit 0]
Lumilitaw ang cross-package na call-site nang inline. Naka-ground ang diff laban sa tunay na importer, hindi sa grep ni Codex.
Setup sa Codex CLI
Tatlong hakbang. Free tier: 3 repository, Hanggang 50K na naka-index na linya ng repo, walang card.
// step 01
I-index ang isang repo sa maguyva.ai
Pumili ng isa na kilala mo nang husto, para kaya mong i-verify ang mga sagot.
// step 02
Idagdag ang Maguyva bilang MCP server sa Codex config mo
$ 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
Magtanong ng isang tanong na alam mo na ang sagot
Huwag magsimula sa buong kompanya mo. Magsimula sa isang repo at isang verifiable na tanong.