Proje İzleme

Genel bakış

Guardian'ın Project Monitoring özelliği, release öncesi AI-generated code intake yüzeyidir. Değişiklik riskini analiz eder, policy'leri uygular ve release kararına veri sağlar.

Monitoring'i başlatma

Adım 1: Proje seçin

1. Scope alanına tıklayın veya bir klasörü uygulamaya sürükleyip bırakın
2. Projenizin root dizinini seçin
3. Seçilen path Scope alanında görünür

Adım 2: Launch Guardian

Şunları yaptıktan sonra:

• Geçerli bir proje path'i seçin
• AI provider'ınızı yapılandırın
• (Gerekiyorsa) GitHub ile giriş yapın

Launch Guardian ile izlemeyi başlatın.

Monitoring nasıl çalışır?

Guardian, dosya değişikliklerini izler ve seçili AI provider ile analiz eder:

1. Dosya tespiti: Projede kaydedilen değişiklikleri yakalar
2. Batch işleme: Verimli analiz için değişiklikleri gruplar
3. AI analizi: Kod bağlamını provider'a gönderip bulgu üretir
4. Sonuç gösterimi: Bulguları ve release etkisini panelde gösterir

Release decision yüzeyi

Guardian bulguları release odaklı karara çevirir:

• PASS
• PASS_WITH_WARNING
• BLOCK_UNTIL_APPROVED
• OVERRIDDEN (reason zorunlu)

Bu sayede "fix önerdim" tek başına release izni sayılmaz.

Snapshot hydration

Guardian yeniden başlarsa, Monitor ekranını önce lokal snapshot'tan (.guardian/critiques.json) hydrate eder ve sonra live event'lerle birleştirir. Bu, workspace içinde mevcut bulgular varken boş dashboard görünmesini engeller.

Scan scope profilleri

Guardian, maliyet vs kapsam dengesini yönetmek için üç profil sunar.

Settings > General > Scan Scope üzerinden değiştirebilirsiniz. Profil değişiklikleri monitoring bir sonraki başlangıcında uygulanır.

İpucu: Guardian'ın “yanlış dosya türlerinde token harcadığını” hissediyorsanız Source profilinde kalın; Extended/Full profilini yalnızca ihtiyaç olduğunda açın.

Bulguları anlama

Severity seviyeleri

Governance odaklı kategori örnekleri

Guardian, release güvenliğini etkileyen kategorileri önceliklendirir:

• Security hijyeni: Zafiyetler, açık secret'lar, güvensiz auth/veri işleme
• Architecture drift: Katman sınırı ihlalleri, coupling artışı, mimari sapmalar
• Quality guardrail: Riskli değişikliklerde eksik test ve güvensiz refactor pattern'leri
• AI-heavy risk sinyalleri: Daha sıkı insan kapısı gerektiren büyük/şüpheli AI destekli değişiklikler

Bulgularla çalışma

Detay görüntüleme

Bir bulguya tıkladığınızda:

• Sorunun açıklaması
• Etkilenen dosya ve konum
• (Varsa) önerilen fix

Fix uygulama

Bir bulgu önerilen fix içeriyorsa FIX aksiyonu görünür:

1. Bulgu detayını açıp önerilen içeriği inceleyin
2. FIX (veya APPLY THIS FIX) ile dosyaya yazdırın
3. Sonucu doğrulayıp gerekirse geri almak için Guru'yu kullanın

Guru'ya sor

Bulgu üzerindeki Ask Guru aksiyonuyla:

• Detaylı açıklama
• Alternatif çözümler
• Best practice önerileri

Monitoring'i durdurma

Kill Guardian ile izlemeyi durdurabilirsiniz:

• File watcher'lar kapatılır
• Pending analizler iptal edilir
• Uygulama idle duruma döner

Activity panel

Activity panelde şunlar görünür:

• Gerçek zamanlı durum
• Severity ile bulgu listesi
• Guru sohbet geçmişi
• Uygulanan fix geçmişi

Sorun giderme

Best practices

1. Küçük başlayın: Önce odaklı bir dizinde çalışın
2. Apply öncesi inceleyin: Fix'leri uygulamadan önce gözden geçirin
3. Guru kullanın: Net olmayan bulgular için açıklama isteyin
4. Maliyeti izleyin: Ücretli API'lerde usage takip edin
5. Önce kritikler: Önce high-severity bulgulara odaklanın