AI CodeOps

Kod yazılmadan önce yaklaşımı belirleyen yapay zekâ planlaması

AI CodeOps ajanları, kod üretilmeden veya incelenmeden önce reponuzu okur, gereksinimleri ve teslimat planını yazar, kararları ADR olarak kaydeder.

AI CodeOps'ta planlama, bir oturumun ilk adımlarıdır: ajanlar projenin gerçek kodunu okur, ardından herhangi bir şey geliştirilmeden önce gereksinimleri, bir tasarımı veya bir teslimat planını yazar. Çıktıları sonraki her adıma aktarılır, çalışma alanının Plan panosuna eklenir ve keşif iş akışlarında proposed (önerildi) durumunda bir mimari karar kaydı (ADR) olarak kaydedilir.

Bir modelin yazdığı plan, ancak değiştireceği koda dayanıyorsa işe yarar. Bu nedenle bir oturum reposu olan bir projeyi hedeflediğinde AI CodeOps önce repoyu, oturumu başlatan kişinin git bağlantısını kullanarak salt okunur olarak klonlar. Ajanlar bir dosya ağacı ve görevle en ilgili dosyaları alır. Repo okunamazsa, örneğin onu görebilen bir git hesabını kimse bağlamadığı için, oturum bu gerekçeyle başarısız olur. Bunun yerine sessizce yepyeni bir uygulama planlamaz.

Henüz hiçbir görev yokken Plan with AI

Planlama çoğu zaman bir oturumdan daha önce, henüz görev hâline gelmemiş bir fikirle başlar. Plan panosundaki Plan with AI, planlama toplantısındaki bir teknik lider gibi çalışan bir planlama asistanıyla yapılan bir sohbettir. Planı değiştiren şeyleri sorar (kimin için olduğu, kapsam, "bitti"nin ne anlama geldiği), bir yaklaşım önerir, ilk sürümün dışında nelerin bırakılacağını söyler ve işi, bir ajanın tek oturumda bitirebileceği parçalara böler.

Anlaştığınızda Draft tasks düğmesini seçin. Asistan sohbeti görevlere dönüştürür; her görevin bir açıklaması ve kabul kriterleri, bir önceliği, ona en uygun ajanı ve projesi vardır. Henüz hiçbir şey kaydedilmez: istemediklerinizin işaretini kaldırır, geri kalanını düzenler, Backlog veya To do seçeneğini belirler ve görevleri oluşturursunuz. Her görevin zaman çizelgesi, görevin planlama asistanıyla kaydedildiğini belirtir.

Asistan çalışma alanının projelerini, ajanlarını ve panoda hâlihazırda açık olan görevleri bilir; bu yüzden aynı görevi iki kez taslak hâline getirmez. Repoyu okumaz: bunu, görevin oturumu çalıştığında ajanlar yapar. Çalışma alanının kendi model sağlayıcısında veya planınızın kotası dahilinde platformun Standard kademesinde çalışır ve çalışma alanının yapay zekâ bütçesi tükendiğinde durur.

Hangi ajanlar çalışır

Planlama birkaç yerleşik ajana dağıtılmıştır. Her birinin kendi talimatları vardır:

  • Architect: yaklaşım, değiştirilecek dosyalar ve modüller, temel kararlar, ödünleşimler ve riskler.
  • Product Analyst: kabul kriterleriyle birlikte gereksinimler ve nelerin kapsam içinde, nelerin kapsam dışında olduğu.
  • Project Planner: bağımlılıkları, kilometre taşlarını ve efor tahminlerini içeren aşamalı bir teslimat planı.
  • Researcher: kod tabanındaki önceki çalışmalar, kullanılan kütüphaneler ve önem taşıyan kısıtlar.
  • ADR Writer: Context, Decision, Consequences ve Alternatives bölümlerini içeren bir mimari karar kaydı (Architecture Decision Record).
  • UI Designer ve DevOps Engineer: ön yüz çalışmaları ile altyapı veya pipeline değişiklikleri için plan.

İş akışını bir oturum başlatırken seçersiniz. Şu yerleşik iş akışları büyük ölçüde veya tamamen planlamayla ilgilidir:

