Agent Skills: 📋 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

| Alan | Sorular | |------|---------| | Mimari | Hangi pattern kullanılıyor? (MVC, Clean Architecture?) | | State | State management nasıl? (Redux, Zustand, Context?) | | API | REST mi GraphQL mi? Endpoint yapısı nasıl? | | Test | Test framework ne? Coverage hedefi? | | Stil | ESLint/Prettier config var mı? |

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

| Kategori | Örnek Riskler | Mitigation | |----------|--------------|------------| | Teknik | Performans, scalability | POC, benchmark | | Bağımlılık | Breaking changes, deprecated API | Version pinning | | Zaman | Underestimation | Buffer time ekle | | Scope | Feature creep | Clear requirements | | Entegrasyon | 3rd party API | Fallback stratejisi |

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

| Complexity | Süre | Örnek | |------------|------|-------| | Trivial | < 1h | Config değişikliği | | Small | 1-4h | Basit component | | Medium | 4-8h | Feature modülü | | Large | 1-3 gün | Yeni sistem | | XL | 1+ hafta | Major refactor |

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ı

| Aşama | Doğrulama | |-------|-----------| | 1 | Bilinmeyenler (Unknowns) listelendi mi? | | 2 | Bu çözüm teknik borç yaratıyor mu? Eğer evetse, planlı mı? | | 3 | Güvenlik ve Gizlilik (Privacy) etkileri formu dolduruldu mu? |