> ## Documentation Index
> Fetch the complete documentation index at: https://docs.claboard.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Planlama Modu

> Adım adım sihirbaz, bağımlılık oluşturma ve canlı ilerleme ile yapay zeka destekli görev parçalama

Planlama Modu, bir konuyu analiz etmek ve otomatik olarak tahtanızda yapılandırılmış, eyleme dönüştürülebilir görevlere ayırmak için Claude'u kullanır. Ne inşa etmek istediğinizi tanımlayın; Claude kod tabanınızı keşfeder, yaklaşımı araştırır ve bağımlılık ilişkilerine sahip eksiksiz bir görev dökümü oluşturur.

<Frame>
  <img src="https://mintcdn.com/bahri/mSTCXqRNL4SZagPF/images/feature-planning.svg?fit=max&auto=format&n=mSTCXqRNL4SZagPF&q=85&s=34652a434bffa873a248bf2b8effb93a" alt="Planning Mode Workflow" width="900" height="320" data-path="images/feature-planning.svg" />
</Frame>

## Adım Adım Sihirbaz

Planlama Modu, üstte görsel bir ilerleme göstergesi ile 4 adımlı bir sihirbaz akışı izler:

```
  Define ──────── Analyze ──────── Review ──────── Complete
```

Her adım numaralı dairelerle gösterilir. Tamamlanan adımlar yeşil bir onay işareti gösterir, aktif adım Claude vurgu rengiyle titreşir ve gelecek adımlar soluk gösterilir.

## Adım 1: Define

Claude'un ne planlamasını istediğinizi yapılandırın:

<Steps>
  <Step title="Topic" icon="pen">
    Ne inşa etmek istediğinizi tanımlayın. Bu ana giriştir — mümkün olduğunca spesifik olun.
  </Step>

  <Step title="Additional Context" icon="circle-info">
    İsteğe bağlı olarak teknoloji yığını, kısıtlamalar veya tercihler gibi ek bağlam bilgisi sağlayabilirsiniz. Varsayılan olarak kapalıdır.
  </Step>

  <Step title="Configuration" icon="sliders">
    Düzenlenmiş ayar kartlarında ayrıntılık, model ve düşünme eforu seçimi yapın.
  </Step>
</Steps>

### Görev Ayrıntılık Düzeyi

Claude'un işi nasıl parçalayacağını kontrol edin:

| Düzey          | Görev Sayısı | Yaklaşım                                                  |
| -------------- | ------------ | --------------------------------------------------------- |
| **High-level** | 3-5          | Alt adım kontrol listeleri içeren büyük kilometre taşları |
| **Balanced**   | 5-10         | İlgili değişiklikleri gruplayan anlamlı birimler          |
| **Detailed**   | 10-20        | Her biri tek oturumda tamamlanabilir atomik görevler      |

### Model Seçimi

| Model      | En Uygun Kullanım                     |
| ---------- | ------------------------------------- |
| **Haiku**  | Basit özelliklerin hızlı parçalanması |
| **Sonnet** | Dengeli hız ve kalite (varsayılan)    |
| **Opus**   | Karmaşık mimari ve derin analiz       |

### Düşünme Eforu

| Düzey      | Davranış                             |
| ---------- | ------------------------------------ |
| **Low**    | Hızlı, yüzeysel analiz               |
| **Medium** | Dengeli derinlik (varsayılan)        |
| **High**   | Derin araştırma ve kapsamlı keşfetme |

## Adım 2: Analyze

Claude kod tabanınızı keşfeder ve görev dökümünü oluşturur. Analiz aşaması gerçek zamanlı ilerleme gösterir:

### Canlı İstatistik Çubuğu

Yatay bir metrik çubuğu şunları gösterir:

* **Geçen süre** — Claude'un ne kadar süredir çalıştığı
* **Token sayısı** — Giriş ve çıkış token kullanımı
* **Araç çağrıları** — Dosya okuma, arama vb. sayısı
* **Turlar** — Claude ile konuşma turları

### Alt Aşama Göstergesi

Analiz, otomatik alt aşamalar boyunca ilerler:

| Alt Aşama      | Tetikleyici                   | Açıklama                                       |
| -------------- | ----------------------------- | ---------------------------------------------- |
| **Starting**   | Süreç başlatıldı              | Claude başlatılıyor                            |
| **Exploring**  | İlk araç çağrısı              | Claude dosyaları okuyor ve kod tabanını arıyor |
| **Planning**   | Keşfin ardından metin çıktısı | Claude analizini yazıyor ve görevler üretiyor  |
| **Finalizing** | Süreç tamamlanıyor            | Claude son çıktıyı biçimliyor                  |

Aşama geçişleri arka planda otomatik olarak algılanır ve gerçek zamanlı olaylar olarak yayınlanır.

### Etkinlik Akışı

Terminal tarzı bir günlük, her araç çağrısını gerçekleştiği anda gösterir:

* Sonuçlarıyla gruplanan **araç çağrıları**
* Araç türüne göre renkle kodlanmış (Read, Write, Edit, Bash, Grep, Glob vb.)
* Dosya yollarını ve çıktı önizlemelerini gösteren genişletilebilir ayrıntılar
* Sonuç bekleyen araçlar için beklemede göstergeleri

### Analiz Önizlemesi

Claude'un akıl yürütme metni, daraltılabilir bir bölümde gerçek zamanlı olarak akar. Claude'un kod tabanı mimariniz hakkındaki bulgularını yazarken izleyin.

## Adım 3: Review

Analiz tamamlandıktan sonra, inceleme aşaması oluşturulan planı sunar:

### Özet Çubuğu

