# Sinasabi ng AGENTS.md kay Codex kung paano magtrabaho. Hindi kung ano ang nandiyan. Canonical source: https://maguyva.ai/fil/for-codex License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license). 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. > 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. ### AGENTS.md Kung paano dapat kumilos si Codex sa repo na ito. ### MCP Kung paano inaabot ni Codex ang mga external tool at context. ### Maguyva Ang MCP server na nagbabalik ng naka-ground na repo facts. ### Workspaces, hindi seats Hindi nagbabayad ng seats ang mga agent. [Tingnan ang pricing](https://maguyva.ai/fil/pricing) ## Ang AGENTS.md ay isang working agreement. Gamitin ito. Ang mga persistent na instruction ay nabibilang sa [`AGENTS.md`](https://developers.openai.com/codex/guides/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 ang doc pero tiwala pa rin ang pagkakasulat nito. 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 nagtutulungan 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)](https://modelcontextprotocol.io/docs/getting-started/intro) - **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 sa aktwal na call graph, hindi sa grep ni Codex. ### 01. Palitan ang pangalan ng isang shared class, hanapin muna ang bawat dependent ```text 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. ### 02. Hanapin ang tunay na implementation, hindi ang test stub ```text 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. Natatabunan ng mocks ang tunay na code. Inilalagay ng Maguyva ang tunay na implementation sa itaas ng test mock. ### 03. Suriin ang saklaw ng epekto bago ang isang refactor ```text 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 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. ### 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. ### 02. Idagdag ang Maguyva bilang MCP server sa Codex config mo `~/.codex/config.toml` ```text export MAGUYVA_API_KEY=mgv_xxxx codex mcp add maguyva --url https://maguyva.tools/mcp --bearer-token-env-var MAGUYVA_API_KEY ``` ```toml [mcp_servers.maguyva] url = "https://maguyva.tools/mcp" bearer_token_env_var = "MAGUYVA_API_KEY" ``` ### 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. ## I-index ang isang repo na kilala mo na. I-connect ang Codex sa pamamagitan ng MCP. Magtanong ng isang tanong na kaya mong i-verify ang sagot.