ralph-loop - Uzun Süre Çalışan AI Ajan Döngüsüyle Geliştirme İşlerini Otomatikleştirme

• Görev listesini tekrar tekrar dolaşıp tamamlanana kadar çalışan uzun süre çalışan AI döngü sistemi
• Docker sandbox ortamında Claude Code/Codex/Gemini gibi AI CLI araçlarını güvenli biçimde çalıştırma
• Kullanım şekli
  • 1. adım: Ralph kurulumu npx @pageai/ralph-loop
  • 2. adım: PRD (ürün gereksinimleri dokümanı) ve görev listesi hazırlama: prd-creator becerisiyle gereksinimlerden PRD oluşturup her görevi gözden geçirme
  • 3. adım: Ajanı Docker sandbox içinde kurma
    • docker sandbox run claude . komutunu çalıştırıp giriş yapın
    • Bypass Permissions mode için mutlaka Yes seçin. Sandbox kullanılmasının nedeni bu
  • 4. adım: Ralph'i çalıştırma ./ralph.sh -n 50 # Ralph Loop'u 50 kez tekrar çalıştır
• Çalışma biçimi: Her yineleme adımında Ralph şu işleri yapar
  • 1. .agent/tasks.json dosyasında önceliği en yüksek tamamlanmamış görevi bulur
  • 2. .agent/tasks/TASK-{ID}.json içinde tanımlanan görev adımlarını sırayla yürütür
  • 3. test·lint·typecheck çalıştırır
  • 4. Görevi tamamlar, ekran görüntüsü alır, görev durumunu günceller ve değişiklikleri commit eder
• Bu PageAI sürümünü diğer Ralph Wiggum döngülerinden ayıran noktalar
  • PRD oluşturma ve gereksinimlerden görev listesi çıkarma
  • PRD'den görev lookup tablosu oluşturma
  • Görev adımlarını parçalara ayırma ve yönetilebilir aşamalara bölerek oluşturma
  • Yineleme ilerlemesini takip etme (zamanla birlikte gösterir)
  • Gerçek zamanlı çıktı akışı önizlemesi ve aktivite aşaması algılama (Thinking, Testing vb.)
  • Mevcut ekranın ekran görüntüsünü yakalama
  • İnsan girdisi gerektiğinde bildirim verme
  • Her yineleme için temiz çıktıyla geçmiş loglama
  • Her yineleme ve toplam süre için zamanlama metriklerini gösterme
  • Steering özelliğiyle önemli işleri öncelikli ele alabilme
  • Ayrıca
    • Yapılandırılmamış gereksinimler girildiğinde ajan PRD ve görev listesini otomatik oluşturur
    • Ayrıntılı tekil adımları içeren görev lookup tablosu kullandığı için yüzlerce görevin işlenmesi gerektiğinde yüksek ölçeklenebilirlik sunar
    • Sandbox ortamında çalıştığı için güvenlik güçlendirilmiştir
    • İlerleme durumu ve istatistikleri göstererek tamamlanan görevleri kolayca görmeyi sağlar
    • Ajana görev bazında otomatik testler ve ekran görüntüleri oluşturup çalıştırmasını söyler
    • Ajanın çalışmasına görünürlük ve izlenebilirlik sağlar
    • Çıktı akışını gösterir ve yineleme bazında tam kayıt logunu yakalar
• MIT lisansı