Üstte şunları gösteren hızlı bir genel bakış:

* **Toplam görev sayısı**
* **Tür dökümü** — Her görev türü için renkli rozetler (feature, bugfix, refactor vb.)
* **Bağımlılık sayısı** — Bağımlılık kenarlarının sayısı
* **Geçen süre**

### Görev Kartları

Önerilen her görev, genişletilebilir bir kart olarak gösterilir:

* Numaralı daire içinde **görev numarası**
* **Tür rozeti** — Renkle kodlanmış (feature, bugfix, refactor, docs, test, chore)
* **Öncelik rozeti** — Öncelik belirlendiğinde (Low, Medium, High)
* **Başlık** — Kısa, eyleme dönüştürülebilir açıklama
* **Genişletilebilir ayrıntılar**:
  * **Açıklama** — Ayrıntılı uygulama talimatları
  * **Kabul Kriterleri** — Tamamlanma tanımı

### Önerileri Düzenleme

Onaylamadan önce şunları yapabilirsiniz:

* **Görevleri kaldırma** — İstenmeyen görevleri silmek için çöp kutusu simgesine tıklayın. Bağımlılık dizinleri otomatik olarak ayarlanır.
* **Bağımlılıkları inceleme** — DAG'ı görselleştirmek için Bağımlılık Grafı bölümünü açın

### Bağımlılık Grafı

Claude bağımlılık ilişkileri oluşturduysa, daraltılabilir bir bölüm Orkestrasyon görünümünde kullanılan aynı [Bağımlılık Grafı](/features/dependencies) bileşenini kullanarak tam DAG görsellemesini gösterir.

### Eylemler

* **Revise** — Konunuz korunarak Adım 1'e geri dönün. Konuyu veya ayarları değiştirip yeniden planlayın.
* **Approve & Create N Tasks** — Tüm önerilen görevleri bağımlılık kenarlarıyla birlikte veritabanında oluşturun.

## Adım 4: Complete

Onaydan sonra, görevlerin oluşturulduğunu doğrulayan bir başarı ekranı gösterilir:

* Büyük onay işareti simgesi
* Görev sayısı özeti
* **Plan Again** — Yeni bir planlama oturumu başlatın
* **Done — View Board** — Modalı kapatın ve yeni görevlerinizi tahtada görün

## Arka Plan Mimarisi

### Planlama İstemi

Arka plan, "senior software architect" rolüyle yapılandırılmış bir istem kullanır:

1. **Explore** — Kod tabanı yapısını, giriş noktalarını, konvansiyonları inceleyin
2. **Analyze** — Etkilenen bileşenleri, yeni kod ihtiyaçlarını, riskleri belirleyin
3. **Plan** — JSON görev dökümünü üretin

İstem şunları içerir:

* Görev önceliklendirme yönergeleri (öncelik 0-3)
* Paralel yürütme vurgusu
* Otonom ajan yürütmesi için kendi kendine yeterli açıklama gereksinimleri
* Alan referanslı ayrıntılı JSON format belirtimi

### Aşama Algılama

Arka plan, aşama geçişlerini otomatik olarak algılar ve yayınlar:

```
starting → exploring (first tool_use event)
exploring → writing (text output after 2+ tool calls)
writing → done (process completes)
```

### Görev Ayrıştırma

Çıktı ayrıştırıcı, sağlamlık için 3 stratejili bir yaklaşım kullanır:

1. **Markdown kod blokları** — \`\`\`json bloklarını bulur, tümünü ters sırada dener
2. **Ham JSON algılama** — Metni, ayraç derinliği eşleştirmesi kullanarak `{"tasks":` için tarar
3. **Dizi yedeği** — Düz bir JSON dizisi olarak ayrıştırmayı dener (geriye uyumlu)

## Oturum Kalıcılığı

Planlama oturumları sayfa yenilemelerinde hayatta kalır. Planlama aktifken sayfayı yenilerseniz, pencere otomatik olarak yeniden açılır ve çalışan oturuma yeniden bağlanır.

## Oluşturulan Görevler

Oluşturulan her görev şunları içerir:

* **Title** — Kısa, emir kipi açıklama (80 karakterden kısa)
* **Description** — Dosya yolları ve mantık içeren tam uygulama rehberi
* **Type** — `feature`, `bugfix`, `refactor`, `docs`, `test` veya `chore`
* **Priority** — 0 (en yüksek, temel çalışma) ile 3 (en düşük, ince ayar) arası
* **Acceptance Criteria** — Görevin tamamlandığını kanıtlayan test edilebilir koşul

## Bağımlılık Oluşturma

Planlama Modu, görevler arasında [bağımlılık ilişkileri](/features/dependencies) oluşturur. Claude, B görevinin önce A görevini gerektirdiğini belirlediğinde, bir bağımlılık kenarı oluşturur.

Onaylanan planlar, tüm görevleri DAG yapıları bozulmadan oluşturur:

* Bağımlılığı olmayan görevler **Wave 0**'a düşer ve hemen çalıştırılabilir
* Bağımlı görevler kuyruğa alınır ve üst görevleri tamamlandığında otomatik başlar
* Tam bağımlılık grafını [Orkestrasyon Görünümü](/features/orchestration)'nde görün

<Tip>Claude'un planlamasını yönlendirmek için isteğe bağlı alana bağlam ekleyin. Örneğin: "Express.js backend, React frontend, Prisma ORM ile PostgreSQL" gibi bir açıklama, Claude'un daha uygun görevler oluşturmasına yardımcı olur.</Tip>

## API

Planlama Modu, [Planning API](/api/planning) üzerinden de kullanılabilir.
