Mastra Factory: yapay zekâyla issue’dan PR’a

Mastra Factory, yapay zekâ ajanlarıyla yazılım geliştirmek için açık kaynaklı bir ortamdır. Kod depolarını, görev alımını, planlamayı, uygulamayı ve pull request incelemesini bir araya getirir. Geliştiriciler işi ajanlara devrederken kapsam, yöntem ve kodun kabulü üzerindeki kararlarını koruyabilir.

Basitçe anlatırsak Mastra Factory ne işe yarar?

GitHub’da bir hata kaydı açtığınızı düşünün. Bir ajan projeyi araştırır, çözüm planı önerir, dosyaları düzenler ve kontrolleri çalıştırır. Ekip daha sonra değişikliği inceler ve birleştirilip birleştirilmeyeceğine karar verir. Factory bu adımları düzenler ve konuşmayı ilgili görevle birlikte tutar.

Yeni özellikler, hata düzeltmeleri, yeniden düzenleme ve test yazımı temel kullanım alanlarıdır. Çıktı, yalnızca bir sohbet yanıtı değil, incelenebilir bir kod değişikliği ve PR olabilir. Bunun için depo erişimi, model hesabı, çalıştırma ortamı ve sonucu değerlendirebilen bir ekip gerekir.

Görevden incelemeye kontrollü ilerleme

Intake, Triage, Planning, Building, Review ve Done aşamaları işin durumunu gösterir. Aşama kuralları farklı görev türlerine göre düzenlenebilir. Ön değerlendirmede ekip eksik bilgiyi sağlar; uygulama başlamadan planı düzeltebilir veya onaylayabilir.

Her iş öğesinin kendi oturumu vardır. PR incelemesi için ayrı bir öğe ve oturum tutulur. Bu nedenle bir PR’ın birleştirilmesi ilk görevin tamamen bittiği anlamına gelmeyebilir. Birden fazla PR gerekebilir; tamamlanmayı kabul ölçütleri ve görev durumu üzerinden kontrol edin.

Mevcut GitHub deposuyla ilk deneme

Resmî başlangıç kılavuzundaki temel akış şöyledir:

1. Hedef deponun dışında npm create factory@latest my-factory çalıştırın ve kurulum adımlarını tamamlayın.
2. .env içinde FACTORY_CREDENTIAL_ENCRYPTION_KEY değerini bir kez yapılandırın. Eksikse kılavuz openssl rand -base64 32 kullanır. Anahtarı güvenli biçimde yedekleyin; değiştirmek kayıtlı kimlik bilgilerini okunamaz hâle getirebilir.
3. npm run dev ile başlatın, gösterilen adresi açın ve GitHub ile model sağlayıcısını bağlayın. Linear isteğe bağlıdır.
4. Settings → Work Intake altında GitHub issue eşitlemesini açıp depoyu seçin. Depoya erişim vermek, görev alımını ayrıca etkinleştirme gereğini kaldırmaz.
5. README güncellemesi gibi küçük ve açık kabul ölçütleri olan bir görev oluşturun. İlk denemede otomatik başlatmayı ve otomatik plan onayını kapalı tutun.
6. Araştırmayı okuyup soruları yanıtlayın, ardından planı inceleyin. Uygulamadan sonra diff, gerçek araç çıktıları ve PR kontrollerini doğrulayarak normal inceleme ve birleştirme sürecinizi izleyin.

Barındırma ve verilerin işlendiği yer

Tam platform kullanımı, platform kaynaklarıyla yerel sunucu veya tamamen kendi altyapınızda barındırma seçenekleri vardır. Yerel sunucu hâlâ bulut kimlik doğrulaması, PostgreSQL ve sandbox kullanabilir. Arayüzün bilgisayarınızda açılması bütün işlemlerin yerel olduğunu göstermez.

--no-platform seçeneği kendi kimlik doğrulama, kalıcı veritabanı ve çalıştırma yapılandırmanızı gerektirir. Üretim için sürekli çalışan Node.js süreci ve akış yanıtlarını destekleyen HTTPS gerekir. Dağıtım gereksinimlerini inceleyin.

Model erişimi sağlayıcı hesabına bağlıdır. Kişisel ve kuruluş kimlik bilgilerinin kapsamları farklıdır. Anahtarları issue metnine değil, ilgili ayarlara kaydedin. Özel kod için gizlilik politikasını ve seçtiğiniz model ile sandbox sağlayıcılarının koşullarını birlikte değerlendirin.

Ücretsiz başlangıç ile toplam maliyet farklıdır

10 Eylül 2026 kontrolünde resmî USD fiyatları Starter için aylık 0 dolar, 100 bin gözlemlenebilirlik olayı, 24 CPU saati ve 15 gün veri saklama gösteriyor. Teams aylık 250 dolar olarak listeleniyor; Enterprise teklif gerektiriyor.

Bu haklar sınırsız kodlama görevi anlamına gelmez. Model kullanımı, ek kaynak tüketimi ve altyapı ücret doğurabilir. Tam fiyat listesini kontrol edin; tutarlar vergi dâhil yerel TL fiyatı değildir. Lisans belgesi, Apache 2.0 kodunu ee/ klasörlerindeki kurumsal özelliklerden ayırır; bu özelliklerin üretim kullanımı geçerli kurumsal lisans gerektirir.

Sık sorulan sorular

Var olan bir projeyi bağlayabilir miyim?

Evet. GitHub deposunu bağlayıp issue alımını ayarlayın. Linear zorunlu değildir.

Tamamen ücretsiz mi?

Hayır. Açık kaynak ve ücretsiz başlangıç; model, barındırma, aşım veya kurumsal lisans maliyetlerini ortadan kaldırmaz.

Yerel sunucu tüm veriyi bilgisayarda tutar mı?

Kendiliğinden tutmaz. Sunucu, kimlik doğrulama, veritabanı, model ve sandbox birlikte incelenmelidir.

Son kod değişikliğini kim onaylar?

Ekip görevi netleştirebilir, planı inceleyebilir ve PR’ın birleştirilmesine karar verebilir. Otomasyon düzeyini pano kuralları belirler.

Resmî kaynaklar

• Factory belgeleri — kurulum ve yapılandırma.
• Mastra GitHub — kaynak kodu ve sorunlar.
• Resmî Discord — geliştirici topluluğu.
• X üzerinde Mastra — duyurular.
• Ekiple iletişim — demo ve kurumsal sorular.