Lompat ke konten

Untuk pengguna Claude Code

Claude memulai setiap sesi dalam keadaan buta.

CLAUDE.md memberi tahu Claude cara berperilaku. Itu tidak memberi tahu Claude apa yang ada di repo Anda. Maguyva mengindeks codebase-nya dan menyajikannya kembali lewat MCP, jadi Claude mengedit seolah sudah membaca kodenya.

Paket Free: 3 repository, Hingga 50K baris repo terindeks, tanpa kartu.

Pakai CLAUDE.md untuk behavior. Pakai Maguyva untuk fakta codebase yang terkini.

CLAUDE.md adalah praktik terbaik. Pakai itu.

> cat CLAUDE.md
# konvensi proyek, perintah, rules yang dibatasi cakupannya

Instruksi yang bersifat permanen ada di CLAUDE.md. Ini tempat yang tepat untuk:

  • Perintah build, test, dan lint yang harus dijalankan agen.
  • Rules gaya penulisan kode dan konvensi naming.
  • Guardrail “selalu lakukan X / jangan pernah lakukan Y” yang dibatasi ke satu direktori.
  • Rujukan ke dokumentasi kanonis dan log keputusan.

Dokumentasi memory Anthropic menjelaskan ini dengan baik. Buat singkat. Batasi cakupannya. Commit.

Tapi CLAUDE.md memang tidak pernah dimaksudkan jadi peta codebase Anda.

Di mana CLAUDE.md berhenti cukup

Empat mode kegagalan yang tidak bisa diperbaiki cuma dengan markdown.

// filenya bukan codebase-nya

Memberi tahu Claude cara berperilaku tidak memberi tahu apa yang ada. Edit pertama di repo yang belum dikenal adalah tebakan soal path file, nama fungsi, dan call site. CLAUDE.md tidak bisa mendaftar setiap symbol, dan Anda pun tidak akan mau itu terjadi.

// dokumentasi jadi basi, kodenya tidak

Blok CLAUDE.md yang mendeskripsikan alur auth Anda itu benar sampai seseorang me-refactor auth-nya. Kodenya sekarang jadi sumber kebenaran, dan dokumentasinya salah dengan percaya diri. Claude membaca yang salah.

// dependensi tidak ada di markdown

“Apa yang rusak kalau saya ubah fungsi ini?” itu pertanyaan graph. Itu tidak bisa dijawab oleh file dokumentasi. Claude akhirnya grep-lalu-berdoa, atau minta Anda paste file ke chat.

// context window punya budget

Menjejali CLAUDE.md sampai Claude “tahu cukup” menghabiskan token yang seharusnya dipakai untuk reasoning. Melewati beberapa KB, Anda menukar kualitas jawaban dengan volume konteks.

Maguyva adalah lapisan yang tidak dicakup CLAUDE.md

Server MCP remote yang memberi Claude Code:

  • Pencarian semantic, AST, graph, dan text di repo Anda yang terindeks, dikembalikan dengan path file dan nomor baris.
  • Pencarian dependency, type, dan call-site pertanyaan yang bisa dijawab graph, tapi tidak bisa dijawab file dokumentasi.
  • Hasil yang sadar branch jadi Claude melihat versi kode yang sungguh-sungguh sedang ia edit.
  • Harga per workspace bukan per kursi. Indeks 1 repo atau 50; agen tidak bayar kursi.

CLAUDE.md memberi tahu Claude cara berperilaku.

Maguyva memberi Claude peta kode yang bisa di-query.

Tiga workflow

Bernomor, penuh code block. Pertanyaan yang sudah biasa Anda ajukan ke Claude, berlandaskan baris kode yang sesungguhnya.

// workflow 01

Temukan implementasi sesungguhnya, bukan stub test

Anda: "Bagaimana cara kerja retry di payment client kita?"

Tanpa Maguyva → Claude grep retry, menemukan 14 hasil, memilih satu (sering kali mock test).
Dengan Maguyva    → Maguyva mengembalikan definisi symbol, call-site-nya, dan
                   file:line dari implementasi asli, sudah diranking.

// workflow 02

Cek blast radius sebelum Anda refactor

Anda: "Apa yang memanggil normalizePhoneNumber?"

Maguyva mengembalikan: 7 call-site di 4 package, termasuk satu di service Python
yang mengimpornya lewat stub gRPC. Claude mengusulkan perubahan lengkap dengan daftar
migrasinya, bukan setelah CI merah.

// workflow 03

Verifikasi agennya sebelum Anda menerima diff-nya

Claude: "Saya mengedit src/auth/session.ts:142 untuk memperbaiki refresh token."

Tanya Maguyva: "Tunjukkan session.ts:130-160 dan semua yang mengimpor session."

Maguyva mengembalikan potongan file yang live + 3 importer. Diff-nya sekarang berlandaskan
baris kode yang sesungguhnya, bukan ingatan Claude dari token #11.000.

Setup di Claude Code

Tiga langkah. Paket Free: 3 repository, Hingga 50K baris repo terindeks, tanpa kartu.

  1. // step 01

    Indeks repo di maguyva.ai

    Pilih satu yang kamu pahami betul supaya kamu bisa memverifikasi jawabannya. Paket Free mencakup 3 repository, Hingga 50K baris repo terindeks.

  2. // step 02

    Install plugin Maguyva di 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
  3. // step 03

    Ajukan satu pertanyaan yang jawabannya sudah Anda tahu

    Mulai dari satu repo dan satu pertanyaan yang bisa diverifikasi, bukan seluruh perusahaan Anda. Kalau jawabannya cocok dengan apa yang akan Anda katakan, Anda sudah siap.