Klasör yapısını yeni ekip üyesi için tek sayfa mimari haritaya çevir

Kod tabanının tek sayfalık onboarding haritası: özet, ana parçalar, giriş noktaları, akış, kurulum ipuçları, ilk gün görevi, sözlük ve "sana sormam gereken açık sorular" listesi.

Kanca

Ekibe biri katıldı. Yine aynı turu atıyorsun: şu klasör ne işe yarar, nereden başlanır, akış nereden geçer. Üçüncü kez aynı şeyi anlatınca fark ediyorsun ki sistem senin kafanda kilitli; sen izinliyken kimse bağımsız ilerleyemiyor.

Hamle — Claude / ChatGPT (ikisi de çalışır)

Prompt — kopyala & yapıştır

Rolün: Bu kod tabanına yeni katılan bir yazılımcıya onboarding yapan kıdemli bir ekip üyesisin.

Sana aşağıda bir projenin klasör/dosya yapısını (dizin ağacı) ve varsa kısa notlarımı vereceğim. Görevin: yeni gelen birinin tek sayfada okuyup sistemin nasıl kurulduğunu kavrayabileceği bir "mimari ve onboarding haritası" çıkarmak.

Kurallar:
- Sadece sana verdiğim ağaçtan ve notlardan çıkarım yap. Dosya içeriğini görmüyorsun; klasör/dosya adlarından makul çıkarım yaparsın ama UYDURMAZSIN.
- Bir şeyi adlardan güvenle çıkaramıyorsan o satıra "EKSIK: [sana sormam gereken şey]" yaz. Boşluğu tahminle doldurma.
- Emin olmadığın çıkarımın başına "muhtemelen" koy.
- Kısa, net Türkçe yaz. Her madde tek cümle. Övgü, dolgu, yorum ekleme.

Şu başlıklarla çıktı ver:

1. Tek cümlelik özet — Bu proje ne yapar? (Adlardan çıkmıyorsa EKSIK yaz.)
2. Ana parçalar — Üst düzey klasörler ve her birinin işi.
3. Nereden başlanır — Giriş noktası dosyaları (adında main, index, app, server gibi geçenler) ve çalışmanın başladığı yer.
4. Akış — İstek/veri hangi parçadan girip nereye gidiyor (ağaçtan çıkarılabildiği kadar).
5. Kurulum ipuçları — Bağımlılık, derleme, çalıştırma ve yapılandırma ile ilgili gördüğün dosyalar (paket dosyaları, yapılandırma dosyaları, ortam değişkeni örneği gibi) ve ne işe yaradıkları.
6. İlk gün görevi — Yeni gelenin sistemi bozmadan bakabileceği/deneyebileceği 1 küçük başlangıç noktası.
7. Sözlük — Ağaçta geçen, yeni gelenin bilmeyeceği kısaltma/klasör adı varsa kısa açıklama (çıkaramıyorsan EKSIK).
8. Açık sorular — Ağaçtan cevaplanamayan, sana sormam gereken şeylerin listesi.

Dizin ağacı ve notlarım:
[BURAYA klasör yapısını yapıştır. Terminalde `tree` ya da `git ls-files` çıktısı, veya elle yazılmış liste olur. Varsa 1-2 satır bağlam da ekle.]

Çıktı

Kod tabanının tek sayfalık onboarding haritası: özet, ana parçalar, giriş noktaları, akış, kurulum ipuçları, ilk gün görevi, sözlük ve "sana sormam gereken açık sorular" listesi. Ağacı hazırlaman (tree/git ls-files ya da elle) ~2 dk, prompt ~1 dk çalışır.

Kariyer çentiği

Bilgiyi kafasında tutan kişi değil, ekibin bağımsız ilerlemesini kolaylaştıran kişi olursun; onboarding yükünü her seferinde yeniden anlatmak yerine tekrar kullanılabilir bir haritaya çevirirsin.

Sınır

AI yalnızca klasör ve dosya adlarından çıkarım yapar; iş mantığı, kod içi bağımlılıklar ve "neden böyle" cevapları dosya içeriğinde saklıysa göremez, o yüzden çıkan harita bir taslaktır ve gözden geçirmen şarttır. Kapalı/özel bir repo yapısını dışarı yapıştırıyorsan kurumunun veri politikasına dikkat et.

