# Cline काम से पहले योजना बनाता है। उस योजना को एक नक़्शा दें।

Canonical source: https://maguyva.ai/hi/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 फ़ाइलें पढ़ता है, कमांड चलाता है और कुछ भी बदलने से पहले पूछता है। Maguyva पूरा रिपो इंडेक्स करता है और उसे MCP पर वापस देता है, ताकि Plan मोड डायरेक्टरी लिस्टिंग के बजाय असली कॉल साइट्स से शुरू हो।

> काम कैसे करना है, इसके लिए .clinerules। कोड अभी क्या कहता है, इसके लिए Maguyva।

## Cline के बारे में क्या जानना ज़रूरी है

Cline से जुड़े चार तथ्य।

### cline_mcp_settings.json

इसे Cline पैनल के MCP Servers आइकन से खोलें: Configure टैब, फिर Configure MCP Servers। सर्वर `mcpServers` के नीचे जाते हैं।

### रिमोट, URL से

Cline, Maguyva के एंडपॉइंट से Streamable HTTP पर कनेक्ट होता है। कोई लोकल प्रोसेस नहीं, कोई Node.js नहीं।

### सीधा लिखा हेडर

कुंजी सीधे `Authorization` हेडर में जाती है, जैसे Cline के अपने उदाहरणों में। सेटिंग्स फ़ाइल आपके एडिटर के यूज़र स्टोरेज में रहती है, आपके रिपो में नहीं।

### streamableHttp, SSE नहीं

एंट्री में `"type": "streamableHttp"` रहने दें: टाइप के बिना Cline पुराना SSE मान लेता है। जिन टूल्स पर आपको भरोसा है उन्हें `autoApprove` में लिखें, ताकि उनका अप्रूवल प्रॉम्प्ट न आए।

## Cline rules एक वर्किंग एग्रीमेंट हैं। इन्हें इस्तेमाल करें।

```text
# .clinerules/testing.md
- किसी टास्क को पूरा मार्क करने से पहले टेस्ट सूट चलाएं।
- डिपेंडेंसी जोड़ने से पहले पूछें।
```

वर्कस्पेस rules `.clinerules/` या `.cline/rules/` में Markdown फ़ाइलें होती हैं; Cline `AGENTS.md`, `.cursorrules` और `.windsurfrules` भी पढ़ता है। Rules इनके लिए सही जगह हैं:

- वे कमांड जो Cline को चलाने चाहिए।
- frontmatter glob से किसी एक पाथ तक सीमित गार्डरेल।
- टीम के वे कन्वेंशन जिन्हें दोहराते-दोहराते आप थक चुके हैं।

Rules, Cline को बताते हैं कि कैसे बर्ताव करना है। वे यह नहीं बताते कि कौन-सी सर्विसेज़ उस टेबल को पढ़ती हैं जिसे वह मूव करने वाला है।

## जहां rules और फ़ाइल रीड्स कम पड़ते हैं

तीन कमियां जिन्हें Cline एक-एक रिक्वेस्ट में और फ़ाइलें पढ़कर भरता है।

### // लिस्टिंग से बनी योजना

Plan मोड उसी से तर्क करता है जो Cline ने अब तक पढ़ा है। बड़े रिपो में यह एक डायरेक्टरी ट्री और कुछ फ़ाइलें होती हैं, और योजना को वही कमियां विरासत में मिलती हैं।

### // हर रीड एक राउंड ट्रिप है

दिशा समझने के लिए Cline जो भी फ़ाइल खोलता है, उसमें टोकन और एक मॉडल रिक्वेस्ट लगती है। किसी अनजान पैकेज में दिशा समझने में पहली एडिट से पहले ही कॉन्टेक्स्ट विंडो का बड़ा हिस्सा खर्च हो सकता है।

### // टेक्स्ट सर्च स्ट्रिंग ढूंढता है, कॉलर नहीं

“इसे और कौन कॉल करता है?” एक ग्राफ़ सवाल है। टेक्स्ट सर्च स्ट्रिंग ढूंढ लेता है; वह असली कॉलर्स को किसी कमेंट, mock और उसी नाम वाले मेथड से अलग नहीं करता।

## Cline में MCP सर्वर के रूप में Maguyva

एक mcpServers एंट्री Cline को देती है:

- **आपके इंडेक्स किए गए रिपो पर 11 टूल**: सिमेंटिक, स्ट्रक्चरल (AST), ग्राफ़ और टेक्स्ट सर्च, साथ में सिंबल लुकअप, डिपेंडेंट्स और फ़ाइल रिट्रीवल।
- **फ़ाइल पाथ और लाइन नंबर के साथ जवाब**: 285+ भाषाओं में, ताकि योजना असली फ़ाइलों का हवाला दे।
- **सिर्फ़ पढ़ने वाले टूल**: Maguyva के टूल इंडेक्स से क्वेरी करते हैं। इनमें से कोई भी आपकी फ़ाइलें एडिट नहीं करता।

> Cline rules, Cline को बताते हैं *कैसे काम करना है*।
> Maguyva, Cline को *योजना बनाने के लिए नक़्शा* देता है।

## दो वर्कफ़्लो

नक़्शे के आधार पर योजना बनाएं, फिर काम करें।

### 01. असली कॉल साइट्स से बदलाव की योजना बनाएं

```text
cline plan> session refresh को auth पैकेज में ले जाओ

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

→ Act मोड शुरू होने से पहले योजना तीनों कॉल साइट्स सूचीबद्ध करती है।
[exit 0]
```

योजना हर उस फ़ाइल का नाम लेती है जिसे वह छुएगी, ताकि आप अंदाज़े को नहीं, एक सूची को मंज़ूरी दें।

### 02. टेस्ट fixture नहीं, असली इम्प्लीमेंटेशन ढूंढें

```text
cline> हम proration कैसे कैलकुलेट करते हैं?

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← इम्प्लीमेंटेशन
  test/billing/proration.spec.ts:7   ← fixture

→ Cline छह नहीं, एक फ़ाइल पढ़ता है।
[exit 0]
```

रैंक किए गए नतीजे इम्प्लीमेंटेशन को उसी नाम वाले fixture से ऊपर रखते हैं।

## Cline में सेटअप

तीन चरण। Free स्तर: 3 रिपॉज़िटरी, 50K तक इंडेक्स्ड रिपॉज़िटरी लाइनें, क्रेडिट कार्ड की ज़रूरत नहीं।

### 01. maguyva.ai पर एक रिपो इंडेक्स करें

ऐसा रिपो चुनें जिसे आप पहले से जानते हैं, ताकि आप जवाबों को परख सकें।

### 02. Maguyva को Cline की MCP सेटिंग्स में जोड़ें

`cline_mcp_settings.json`

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

### 03. प्लेसहोल्डर बदलें और एक सवाल पूछें

`mgv_xxxx` को अपनी API कुंजी से बदलें और फ़ाइल सेव करें। एक ऐसा सवाल पूछें जिसका जवाब आप पहले से जानते हैं, फिर उद्धृत फ़ाइल खोलें।

Cline के [MCP डॉक्स](https://docs.cline.bot/mcp/mcp-overview) रिमोट सर्वर, टाइमआउट और ऑटो-अप्रूवल के बारे में बताते हैं।

## एक ऐसा रिपो इंडेक्स करें जिसे आप पहले से जानते हैं।

Cline को MCP पर कनेक्ट करें, फिर एक ऐसा सवाल पूछें जिसे आप जांच सकें।
