Başlarken
AI ile üretilen kodu release öncesi politika ve insan onayıyla kontrol edin.
Guardian nedir?
Guardian, küçük mühendislik ekiplerinin AI ile üretilen kodu release'e çıkmadan önce kontrol etmesine yardımcı olur. Riskli AI destekli değişiklikler ve release kararlarına odaklanan bir desktop + CLI yönetişim katmanıdır.
Guardian şunlar değildir:
- Genel bir AI coding assistant
- Genel bir code review aracı
- Genel bir security scanner
Guardian, AI-heavy kod akışlarında release kontrol katmanıdır.
Çekirdek ürün akışı
- AI-Generated Code Intake: AI destekli veya alışılmadık büyüklükte/refactor değişiklikleri daha sıkı akışa alır.
- Policy Enforcement: Takımın mimari, güvenlik ve kalite politikalarını otomatik uygular.
- Human Approval Workflow: Yüksek riskte onay/override kararlarını sorumlu kişi ve gerekçe ile kaydeder.
- Release Decision Surface: Son soruya kanıtla yanıt verir: Bu kod şimdi release'e çıkabilir mi, neden?
Kimler için?
Guardian, AI destekli kodda release güveni isteyen ekipler için tasarlanmıştır:
| Rol | Kullanım senaryosu |
|---|---|
| Engineering liderleri | AI-heavy PR'larda release karar standardı oluşturmak |
| Platform/DevOps ekipleri | Lokal + CI release gate akışlarına guardrail eklemek |
| Güvenlik/Mimari ekipleri | Merge/release öncesi kritik politikaları zorunlu kılmak |
| Release yöneticileri | Onay, override ve karar kanıtlarını izlemek |
Nasıl çalışır?
Guardian, dört adımlı bir release yönetişim döngüsü izler:
┌─────────────┐ ┌──────────────┐ ┌──────────────┐ ┌─────────────┐
│ INTAKE │────▶│ ENFORCE │────▶│ APPROVE │────▶│ DECIDE │
│ AI-heavy PR │ │ Team Policy │ │ Human Gate │ │ Ship/Block │
└─────────────┘ └──────────────┘ └──────────────┘ └─────────────┘
- Intake: Guardian, riskli AI destekli veya alışılmadık büyüklükte değişiklikleri tespit eder.
- Enforce: Takım politikaları mimari, güvenlik ve kalite ekseninde çalıştırılır.
- Approve: İnsan reviewer kararları ve override gerekçeleri kayda alınır.
- Decide: Release uygunluğu, açıklanabilir kanıtlarla netleştirilir.
İlk 10 dakika
İlk oturumda şu adımları uygulayın:
1. Uygulamayı kurun
Download sayfasından kurulum dosyasını indirin. macOS build'leri hazır; Windows ve Linux yayınlandığında görünecek.
2. Provider ayarlarını yapın
Settings > Provider bölümünden AI provider kimlik bilgilerinizi ayarlayın. Guardian hem bulut hem de lokal model seçeneklerini destekler.
3. Workspace izlemeyi başlatın
Scope alanından (veya klasörü uygulamaya sürükleyip bırakarak) workspace'inizi seçin, ardından Launch Guardian ile izlemeyi başlatın.
4. Bulguları release kararı olarak değerlendirin
Tarama tamamlandığında:
- Önce AI-heavy ve mimari olarak kritik değişikliklere odaklanın
- Guru ile risklerin neden önemli olduğunu netleştirin
- Politika uyumlu düzeltmeleri uygulayın ve karar bağlamını release akışınıza kaydedin
Uygulama yerleşimi
Guardian arayüzü dört ana bölümden oluşur:
| Alan | Amaç |
|---|---|
| Sidebar | İzleme, review, ayar ve geçmiş ekranları arasında geçiş |
| Main Panel | Bulgular, politika kanıtları ve fix önerilerini inceleme |
| Guru Chat | Riskli değişiklikleri açıklama ve politika uyumlu fix önerme |
| Status Bar | Sağlayıcı durumu, sürüm bilgisi ve akış durumu |
Sonraki adımlar
- Kurulum rehberi - Detaylı kurulum adımları
- Guru - Riskli bulguları açıklayın ve fix önerileri üretin
- Reviews & Fix Proposals - Onay ve kontrollü uygulama akışını yönetin
- Yapılandırma - Politika, scan scope ve guardian.lock ayarları
- Güvenlik - Local-first güvenlik modelini anlayın