Proje İş Akışı
Doctrine katı bir işlem sırası dayatmaz, bir yaşam döngüsü sunar. İşinize uymayan aşamaları ve skill’leri atlayın. Yeni bir bulgu kararınızı değiştirirse önceki aşamaya dönün.
Yaşam döngüsü
Bölüm başlığı “Yaşam döngüsü”| Aşama | Ana soru | Tipik skill içerikleri |
|---|---|---|
| Planlama ve keşif | Neyi başarmaya çalışıyoruz, henüz ne bilinmiyor? | wayfinder, grilling, research, project-groundwork |
| Teknik tanım ve iş kaydı | Hangi küçük sonuçlar geliştirilip doğrulanabilir? | spec-to-tickets |
| Tasarım ve prototip | Önce hangi teknik seçim çözülmeli? | prototype, codebase-design, architecture-diagram |
| Geliştirme | Kullanıcının sırada gözlemleyeceği davranış nedir? | tdd, secure-coding, code-style-lint |
| İnceleme ve birleştirme | Değişiklik kod sağlığını iyileştiriyor ve hedefi karşılıyor mu? | code-review, test-strategy, resolving-merge-conflicts |
| Sürüm ve dağıtım | İş nasıl kaydedilmeli, sürümlenmeli ve dağıtılmalı? | repo-ship, release-versioning, safe-deployment |
| İşletim ve müdahale | Çalışan sistemde ne oluyor? | observability, diagnosing-bugs, incident-response, handoff |
| İyileştirme | Hangi yapısal sorun üzerinde sırada çalışmaya değer? | improve-codebase-architecture |
Küçük görev döngüsü
Bölüm başlığı “Küçük görev döngüsü”Başlangıç görevlerinin çoğu daha kısa bir döngü kullanır:
- Sonucu yazın. Görev tamamlandığında kullanıcının ne göreceğini belirtin.
- Skill’i seçin. Alışkanlığa göre değil, önünüzdeki duruma göre karar verin.
- Sınırları belirleyin. Kapsam dışını, değişebilecek dosyaları ve onay gerektiren eylemleri yazın.
- Tek parça geliştirin. Bir davranışa ve onu doğrulayacak tek bir hedefe odaklanın.
- Sonucu inceleyin. Diff’i okuyun ve ilgili en küçük kontrolü çalıştırın.
- Değişikliği kaydedin. Tek bir mantıksal amacı commit olarak kaydedin ve kalan riski belirtin.
Yaygın yollar
Bölüm başlığı “Yaygın yollar”Yeni ve belirsiz fikir
Bölüm başlığı “Yeni ve belirsiz fikir”wayfinder veya grilling→ eksik bilgiler için research→ project-groundwork→ spec-to-tickets→ tdd→ code-review→ repo-shipBildirilen hata
Bölüm başlığı “Bildirilen hata”öncelik bilinmiyorsa triage→ diagnosing-bugs→ gerileme testi ve düzeltme için tdd→ code-review→ repo-shipGüvenlik açısından hassas değişikliklerde secure-coding geliştirme sırasında uygulanmalıdır. İnceleme aşamasına ertelenmemelidir.
“Tamamlandı” demeden önce kanıt
Bölüm başlığı ““Tamamlandı” demeden önce kanıt”Bir yanıtın “tamamlandı” demesi, işin gerçekten bittiğini göstermez. Sonucu dört düzeyde kontrol edin:
- Diff: Yalnızca amaçlanan dosyalar ve davranışlar mı değişti?
- Otomatik kontrol: İlgili test, derleme veya doğrulama komutu başarılı mı?
- Kullanıcı davranışı: Vadedilen sonucu gösterebiliyor musunuz?
- Depo durumu: İlgisiz değişiklikler korunmuş mu, yapılan değişiklik açıkça kaydedilmiş mi?
Hata düzeltiyorsanız ilk yeniden üretme adımlarını tekrar uygulayın. Yeni özellikte ise belirtilen kabul sonucunu gösterin.
İyi görev özeti
Bölüm başlığı “İyi görev özeti”Sonuç:Kapsam dışı:İlgili bağlam:İzin verilen değişiklikler:Onay gerektiren eylemler:Tamamlanma kanıtı:Kullanılacak Doctrine skill:İşinize yaramayan alanları doldurmayın. Amaç evrak üretmek değil, gizli varsayımları görünür kılmaktır.