Skip to main content
Yol Haritası görünümü, bir projenin kilometre taşlarına ve fazlarına kuş bakışı bir perspektif sağlar. Projede .planning/ dizini varsa GSD spec-driven geliştirme çerçevesine köprü kurar.
Yol Haritası görünümü

​
Yol Haritasını açma

Herhangi bir projeyi aç, üst görünüm sekmelerinden Roadmap’e tıkla. Görünüm, üç yığın bölümden oluşur:
  1. Proje Özeti — .planning/PROJECT.md özeti ve güncel durum (GSD başlatılmışsa)
  2. .planning/ Roadmap — GSD dosya tabanlı yol haritası, faz başına aksiyonlarla
  3. Milestones — klasik DB tabanlı kilometre taşları ve fazlar; GSD’den bağımsız
Projede .planning/ dizini yoksa yalnızca Milestones bölümü görünür.

​
Proje Özeti paneli

.planning/PROJECT.md mevcutsa, Yol Haritası’nın en üstünde daraltılabilir bir kart çıkar:
  • Başlık: proje adı (PROJECT.md’nin H1’i) + kısa özet satırı + STATE.md’deki current_phase rozeti
  • Genişletilmiş: STATE.md’den mevcut faz / adım + tam PROJECT.md ve STATE.md içerikleri
Roadmap sekmesinden ayrılmadan projenin ne olduğunu ve GSD akışının şu an nerede olduğunu hatırlamak için kullan.

​
Yapılandırılmış faz açıklaması

ROADMAP.md içindeki faz açıklamaları genelde şu kalıba uyar:
Görünüm bunu ham markdown olarak dökmek yerine parse eder ve ikonlu, rozeti, chip’li bölümlere ayırır: Açıklamanın herhangi bir yerindeki markdown tabloları artık zebra satırlı ve ilk sütunu vurgulanmış gerçek HTML tabloları olarak render edilir — ham | --- | satırları yok.

​
Faz aksiyonları

Her faz satırı, durumuna göre bir state-machine aksiyon butonu gösterir:

pending / planning (henüz PLAN.md yok)

Plan Phase — fazın nasıl uygulanacağını araştıran ve .planning/phases/phase-N/ altına PLAN.md dosyaları yazan bir Claude ajanını başlatır. İlerleme yerinde akar.

PLAN.md var (henüz görev yok)

Generate Tasks — PLAN.md dosyalarını parse edip wave tabanlı bağımlılıklarla pano görevleri oluşturur. Kuyruk anında alır.

completed

Verify — başarı kriterlerine göre uygulamayı yeniden kontrol eden /gsd:verify-work görevi oluşturur.

failed

Retry — mevcut PLAN.md dosyalarından görev üretimini tekrar çalıştırır.

​
Parse edilmiş görevleri önizle

Generate Tasks’a basmadan önce fazı genişlet ve Preview parsed tasks’a tıkla. Görünüm, hiç görev oluşturmadan PLAN.md’den parse edilen görev listesini çeker ve şunları gösterir:
  • Görevler wave’lere göre gruplanmış (wave N, wave N-1’den sonra çalışır)
  • Her görev için: tür rozeti · ad · plan dosyası · dokunulan dosyalar · done kriteri
Listeyi incele; doğru görünüyorsa önizleme içindeki Generate N tasks ile oluştur. Planları önce düzenlemek istersen × ile önizlemeyi kapatabilirsin.

​
.planning/ roadmap başlığı

Fazların üstünde .planning/ Roadmap kartının başlığı şunları gösterir:
  • Genel ilerleme çubuğu (completed / in-progress / failed / pending)
  • Mevcut faz + mevcut adım (STATE.md’den)
  • Dosyaları diskten yeniden okumak için yenile butonu
  • Raw toggle — kaynağı görmek istersen tüm ROADMAP.md’nin önceden biçimlendirilmiş görünümü

​
Sağlık kontrolü

Yol Haritası araç çubuğundaki Health butonu gsd_health_check’i çağırır ve .planning/ dizininin sağlıklı, bozulmuş veya kırık olup olmadığını raporlar — manuel düzenlemelerden sonra faydalıdır.

​
Todos

Todos butonu, .planning/todos/pending ve .planning/todos/done altındaki tüm todo’ları alan ve önizleme ile listeler. Fikirleri yakalamak için bir Claude oturumunda /gsd:add-todo kullan; sonradan incelemek üzere burada görünürler.
GSD entegrasyonu opsiyoneldir. .planning/ dizini olmayan projeler de Milestone bölümünü alır — GSD kullanmadan da kilometre taşları oluşturabilir, faz ekleyebilir ve bir faza AI planlaması çalıştırabilirsin.