# Cline merencanakan sebelum bertindak. Beri rencananya sebuah peta.

Canonical source: https://maguyva.ai/id/for-cline

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

Cline membaca berkas, menjalankan perintah, dan bertanya sebelum mengubah apa pun. Maguyva mengindeks seluruh repo dan menyajikannya kembali lewat MCP, jadi Plan mode berangkat dari call site nyata, bukan dari daftar direktori.

> Pakai .clinerules untuk cara bekerja. Pakai Maguyva untuk isi kode saat ini.

## Yang perlu diketahui soal Cline

Empat fakta khusus Cline.

### cline_mcp_settings.json

Buka dari ikon MCP Servers di panel Cline: tab Configure, lalu Configure MCP Servers. Server ditaruh di bawah `mcpServers`.

### Jarak jauh, lewat URL

Cline terhubung ke endpoint Maguyva lewat Streamable HTTP. Tanpa proses lokal, tanpa Node.js.

### Header apa adanya

Kunci langsung masuk ke header `Authorization`, seperti di contoh Cline sendiri. Berkas pengaturannya ada di penyimpanan pengguna editor Anda, bukan di repo Anda.

### streamableHttp, bukan SSE

Pertahankan `"type": "streamableHttp"` di entri: tanpa tipe, Cline menganggapnya SSE lama. Daftarkan alat yang Anda percayai di `autoApprove` untuk melewati prompt persetujuannya.

## Aturan Cline adalah kesepakatan kerja. Pakai itu.

```text
# .clinerules/testing.md
- Jalankan test suite sebelum menandai tugas selesai.
- Tanya dulu sebelum menambah dependensi.
```

Aturan workspace adalah berkas Markdown di `.clinerules/` atau `.cline/rules/`; Cline juga membaca `AGENTS.md`, `.cursorrules`, dan `.windsurfrules`. Aturan adalah tempat yang tepat untuk:

- Perintah yang harus dijalankan Cline.
- Pagar pembatas yang dicakup ke satu path lewat glob di frontmatter.
- Konvensi tim yang sudah bosan Anda ulangi.

Aturan memberi tahu Cline cara berperilaku. Aturan tidak memberi tahu layanan mana saja yang membaca tabel yang akan dipindahkannya.

## Saat aturan dan pembacaan berkas tidak cukup

Tiga celah yang diisi Cline dengan membaca lebih banyak berkas, satu permintaan per kali.

### // rencana dari sebuah daftar

Plan mode bernalar dari apa yang sudah dibaca Cline sejauh ini. Di repo besar itu berarti pohon direktori dan segelintir berkas, dan rencananya mewarisi celah tersebut.

### // setiap pembacaan adalah satu perjalanan bolak-balik

Setiap berkas yang dibuka Cline untuk orientasi menghabiskan token dan satu permintaan model. Orientasi di package yang belum dikenal bisa memakan sebagian besar jendela konteks sebelum edit pertama.

### // pencarian teks menemukan string, bukan pemanggil

“Siapa lagi yang memanggil ini?” adalah pertanyaan graf. Pencarian teks menemukan string-nya; ia tidak memisahkan pemanggil sungguhan dari komentar, mock, dan method bernama sama.

## Maguyva sebagai server MCP di Cline

Satu entri mcpServers memberi Cline:

- **11 alat di atas repo yang terindeks**: pencarian semantik, struktural (AST), graf, dan teks, ditambah pencarian simbol, dependen, dan pengambilan berkas.
- **Jawaban dengan jalur berkas dan nomor baris**: di 285+ bahasa, jadi rencana mengutip berkas nyata.
- **Alat yang hanya membaca**: Alat Maguyva menanyai index. Tidak satu pun mengedit berkas Anda.

> Aturan Cline memberi tahu Cline *cara bekerja*.
> Maguyva memberi Cline *peta untuk menyusun rencana*.

## Dua alur kerja

Rencanakan berdasarkan peta, lalu bertindak.

### 01. Rencanakan perubahan dari call site nyata

```text
cline plan> pindahkan session refresh ke package auth

dependency_search("refreshSession", dependents)
  src/api/middleware.ts:58
  src/jobs/renew.ts:12
  src/web/hooks/useSession.ts:30

→ Rencana mendaftar tiga call site sebelum Act mode dimulai.
[exit 0]
```

Rencana menyebut setiap berkas yang akan disentuhnya, jadi yang Anda setujui adalah daftar, bukan firasat.

### 02. Temukan implementasi sungguhan, bukan test fixture

```text
cline> bagaimana kita menghitung proration?

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← implementasi
  test/billing/proration.spec.ts:7   ← fixture

→ Cline membaca satu berkas, bukan enam.
[exit 0]
```

Hasil berperingkat menaruh implementasi di atas fixture yang bernama sama.

## Setup di Cline

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

### 01. Indeks repo di maguyva.ai

Pilih yang sudah Anda kenal, agar Anda dapat menilai jawabannya.

### 02. Tambahkan Maguyva ke setting MCP Cline

`cline_mcp_settings.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

### 03. Ganti placeholder dan ajukan satu pertanyaan

Ganti `mgv_xxxx` dengan kunci API Anda lalu simpan berkasnya. Ajukan satu pertanyaan yang jawabannya sudah Anda ketahui, lalu buka berkas yang dikutip.

[Dokumentasi MCP](https://docs.cline.bot/mcp/mcp-overview) Cline membahas server jarak jauh, timeout, dan persetujuan otomatis.

## Indeks satu repo yang sudah Anda kenal.

Hubungkan Cline lewat MCP, lalu ajukan satu pertanyaan yang bisa Anda periksa.