İş akışıAdımlar
Discovery & SpecResearcher (önceki çalışmalar), Product Analyst (gereksinimler), Project Planner
Architecture DebateArchitect A, Architect B, Reviewer (eleştirmen), Architect (nihai sentez)
Threat ModelArchitect (kapsam ve veri akışı), Security Auditor (STRIDE), ADR Writer
Feature SDLCProduct Analyst, Project Planner, Architect, ardından geliştirme, test ve dokümantasyon

Diğer iş akışlarının çoğu tek bir planlama adımıyla açılır. Plan, Build, Review & Test iş akışı Architect ile, UI Implementation UI Designer ile, DevOps Change DevOps Engineer ile, Performance Tuning ise profil çıkarmanın ardından Architect'in optimizasyon planıyla başlar.

Adımlar birbiri ardına çalışır. Her ajan görevi, repo bağlamını ve önceki adımların yazdıklarını alır. Architecture Debate iş akışında bu, eleştirmenin iki mimarın önerisini de okuması ve son adımın üçünü birden tartması demektir.

Auto model kademesinde planlama ajanları yönlendirici adımlar olarak ele alınır. Architect, Product Analyst, Project Planner, Researcher ve ADR Writer, kotanızın bulunduğu en iyi kademeyi alır; çünkü onlardan sonraki her şey bu ajanların çıktısına bağlıdır. Bkz. modeller.

Planlama ne üretir

Oturum sayfasında bir plan. Her adımın çıktısı, kendi token ve maliyet bilgisiyle birlikte canlı olarak akar. Planı, geliştirme adımı bitmeden önce okuyabilirsiniz.

Plan panosunda maddeler. Bir oturum tamamlandığında AI CodeOps, adında "plan" geçen ilk adımı (Plan, Delivery plan, UI plan, DevOps plan, Optimization plan) alır ve liste maddelerini Plan panosu kayıtlarına dönüştürür. Her kayıt, ifadesinden tahmin edilen bir önem derecesi alır, to do durumunda başlar ve hangi oturumdan geldiğini kaydeder. Başlığı panoda zaten bulunan maddeler, arşivlenmiş ve tamamlanmış olanlar dahil, atlanır; böylece bir iş akışını yeniden çalıştırmak panoyu yeniden doldurmaz. Her eşitlemede en fazla 50 madde eklenir. Bir oturum sayfası, planlayıcı çıktısını istek üzerine panoya da gönderebilir.

Önerilen bir ADR. Üç iş akışı, görev listesi yerine bir karar üretir: Architecture Debate (nihai sentezi), Discovery & Spec (üzerinde anlaşılan gereksinimleri) ve Threat Model (Record ADR adımı). Bunlardan biri tamamlandığında AI CodeOps bu çıktıyı, oturuma ve onu yazan ajana bağlı olarak proposed durumunda bir ADR olarak kaydeder. Herhangi bir şeyi karara bağlayamayacak kadar kısa çıktılar kaydedilmez. Hiçbir şey yapay zekâ öyle dedi diye kabul edilmez: ADR'yi Plan, ADRs altında accepted veya rejected durumuna bir insan taşır.

Bir Plan adımı önerdikten sonra, GET /api/plan isteğinin döndürdüğü hâliyle bir Plan panosu maddesi:

{
  "id": "pln_01JA8Z3K6W9N2Q4R7T1V5X8Y0B",
  "title": "Add input validation to the coupon field",
  "body": "Reject codes longer than 32 characters and anything outside A-Z, 0-9.",
  "severity": "medium",
  "status": "todo",
  "source": "run:wfr_01JA8YQ4M2C7H5K9P3S6V8X1ZD",
  "projectID": "checkout",
  "createdAt": "2026-10-18T09:14:02.511Z",
  "updatedAt": "2026-10-18T09:14:02.511Z"
}

Önem derecesi high, medium, low veya info değerlerinden biridir. İnsanlar ve ajanlar pano üzerinde çalıştıkça durum backlog, to do, in progress, in review, blocked ve done değerleri arasında ilerler.

