Para sa mga user ng Claude Code

Bulag na nagsisimula si Claude sa bawat session.

Sinasabi ng CLAUDE.md kay Claude kung paano kumilos. Hindi nito sinasabi kay Claude kung ano ang laman ng repo mo. Ini-index ng Maguyva ang codebase at ibinabalik ito sa pamamagitan ng MCP, kaya nag-e-edit si Claude na parang nabasa na niya ang code.

Magsimula nang libre Basahin ang setup sa Claude Code

May Free tier: 3 repository, Hanggang 50K na naka-index na linya ng repo, walang card.

Gamitin ang CLAUDE.md para sa behavior. Gamitin ang Maguyva para sa kasalukuyang codebase facts.

Ang CLAUDE.md ay isang best practice. Gamitin ito.

> cat CLAUDE.md
# project conventions, commands, scoped rules

Ang mga persistent na instruction ay nabibilang sa CLAUDE.md. Ito ang tamang lugar para sa:

Build, test, at lint commands na dapat patakbuhin ng agent.
Coding-style rules at naming conventions.
Mga guardrail na “laging gawin ang X / huwag kailanman gawin ang Y” na naka-scope sa isang directory.
Mga pointer sa canonical docs at decision logs.

Malinaw na inilalarawan ito ng memory docs ng Anthropic. Panatilihing maikli. I-scope ito. I-commit ito.

Pero ang CLAUDE.md ay hindi kailanman nilayong maging mapa ng codebase mo.

Kung saan humihinto ang CLAUDE.md na maging sapat

Apat na failure mode na hindi kayang ayusin ng markdown lang.

// hindi ang file ang codebase

Ang pagsasabi kay Claude kung paano kumilos ay hindi nagsasabi sa kanya kung ano ang umiiral. Ang unang edit sa isang hindi pamilyar na repo ay isang hula tungkol sa file paths, function names, at call sites. Hindi kayang ilista ng CLAUDE.md ang bawat symbol, at hindi mo naman gugustuhin iyon.

// lumilipas ang docs, hindi ang code

Tama ang isang CLAUDE.md block na naglalarawan sa auth flow mo hanggang mag-refactor ang isang tao ng auth. Ang code na ngayon ang source of truth at mali na nang tiwala ang docs. Ang mali ang binabasa ni Claude.

// wala sa markdown ang mga dependency

“Ano ang masisira kung babaguhin ko ang function na ito?” ay isang graph question. Hindi ito kayang sagutin ng isang doc file. Mag-grep-and-pray si Claude o hihilingin sa iyong i-paste ang mga file sa chat.

// may budget ang context window

Ang pagpuno sa CLAUDE.md hanggang “sapat na” ang alam ni Claude ay kumakain ng mga token na dapat sana ay para sa reasoning. Lampas sa ilang KB, ipinagpapalit mo ang kalidad ng sagot para sa context volume.

Ang Maguyva ang layer na hindi sinasaklaw ng CLAUDE.md

Isang remote MCP server na nagbibigay sa Claude Code ng:

Semantic, AST, graph, at text search sa naka-index mong repo, ibinabalik na may file paths at line numbers.
Dependency, type, at call-site lookup ang mga tanong na kayang sagutin ng graph pero hindi ng doc file.
Branch-aware na mga resulta para makita ni Claude ang bersyon ng code na talagang ini-edit niya.
Workspace pricing hindi per-seat. Mag-index ng 1 repo o 50; hindi nagbabayad ng seats ang mga agent.

Sinasabi ng CLAUDE.md kay Claude kung paano kumilos.
Binibigyan ng Maguyva si Claude ng queryable na mapa ng code.

Tatlong workflow

Naka-numero, code-block-heavy. Ang mga tanong na tinatanong mo na kay Claude, naka-ground laban sa tunay na linya.

// workflow 01

Hanapin ang tunay na implementation, hindi ang test stub

Ikaw: "Paano gumagana ang retry sa payment client namin?"

Kung Walang Maguyva → Nagge-grep si Claude ng retry, may 14 hit, pipili ng isa (kadalasan test mock).
Kung May Maguyva    → Ibinabalik ng Maguyva ang symbol definition, ang mga call-site, at ang
                   file:line ng tunay na implementation, naka-rank.

// workflow 02

Suriin ang saklaw ng epekto bago ka mag-refactor

Ikaw: "Ano ang tumatawag sa normalizePhoneNumber?"

Ibinabalik ng Maguyva: 7 call-site sa 4 package, kasama ang isa sa isang Python service
na nag-i-import nito sa pamamagitan ng gRPC stub. Iminumungkahi ni Claude ang pagbabago na may migration
list na inline, hindi pagkatapos mag-red ang CI.

// workflow 03

I-verify ang agent bago mo tanggapin ang diff

Claude: "Ini-edit ko ang src/auth/session.ts:142 para ayusin ang token refresh."

Tanungin ang Maguyva: "Ipakita sa akin ang session.ts:130-160 at anumang nag-i-import ng session."

Ibinabalik ng Maguyva ang live file slice + 3 importer. Naka-ground na ngayon ang diff
laban sa tunay na linya, hindi sa alaala ni Claude mula sa token #11,000.

Setup sa Claude Code

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. Sinasaklaw ng Free tier ang 3 repository, Hanggang 50K na naka-index na linya ng repo.

// step 02

I-install ang Maguyva plugin sa Claude Code

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

# the plugin reads your key from the environment
export MAGUYVA_API_KEY=mgv_xxxx

// step 03
Magtanong ng isang tanong na alam mo na ang sagot
Magsimula sa isang repo at isang verifiable na tanong, hindi sa buong kompanya mo. Kung tumutugma ang sagot sa sasabihin mo, handa ka na.