// soubor není codebase
Říct Claude, jak se má chovat, mu neřekne, co existuje. První edit v neznámém repozitáři je odhad cest k souborům, názvů funkcí a míst volání. CLAUDE.md nemůže vypsat každý symbol, a ani byste to nechtěli.
Pro uživatele Claude Code
Claude začíná každou session naslepo.
CLAUDE.md říká Claude, jak se má chovat. Neříká Claude, co je ve vašem repozitáři. Maguyva indexuje codebase a vrací ji přes MCP, takže Claude edituje, jako by už kód přečetl.
Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez kreditní karty.
CLAUDE.md používejte pro chování. Maguyva používejte pro aktuální fakta o codebase.CLAUDE.md je osvědčený postup. Používejte ho.
> cat CLAUDE.md
# konvence projektu, příkazy, pravidla s vymezenou působnostíTrvalé instrukce patří do CLAUDE.md. Je to správné místo pro:
- Build, test a lint příkazy, které má agent spouštět.
- Pravidla stylu kódu a konvence pojmenování.
- Pravidla typu „vždy dělej X / nikdy nedělej Y“, omezená na konkrétní adresář.
- Odkazy na kanonickou dokumentaci a záznamy rozhodnutí.
Anthropic to dobře popisuje ve svých dokumentech o paměti. Držte to stručné. Ohraničte to. Commitněte to.
Ale CLAUDE.md nikdy neměl být mapou vaší codebase.
Kde CLAUDE.md přestává stačit
Čtyři selhání, která samotný markdown nevyřeší.
// dokumentace zastarává, kód ne
Blok v CLAUDE.md popisující váš auth flow je správný, dokud někdo auth nerefaktoruje. Kód je teď zdrojem pravdy a dokumentace je sebejistě špatná. Claude čte tu špatnou.
// závislosti nejsou v markdownu
„Co se rozbije, když změním tuhle funkci?“ je grafová otázka. Nedá se zodpovědět dokumentem. Claude buď grepuje a doufá, nebo vás požádá, abyste vložili soubory do chatu.
// kontextová okna mají rozpočet
Přidávat obsah do CLAUDE.md, dokud Claude „neví dost“, žere tokeny, které by měly platit za uvažování. Po pár KB měníte kvalitu odpovědí za objem kontextu.
Maguyva je vrstva, kterou CLAUDE.md nepokrývá
Vzdálený MCP server, který dává Claude Code:
- Sémantické, AST, grafové a textové vyhledávání nad vaším indexovaným repozitářem, vrácené s cestami k souborům a čísly řádků.
- Vyhledávání závislostí, typů a míst volání otázky, na které odpoví graf, a dokument ne.
- Výsledky, které zohledňují větev aby Claude viděl tu verzi kódu, kterou skutečně edituje.
- Ceny podle pracovního prostoru ne podle počtu uživatelů. Indexujte 1 repozitář nebo 50; za agenty se neúčtují samostatné licenční poplatky.
CLAUDE.md říká Claude, jak se má chovat.
Maguyva dává Claude prohledávatelnou mapu kódu.
Tři workflow
Číslované, plné bloků kódu. Otázky, které Claude už kladete, podložené skutečnými řádky.
// workflow 01
Najděte skutečnou implementaci, ne testovací stub
Vy: "Jak funguje retry v našem payment klientovi?"
Bez Maguyva → Claude grepuje retry, najde 14 zásahů, vybere jeden (často testovací mock).
S Maguyva → Maguyva vrátí definici symbolu, místa volání a
file:line skutečné implementace, seřazené. // workflow 02
Zkontrolujte rozsah dopadu, než refaktorujete
Vy: "Co volá normalizePhoneNumber?"
Maguyva vrátí: 7 míst volání napříč 4 balíčky, včetně jednoho v Python službě,
která ho importuje přes gRPC stub. Claude navrhne změnu se seznamem migrace
přímo v textu, ne až po tom, co CI zčervená. // workflow 03
Ověřte agenta, než přijmete diff
Claude: "Upravil jsemsrc/auth/session.ts:142, abych opravil obnovu tokenu." Zeptejte se Maguyva: "Ukaž misession.ts:130-160a všechno, co importuje session." Maguyva vrátí živý výřez souboru + 3 importéry. Diff je teď podložený skutečnými řádky, ne Claudovou vzpomínkou od tokenu #11 000.
Nastavení v Claude Code
Tři kroky. Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez kreditní karty.
-
// step 01
Indexujte repozitář na maguyva.ai
Vyberte si repozitář, který dobře znáte, abyste mohli ověřit odpovědi. Free tarif pokrývá 3 repozitáře, Až 50K zaindexovaných řádků repa.
-
// step 02
Nainstalujte plugin Maguyva v Claude Code
/plugin marketplace add maguyva/agent-plugins /plugin install maguyva@maguyva # the plugin reads your key from the environment export MAGUYVA_API_KEY=mgv_xxxx -
// step 03
Položte jednu otázku, jejíž odpověď už znáte
Začněte jedním repozitářem a jednou ověřitelnou otázkou, ne celou firmou. Pokud odpověď sedí s tím, co byste řekli vy, máte vyhráno.