adımlı akış: bağla, kanıtı incele, hikâyeyi kur, yayınla
VAKA ÇALIŞMASI · 2026
RepoStory
Bir GitHub deposunu okuyup içindeki ürün hikâyesini kanıtlara bağlı, düzenlenebilir bir vaka çalışmasına dönüştüren iki dilli geliştirici aracı.
- Alan
- Web · GitHub · Developer Tool
- Rol
- Ürün ve mühendislik
- Durum
- Ürünü aç
Problem
Bir repository’nin gerçek ürün değeri; README, commit, release ve kod yapısına dağılmış teknik sinyaller arasında görünmez kalabiliyor.
Yaklaşım
GitHub repository’lerini analiz eden; kanıtları, zaman çizgisini ve ürün sinyallerini düzenlenebilir bir problem–yaklaşım–özellik–etki anlatısında birleştiren iki dilli bir çalışma alanı geliştirdim.
Sonuç
Geliştiricilerin teknik emeğini kaynaklara bağlı, paylaşılabilir bir ürün hikâyesine ve portfolio vaka çalışmasına dönüştüren bir developer tool.
analiz kaynağı: README, sürüm notları, mimari, zaman çizgisi, kanıt doğrulama
çıktı biçimi: vaka çalışması, README, lansman metni, PDF brief
Teknik kararlar
Her kararın bir bedeli var; burada ikisi birlikte duruyor.
Her iddiayı kaynağına bağladım
Üretilen anlatı serbest metin değil: her cümle commit’lere, sürümlere, dosyalara ve README bölümlerine bağlı kalıyor. Arayüz kanıt doğrulamasını sayarak gösteriyor.
Bedeli
Kanıta bağlı kalmak üretilen metnin ne kadar iddialı olabileceğini sınırlıyor. Bunun alternatifi, kulağa hoş gelen ama depoda karşılığı olmayan bir hikâyeydi.
Çıktıyı tek biçimle sınırlamadım
Aynı analiz dört farklı sona çıkıyor: portfolyo vaka çalışması, proje README’si, lansman metni ve paylaşılabilir PDF brief. Bir deponun anlatılma biçimi, kime anlatıldığına göre değişiyor.
Bedeli
Dört biçimi de iyi tutmak tek bir çıktıyı mükemmelleştirmekten pahalı. Karşılığında araç, yazma işinin farklı anlarında işe yarıyor.
Düzenlemeyi akışın parçası yaptım
Analiz bir son değil, taslak. Kullanıcı metni yayından önce düzenliyor ve düzenlerken kaynak bağlantıları korunuyor.
Bedeli
Tam otomatik bir çıktı daha etkileyici bir demo olurdu. Ancak bir geliştiricinin kendi işini anlatan metni onaylamadan yayınlaması gerçekçi değil.
Ekran ekran
Kanıt ve anlatı yan yana
Depodan çıkarılan sinyaller ile üretilen anlatı aynı çalışma alanında duruyor; düzenleme sırasında kaynağı görmek için başka yere gitmek gerekmiyor.
Kullanılan teknolojiler
Next.jsTypeScriptGitHub API