Örnek — bu prompt ne üretir?

Örnek girdi

Bu iç kullanımdaki bir sipariş servisi, yeni gelen bir yazılımcı için harita çıkarmak istiyorum. Ağacı `tree` ile aldım:

.
├── src/
│   ├── index.js
│   ├── server.js
│   ├── routes/
│   │   ├── orders.js
│   │   ├── auth.js
│   │   └── health.js
│   ├── controllers/
│   │   ├── orderController.js
│   │   └── authController.js
│   ├── services/
│   │   ├── paymentService.js
│   │   └── notificationService.js
│   ├── models/
│   │   ├── order.js
│   │   └── user.js
│   ├── db/
│   │   ├── connection.js
│   │   └── migrations/
│   │       └── 001_init.sql
│   ├── middleware/
│   │   ├── authGuard.js
│   │   └── errorHandler.js
│   └── utils/
│       └── logger.js
├── tests/
│   └── orders.test.js
├── scripts/
│   └── seed.js
├── config/
│   └── default.json
├── .env.example
├── package.json
├── Dockerfile
├── docker-compose.yml
└── README.md

Çıktı

1. Tek cümlelik özet

Muhtemelen sipariş alıp ödeme ve bildirim adımlarını yürüten bir Node.js backend API servisi.

2. Ana parçalar

src/ — Uygulama kaynak kodu; iş buradan yürür.
src/routes/ — HTTP uç noktalarının tanımı (sipariş, kimlik doğrulama, sağlık kontrolü).
src/controllers/ — İsteği karşılayıp ilgili servise yönlendiren katman.
src/services/ — İş mantığı; ödeme ve bildirim işlemleri.
src/models/ — Veri modelleri (sipariş, kullanıcı).
src/db/ — Veritabanı bağlantısı ve şema göçleri (migrations).
src/middleware/ — İstek ara katmanı: kimlik koruması ve hata yakalama.
src/utils/ — Yardımcı araçlar; şimdilik sadece loglama.
tests/ — Otomatik testler.
scripts/ — Tek seferlik yardımcı komutlar (örn. veri tohumlama).
config/ — Yapılandırma değerleri.

3. Nereden başlanır

src/index.js — Muhtemelen uygulamanın giriş noktası; ilk çalışan dosya.
src/server.js — Muhtemelen HTTP sunucusunu ayağa kaldırıp rotaları bağlayan dosya.
Okuma sırası önerisi: index.js → server.js → routes/ → controllers/ → services/.

4. Akış

İstek routes/ üzerinden girer, controllers/ çağrılır, iş services/ içinde yapılır, veri models/ + db/ ile okunur/yazılır.
middleware/authGuard.js muhtemelen korumalı rotalardan önce kimlik doğrular; errorHandler.js hataları tek noktada yakalar.
EKSIK: notificationService senkron mu tetikleniyor, yoksa bir kuyruk/dış servis mi kullanıyor — ağaçtan çıkmıyor.

5. Kurulum ipuçları

package.json — Bağımlılıklar ve muhtemelen npm start / npm test komutları burada.
.env.example — Gereken ortam değişkenlerinin şablonu; kopyalayıp .env yap.
config/default.json — Varsayılan yapılandırma değerleri.
Dockerfile + docker-compose.yml — Servisi (ve muhtemelen veritabanını) konteynerde ayağa kaldırma.
src/db/migrations/001_init.sql — İlk veritabanı şeması; kurulumda çalıştırılması gerekebilir.

6. İlk gün görevi

src/routes/health.js uç noktasını çağır (curl ya da tarayıcı); sistemi bozmadan ayakta olduğunu doğrularsın.

7. Sözlük

migrations — Veritabanı şemasını adım adım kuran/değiştiren dosyalar.
middleware — İstek asıl işleme gitmeden önce çalışan ara katman.
seed — Veritabanını başlangıç/örnek veriyle dolduran komut.
EKSIK: proje-içi özel kısaltma varsa ağaçta görünmüyor.

8. Açık sorular

