Ana içeriğe atla

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, 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.
Planning Mode Workflow

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:

Topic

Ne inşa etmek istediğinizi tanımlayın. Bu ana giriştir — mümkün olduğunca spesifik olun.

Additional Context

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

Configuration

Düzenlenmiş ayar kartlarında ayrıntılık, model ve düşünme eforu seçimi yapın.

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

Claude’un işi nasıl parçalayacağını kontrol edin:
DüzeyGörev SayısıYaklaşım
High-level3-5Alt adım kontrol listeleri içeren büyük kilometre taşları
Balanced5-10İlgili değişiklikleri gruplayan anlamlı birimler
Detailed10-20Her biri tek oturumda tamamlanabilir atomik görevler

Model Seçimi

ModelEn Uygun Kullanım
HaikuBasit özelliklerin hızlı parçalanması
SonnetDengeli hız ve kalite (varsayılan)
OpusKarmaşık mimari ve derin analiz

Düşünme Eforu

DüzeyDavranış
LowHızlı, yüzeysel analiz
MediumDengeli derinlik (varsayılan)
HighDerin 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şamaTetikleyiciAçıklama
StartingSüreç başlatıldıClaude başlatılıyor
Exploringİlk araç çağrısıClaude dosyaları okuyor ve kod tabanını arıyor
PlanningKeşfin ardından metin çıktısıClaude analizini yazıyor ve görevler üretiyor
FinalizingSüreç tamamlanıyorClaude 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ı 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
  • Typefeature, 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 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ü’nde görün
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.

API

Planlama Modu, Planning API üzerinden de kullanılabilir.