Plan Work

📋 Plan Work

Kodlamadan önce kapsamlı planlama ve araştırma rehberi.

📋 İçindekiler

1. Planlama Süreci
2. Repo Araştırması
3. Risk Analizi
4. Implementation Plan
5. Clarifying Questions

1. Planlama Süreci

Planlama Akışı

Görev Alındı
    │
    ▼
┌─────────────────────────┐
│  1. Gereksinim Analizi  │
│  (Ne isteniyor?)        │
└────────────┬────────────┘
             │
             ▼
┌─────────────────────────┐
│  2. Repo Araştırması    │
│  (Mevcut durum?)        │
└────────────┬────────────┘
             │
             ▼
┌─────────────────────────┐
│  3. Seçenek Analizi     │
│  (Alternatifler?)       │
└────────────┬────────────┘
             │
             ▼
┌─────────────────────────┐
│  4. Risk Değerlendirme  │
│  (Potansiyel sorunlar?) │
└────────────┬────────────┘
             │
             ▼
┌─────────────────────────┐
│  5. Plan Oluşturma      │
│  (Adımlar ve timeline)  │
└─────────────────────────┘

Planlama Checklist

- [ ] Gereksinimler tam olarak anlaşıldı mı?
- [ ] Mevcut kod yapısı incelendi mi?
- [ ] Bağımlılıklar belirlendi mi?
- [ ] Alternatif yaklaşımlar değerlendirildi mi?
- [ ] Riskler tanımlandı mı?
- [ ] Test stratejisi belirlendi mi?

2. Repo Araştırması

Kod Yapısı Analizi

# Dizin yapısını anla
tree -L 2 src/

# İlgili dosyaları bul
find . -name "*.ts" | xargs grep -l "searchTerm"

# Bağımlılıkları kontrol et
cat package.json | jq '.dependencies'

Sorulması Gereken Sorular

Mevcut Kod Patterns

# Ararken bakılacaklar:
- Similar features (nasıl implement edilmiş?)
- Error handling patterns
- Validation patterns
- Logging conventions
- Naming conventions

3. Risk Analizi

Risk Kategorileri

Risk Değerlendirme Template

## Risk: [Risk Adı]

**Olasılık:** Düşük / Orta / Yüksek
**Etki:** Düşük / Orta / Yüksek
**Açıklama:** ...

**Mitigation:**
1. ...
2. ...

**Contingency Plan:**
Eğer risk gerçekleşirse: ...

4. Implementation Plan

Plan Template

# Implementation Plan: [Feature Name]

## Özet
Kısa açıklama

## Scope
### Dahil:
- ...

### Hariç:
- ...

## Teknik Yaklaşım
1. Adım 1
2. Adım 2
3. ...

## Dosya Değişiklikleri
- `src/components/X.tsx` - Yeni component
- `src/api/Y.ts` - API endpoint

## Bağımlılıklar
- Package A (v1.2.3)
- Package B

## Timeline
| Adım | Süre | Açıklama |
|------|------|----------|
| Setup | 1h | Initial setup |
| Core | 4h | Core implementation |
| Test | 2h | Unit tests |

## Test Stratejisi
- Unit tests: ...
- Integration tests: ...
- Manual QA: ...

Estimation Guidelines

5. Clarifying Questions

Sorulması Gereken Sorular

## Gereksinimler
- Kullanıcı hikayesi tam mı?
- Edge case'ler düşünüldü mü?
- Error durumları tanımlandı mı?

## Tasarım
- UI/UX mockup var mı?
- Responsive davranış bekleniyor mu?
- Accessibility gereksinimleri?

## Teknik
- Performans hedefi var mı?
- Backward compatibility gerekli mi?
- Migration stratejisi gerekli mi?

## Timeline
- Deadline var mı?
- Phased delivery mümkün mü?

Question Template

Uygulamaya başlamadan önce birkaç sorum var:

1. [Soru 1]
2. [Soru 2]
3. [Soru 3]

Bu bilgiler, en uygun yaklaşımı belirlememize yardımcı olacak.

6. AoT Etiket Yapısı

Planlama sürecinde bu XML yapısını kullan:

<thinking>
  Görevi analiz et. Gereksinimleri listele.
  Kod yazmadan önce tam olarak anla.
</thinking>

<plan>
  ## Adımlar
  1. [Araştırma adımı]
  2. [Tasarım adımı]
  3. [Uygulama adımı]
  4. [Test adımı]
</plan>

<reflection>
  Bu plan yeterli mi?
  Eksik bir şey var mı?
  Riskler değerlendirildi mi?
</reflection>

Plan Work v2.1 - Enhanced

🔄 Workflow

Kaynak: RFC Process (IETF inspired) & Design Docs at Google

Aşama 1: Problem Definition (The "Why")

• Context: Sorun nedir? Neden şimdi çözüyoruz? (Business value).
• Requirements: Functional (Ne yapacak?) ve Non-functional (Hız, Güvenlik?) gereksinimleri netleştir.
• Anti-Goals: Neyi yapmayacağız? (Scope creep önleme).

Aşama 2: Solution Design (The "How")

• Alternatives: En az 2 yaklaşıma bak (Option A vs Option B). Trade-off analizi yap.
• Architecture: High-level diyagram (Mermaid) çiz. Veri akışını göster.
• Data Model: DB şeması veya API kontrat değişikliklerini tasarla.

Aşama 3: Revision & Committment

• Risk Assessment: "En kötü ne olabilir?" (Rollback planı).
• Estimation: T-shirt size (S/M/L) veya gün bazlı tahmin yap.
• Review: Tasarımı ekiple paylaş (RFC/Design Doc Review) ve onay al.

Kontrol Noktaları