Plan Work

name: plan_work router_kit: ManagementKit description: Koddan önce planlama, repo araştırması, risk analizi ve implementation plan oluşturma rehberi. metadata: skillport: category: planning tags: [architecture, automation, best practices, clean code, coding, collaboration, compliance, debugging, design patterns, development, documentation, efficiency, git, optimization, plan work, productivity, programming, project management, quality assurance, refactoring, software engineering, standards, testing, utilities, version control, workflow] - design

📋 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ı