# Cline merancang sebelum bertindak. Beri rancangan itu sebuah peta.

Canonical source: https://maguyva.ai/ms/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 fail, menjalankan arahan dan bertanya sebelum mengubah apa-apa. Maguyva mengindeks seluruh repo dan menyajikannya semula melalui MCP, jadi Plan mode bermula daripada tapak panggilan sebenar, bukan senarai direktori.

> Guna .clinerules untuk cara bekerja. Guna Maguyva untuk apa yang kod katakan sekarang.

## Apa yang perlu diketahui tentang Cline

Empat fakta khusus untuk Cline.

### cline_mcp_settings.json

Buka daripada ikon MCP Servers dalam panel Cline: tab Configure, kemudian Configure MCP Servers. Pelayan diletakkan di bawah `mcpServers`.

### Jauh, melalui URL

Cline bersambung ke titik akhir Maguyva melalui Streamable HTTP. Tiada proses setempat, tiada Node.js.

### Pengepala literal

Kunci terus masuk ke pengepala `Authorization`, seperti dalam contoh Cline sendiri. Fail tetapan berada dalam storan pengguna editor anda, bukan dalam repo anda.

### streamableHttp, bukan SSE

Kekalkan `"type": "streamableHttp"` dalam entri: tanpa jenis, Cline menganggapnya SSE lama. Senaraikan alat yang anda percayai dalam `autoApprove` untuk melangkau gesaan kelulusannya.

## Peraturan Cline ialah persetujuan kerja. Gunakannya.

```text
# .clinerules/testing.md
- Jalankan suite ujian sebelum menandakan tugas selesai.
- Tanya dahulu sebelum menambah kebergantungan.
```

Peraturan ruang kerja ialah fail Markdown dalam `.clinerules/` atau `.cline/rules/`; Cline juga membaca `AGENTS.md`, `.cursorrules` dan `.windsurfrules`. Peraturan ialah tempat yang sesuai untuk:

- Arahan yang perlu dijalankan oleh Cline.
- Pagar keselamatan yang dihadkan pada satu laluan melalui glob dalam frontmatter.
- Konvensyen pasukan yang anda sudah jemu ulang.

Peraturan memberitahu Cline cara berkelakuan. Ia tidak memberitahu perkhidmatan mana yang membaca jadual yang hendak dipindahkannya.

## Apabila peraturan dan bacaan fail tidak mencukupi

Tiga jurang yang Cline isi dengan membaca lebih banyak fail, satu permintaan pada satu masa.

### // rancangan dibina daripada senarai

Plan mode menaakul daripada apa yang Cline sudah baca setakat ini. Pada repo besar, itu ialah pepohon direktori dan beberapa fail, dan rancangan mewarisi jurang tersebut.

### // setiap bacaan ialah satu perjalanan pergi balik

Setiap fail yang dibuka Cline untuk orientasi menggunakan token dan satu permintaan model. Orientasi dalam pakej yang tidak biasa boleh menghabiskan sebahagian besar tetingkap konteks sebelum suntingan pertama.

### // carian teks menemui rentetan, bukan pemanggil

“Siapa lagi yang memanggil ini?” ialah soalan graf. Carian teks menemui rentetan itu; ia tidak memisahkan pemanggil sebenar daripada komen, mock dan kaedah bernama sama.

## Maguyva sebagai pelayan MCP dalam Cline

Satu entri mcpServers memberi Cline:

- **11 alat merentasi repo anda yang diindeks**: carian semantik, struktur (AST), graf dan teks, ditambah carian simbol, dependen dan pengambilan fail.
- **Jawapan dengan laluan fail dan nombor baris**: merentasi 285+ bahasa, jadi rancangan merujuk fail sebenar.
- **Alat yang hanya membaca**: Alat Maguyva menyoal indeks. Tiada satu pun yang menyunting fail anda.

> Peraturan Cline memberitahu Cline *cara bekerja*.
> Maguyva memberi Cline *peta untuk merancang*.

## Dua aliran kerja

Rancang berpandukan peta, kemudian bertindak.

### 01. Rancang perubahan daripada tapak panggilan sebenar

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

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

→ Rancangan menyenaraikan tiga tapak panggilan sebelum Act mode bermula.
[exit 0]
```

Rancangan menamakan setiap fail yang akan disentuhnya, jadi anda meluluskan senarai, bukan firasat.

### 02. Cari pelaksanaan sebenar, bukan fixture ujian

```text
cline> bagaimana kita mengira proration?

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

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

Keputusan tersusun meletakkan pelaksanaan di atas fixture yang berkongsi namanya.

## Sediakan Cline

Tiga langkah. Peringkat Free: 3 repositori, Sehingga 50K baris repo terindeks, tanpa kad.

### 01. Indeks repo di maguyva.ai

Pilih satu yang anda sudah kenali, supaya anda boleh menilai jawapannya.

### 02. Tambah Maguyva pada tetapan 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 pemegang tempat dan tanya satu soalan

Tukar `mgv_xxxx` kepada kunci API anda dan simpan fail. Tanya satu soalan yang anda sudah tahu jawapannya, kemudian buka fail yang disebut.

[Dokumentasi MCP](https://docs.cline.bot/mcp/mcp-overview) Cline merangkumi pelayan jauh, had masa dan kelulusan automatik.

## Indeks satu repo yang anda sudah kenali.

Sambung Cline melalui MCP, kemudian tanya satu soalan yang boleh anda semak.