
Diyagramlar neden önemli
- Kod tabanındaki akış kontrolünü anlamak istediğinde
- Girdiden çıktıya veri soy ağacını izlemek gerektiğinde
- Başkalarını projeye alıştırırken ya da sistemini belgelendirirken
Dikkate alınacak iki boyut
- Amaç: Mantığı, veri akışını, altyapıyı mı yoksa başka bir şeyi mi modelliyorsun?
- Biçim: Hızlı bir şey (Mermaid diyagramı gibi) mi yoksa daha resmi bir şey (UML gibi) mi istiyorsun?
Prompt nasıl yazılır
- Akış kontrolü: “İstekler controller’dan veritabanına nasıl gider, göster.”
- Veri kökeni: “Bu değişkenin giriş yaptığı yerden nereye ulaştığına kadar izini sür.”
- Yapı: “Bu servisin bileşen düzeyinde bir görünümünü ver.”
Mermaid ile çalışmak
- Mantık ve akışlar için
flowchart
- Etkileşimler için
sequenceDiagram
- Nesne yapısı için
classDiagram
- Basit yönlü haritalar için
graph TD
- Extensions sekmesine git
- Mermaid’i ara
- Yükle

Diyagram stratejisi
- Bir fonksiyon, rota veya süreç seç
- Cursor’dan o kısmın diyagramını Mermaid ile çıkarmasını iste
- Birkaç tane olduğunda, onları birleştirmesini iste
Önerilen akış
- Ayrıntılı, düşük seviyeli bir diyagramla başla
- Bunu orta seviyeli bir görünüme özetle
- İstediğin soyutlama seviyesine ulaşana kadar tekrarla
- Cursor’dan bunları tek bir diyagram veya sistem haritasında birleştirmesini iste
Özetler
- Akış, mantık ve veriyi anlamak için diyagramları kullan
- Küçük istemlerle başla ve diyagramını buradan büyüt
- Mermaid, Cursor’da çalışması en kolay format
- C4 modelinde olduğu gibi düşük seviyeden başla ve yukarı doğru soyutla
- Cursor, diyagramları kolayca oluşturmanı, iyileştirmeni ve birleştirmeni sağlar