# Bulag na nagsisimula si Claude sa bawat session.

Canonical source: https://maguyva.ai/fil/for-claude-code

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).

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.

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

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

```text
> 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](https://code.claude.com/docs/en/memory) 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 ang docs pero tiwala pa rin ang pagkakasulat ng mga ito. 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 sa tunay na linya.

### 01. Hanapin ang tunay na implementation, hindi ang test stub

```text
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.
```

### 02. Suriin ang saklaw ng epekto bago ka mag-refactor

```text
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.
```

### 03. I-verify ang agent bago mo tanggapin ang diff

```text
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
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.

### 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.

### 02. I-install ang Maguyva plugin sa Claude Code

```text
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva

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

### 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.

Nasa [docs ng Maguyva](https://maguyva.ai/fil/docs) ang buong instructions.

## I-index ang isang repo na kilala mo na.

Subukan ang isang tanong na kaya mong i-verify ang sagot. Iyon na ang buong onboarding.