Hangi veritabanı kullanılıyor? .sql var ama tür (Postgres, MySQL vb.) net değil.
notificationService hangi kanalı kullanıyor (e-posta, SMS, push)?
paymentService dış bir ödeme sağlayıcısına mı bağlanıyor, hangisine?
Kimlik doğrulama yöntemi ne (JWT, session)?
Migrations elle mi yoksa açılışta otomatik mi çalışıyor?

ÜRETİM: TEM 2026 · CLAUDE Bu kayıt eşlenmiş örnek girdi ve çıktı içerir. Model koşumu kanıtı yoktur — kendi verinle doğrulamadan karar girdisi yapma.

Kendi verinle çalıştır

Verini aşağıya yapıştır; prompt seninkiyle birleşip çalıştırmaya hazır tek bloğa dönüşsün. Sonra tek dokunuşla Claude ya da ChatGPT'de aç.

Senin verin

Hazır prompt — verini bekliyor

Rolün: Bu kod tabanına yeni katılan bir yazılımcıya onboarding yapan kıdemli bir ekip üyesisin.

Sana aşağıda bir projenin klasör/dosya yapısını (dizin ağacı) ve varsa kısa notlarımı vereceğim. Görevin: yeni gelen birinin tek sayfada okuyup sistemin nasıl kurulduğunu kavrayabileceği bir "mimari ve onboarding haritası" çıkarmak.

Kurallar:
- Sadece sana verdiğim ağaçtan ve notlardan çıkarım yap. Dosya içeriğini görmüyorsun; klasör/dosya adlarından makul çıkarım yaparsın ama UYDURMAZSIN.
- Bir şeyi adlardan güvenle çıkaramıyorsan o satıra "EKSIK: [sana sormam gereken şey]" yaz. Boşluğu tahminle doldurma.
- Emin olmadığın çıkarımın başına "muhtemelen" koy.
- Kısa, net Türkçe yaz. Her madde tek cümle. Övgü, dolgu, yorum ekleme.

Şu başlıklarla çıktı ver:

1. Tek cümlelik özet — Bu proje ne yapar? (Adlardan çıkmıyorsa EKSIK yaz.)
2. Ana parçalar — Üst düzey klasörler ve her birinin işi.
3. Nereden başlanır — Giriş noktası dosyaları (adında main, index, app, server gibi geçenler) ve çalışmanın başladığı yer.
4. Akış — İstek/veri hangi parçadan girip nereye gidiyor (ağaçtan çıkarılabildiği kadar).
5. Kurulum ipuçları — Bağımlılık, derleme, çalıştırma ve yapılandırma ile ilgili gördüğün dosyalar (paket dosyaları, yapılandırma dosyaları, ortam değişkeni örneği gibi) ve ne işe yaradıkları.
6. İlk gün görevi — Yeni gelenin sistemi bozmadan bakabileceği/deneyebileceği 1 küçük başlangıç noktası.
7. Sözlük — Ağaçta geçen, yeni gelenin bilmeyeceği kısaltma/klasör adı varsa kısa açıklama (çıkaramıyorsan EKSIK).
8. Açık sorular — Ağaçtan cevaplanamayan, sana sormam gereken şeylerin listesi.

Dizin ağacı ve notlarım:
[BURAYA klasör yapısını yapıştır. Terminalde `tree` ya da `git ls-files` çıktısı, veya elle yazılmış liste olur. Varsa 1-2 satır bağlam da ekle.]

Yapıştırdığın veri tarayıcından çıkmaz — WhiteYaka'ya gönderilmez. Prompt panoya kopyalanır; açılan sohbete Ctrl/⌘ + V ile yapıştırırsın.

i Bu föy örnek girdi ve çıktı içerir; yapısal doğrulama ve ölçütlü prompt koşumu henüz kaydedilmedi.

← Tüm bölümler Sıradaki föy: Büyük işi savunulabilir alt görevlere böl: "ne kadar sürer"e hazır cevap →

Bülten kaydı kapalı.

Bu sayfa e-posta adresi toplamaz ve liste kaydı başlatmaz. 160 hamlenin tamamı giriş yapmadan açık.