İçeriğe geç

Spec-driven development akışımız

Hipatiya ArchFlow

Kendi geliştirdiğimiz spec-driven development akışı: yapay zekânın hızını mimari disiplinle birleştirir. Kod, onaylı dokümanlardan üretilir ve onlara karşı doğrulanır.

Bizimle Çalışın
  1. Issue
  2. BRD
  3. SDD
  4. TDD
  5. Kontrat
  6. TASKS
  7. /implement
  8. /verify
  9. /finish

Neden ArchFlow?

Yapay zekâ ajanları kodu saniyeler içinde yazar; neyin, neden ve hangi sınırlar içinde yazılacağını ise doküman belirlemelidir.

Mimari kayma

Yapay zeka destekli kodlama hızlıdır; ancak mimari ve dokümantasyon olmadan her değişiklik sistemi planlanandan biraz daha uzaklaştırır.

Kaybolan kararlar

Neden böyle tasarlandığı sohbetlerde, ticket yorumlarında ve kişilerin hafızasında kalır; ekip değiştiğinde bilgi de gider.

Servisler arası uyumsuzluk

Birden fazla ekip ve servis aynı özelliğe dokunduğunda, yazılı bir kontrat yoksa entegrasyon sorunları en son aşamada ortaya çıkar.

Akış

Her adım bir dokümana dayanır ve bir sonraki faza geçmeden önce onaylanır.

  1. Issue

    Fikir veya sorun kaydedilir; hata mı yeni özellik mi olduğu sınıflandırılır.

  2. BRD

    İş gereksinimleri: iş problemi, kullanıcı rolleri ve fonksiyonel gereksinimler.

  3. SDD

    Çözüm mimarisi: servis yapısı, veri akışı, entegrasyon noktaları ve mimari kararlar. Birden fazla servis etkileniyorsa hazırlanır.

  4. TDD

    Teknik tasarım: API detayları, veritabanı şeması, modül değişiklikleri ve test stratejisi.

  5. Kontrat

    Servisler arası API, mesaj ve veritabanı kontratları onaylanan tasarıma göre güncellenir.

  6. TASKS

    Teknik tasarımdan türetilen, ekip bazlı görevler, bağımlılıklar ve dağıtım sırası.

  7. Uygulama (/implement)

    Her ekip kendi uygulamasında yalnızca kendisine düşen görevleri hayata geçirir.

  8. Doğrulama (/verify)

    Kod; teknik tasarım, kontrat ve görev listesine göre denetlenir. Sonuç başarılı değilse düzeltmeye dönülür.

  9. Tamamlama (/finish)

    Tüm ekiplerin doğrulaması başarılıysa görevler, kontratlar, plan ve arşiv güncellenerek özellik kapatılır.

Küçük hata düzeltmelerinde BRD ve teknik tasarım adımları atlanır; doğrudan görev oluşturulup düzeltme yapılır.

Gerçek bir örnek

Sitre'yi baştan sona bu akışla geliştirdik

Kendi ürünümüz Sitre'nin her özelliği ve her hata düzeltmesi bir issue ile başladı; BRD, SDD, TDD ve görev listeleriyle ilerledi, doğrulama adımından geçerek kapandı.

Yandaki görev listesi, Türkçe vergi kimlik numarası tanıyıcısının geliştirilmesine ait. Her görev teknik tasarımın ilgili bölümüne bağlı; testler ve deploy da görevin parçası.

Sitre'yi inceleyin
sitre-docs/features/issue-no-1-tr-vkn-recognizer/TASKS.md

# TR_VKN Recognizer — Görevler

> TDD: TDD.md · Her ekip yalnızca kendi bölümünü uygular.

## sitre-svc

VknRecognizer + checksum doğrulaması (TDD 5.1, 5.2)

RECOGNIZER_MAP kaydı ve config desteği (TDD 5.3)

Unit testler: geçerli, geçersiz, bağlam, uç durum (TDD 7)

Kalibrasyon korpusuna VKN örnekleri (TDD 7)

Testler geçiyor — CI/Docker’da doğrulandı

Deploy edildi — API’de TR_VKN tespiti çalışıyor

## sitre-admin-ui

Değişiklik gerekmez; entity listesi API’den dinamik gelir.

Sitre geliştirme deposundan gerçek bir görev listesi (kısaltılmıştır).

Neler sağlar

Teknoloji bağımsız

Java, Rust, Python, React, Go, .NET ve daha fazlası; akış kullandığınız teknolojiden bağımsız çalışır.

Tek doğruluk kaynağı

Mimari kararlar, kontratlar ve görevler merkezi bir dokümantasyon reposunda tek yerde tutulur.

Dokümana karşı doğrulanan kod

Kod, yapay zeka (Claude Code) desteğiyle uygulanır ve her seferinde onaylı dokümanlara karşı doğrulanır.

Süreç kaçaklarına karşı kontrol

Her faz onayla ilerler; kontrat ve doğrulama adımları, onaysız değişikliklerin ve eksik işlerin tamamlanmış sayılmasını engeller.

Ekip izolasyonu

Her ekip yalnızca kendi görevlerini uygular; servisler arası iletişim dokümante edilmiş kontratlarla yönetilir.

Mevcut araçlarınızla entegre

İş takibi için Jira, GitHub veya GitLab ile birlikte çalışır.

ArchFlow ile nasıl çalışabiliriz?

Forward Deployed Engineering

Mühendislerimiz ekibinize katılır ve projeyi bu akışla yürütür; sahada üretilen her çözüm güncel mimari ve dokümantasyonla birlikte teslim edilir.

Ekibinize kurulum

ArchFlow'u kendi repolarınıza, iş takip aracınıza ve teknoloji yığınınıza kurar, ekibinizle ilk özellikleri birlikte geliştiririz.

Projenizi konuşalım

İhtiyacınızı kısaca anlatın, size en kısa sürede dönüş yapalım.

İletişime Geçin