Agent skill
plan-work-vuralserhat86-antigravity-agentic
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/plan-work-vuralserhat86-antigravity-agentic
SKILL.md
📋 Plan Work
Kodlamadan önce kapsamlı planlama ve araştırma rehberi.
📋 İçindekiler
- Planlama Süreci
- Repo Araştırması
- Risk Analizi
- Implementation Plan
- 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
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? |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?