İlgili kalite kapıları

Planlama, bir oturumun başlamasına izin verilen yerdir; dolayısıyla buradaki kontroller, oturumun çalışıp çalışamayacağıyla ilgilidir.

  • Çalışma alanı politikası. Herhangi bir harcama yapılmadan önce politika, iş akışının başlatılması (workflow.dispatch) ve içindeki her ajan (agent.dispatch) için kontrol edilir. Bir deny kararı oturumu durdurur. Bir ask kararı Review & Gate, Approvals altında bir onay talebi açar ve oturum, biri karar verene kadar bekler. Beklerken politikanın değişmiş olma ihtimaline karşı, oturum kuyruktan çıkarken kontrol yeniden çalışır. Bkz. onaylar ve politikalar.
  • Maliyet bütçesi. Dönemin harcaması çalışma alanının kesin limitini aştığında yeni oturumlar başlatılırken reddedilir, çalışmakta olan bir oturum ise bir sonraki model çağrısından önce durur. Bkz. maliyet kontrolleri.
  • Salt okunur dayanak. Planlama için kullanılan repo klonu asla çalıştırılmaz. Kod daha sonra, test sandbox'ında çalışır.

Bir plan tek başına bir kapıdan geçmez ya da kalmaz. Bir değişikliğin yayına alınıp alınmayacağına karar veren kapılar daha sonra gelir: testler, gerçek diff'in bulgu incelemesi ve bir insanın onayı. Bunlar kalite kapıları sayfasında anlatılır.

Sınırlar

Planlama ajanları dil modelleridir. Çalışma alanınız bir politikanın izin verdiği MCP araçlarını bağlamadıkça kodunuzu çalıştırmaz, performans ölçmez veya dış sistemleri sorgulamazlar. Bir plan yanlış olabilir ve ardından gelen kod geçişi plandan sapabilir. İçeri giren planı değil, geliştirme aşamasından çıkan diff'i inceleyin.

Sık sorulan sorular

Her oturumda planlama yapılır mı?

Yerleşik iş akışlarının çoğu, Architect'in planı veya UI Designer'ın UI plan adımı gibi bir planlama adımıyla başlar. Quality-Gated Change bunun istisnasıdır; Builder ile başlar ve yalnızca görevden yola çıkar.

Planlama ajanları kodumu görür mü?

Evet, oturum reposu olan bir projeyi hedeflediğinde. Platform repoyu salt okunur olarak klonlar ve ajanlara bir dosya ağacı ile ilgili dosyalardan bir seçki verir. Repo okunamazsa oturum, sıfırdan plan yapmak yerine başarısız olur ve nedenini söyler.

Plan sonunda nerede yer alır?

Oturum sayfasında, planlama adımının çıktısı olarak. Adında plan geçen ilk adımın maddeleri ayrıca çalışma alanının Plan panosuna eklenir; panoda zaten bulunan başlıklar atlanır.

Henüz hiçbir görev yokken bir fikri yapay zekâ ile konuşabilir miyim?

Evet. Plan panosundaki Plan with AI, bir planlama asistanıyla yapılan bir sohbettir. Plan üzerinde anlaştığınızda asistan görevleri kabul kriterleri, öncelik, önerilen ajan ve projeyle birlikte taslak olarak hazırlar. Her taslağı siz gözden geçirir ve yalnızca tutmak istediklerinizi oluşturursunuz.

Yapay zekânın yazdığı ADR'ler otomatik olarak kabul edilir mi?

Hayır. Bir oturumdan alınan ADR her zaman proposed durumuyla kaydedilir. Elle yazılmış bir karar kaydında olduğu gibi, onu accepted veya rejected durumuna bir insan taşır.

Bir politika, iş akışını başlamadan önce durdurabilir mi?

Evet. Bir çalışma alanı politika kuralı, bir iş akışının başlatılmasına veya belirli bir ajan adımının çalıştırılmasına izin verebilir, bunun için onay isteyebilir ya da bunu reddedebilir. Bir ask kararı bir onay talebi açar ve oturum bu onayı bekler.