Aidlc: Yapay Zekâ Kodlama Ajanları İçin Uyarlanabilir İş Akışı Yönlendirme Kuralları

AI-DLC: Tek Çekirdek, Çoklu Çalışma Ortamı#

Modern yazılım geliştirme süreçlerinde yapay zekâ asistanlarının kullanımı hızla artarken, üretilen kodların doğrulanabilirliği ve standartlara uyumu en kritik gereksinimlerden biri haline gelmiştir. AI-DLC (Yapay Zekâ Destekli Geliştirme Yaşam Döngüsü), yapay zekâ kodlama asistanlarını rastgele kod üreten araçlar olmaktan çıkarıp yapılandırılmış, denetlenebilir ve doğrulanabilir yazılım teslimat iş akışlarına dönüştürür.

Çalışma ortamından bağımsız (harness-neutral) tek bir çekirdek mimarisine sahip olan sistem; Claude Code, Kiro CLI, Kiro IDE, Codex CLI, Cursor, opencode ve GitHub Copilot üzerinde yerel olarak çalışabilmektedir.

Hızlı Başlangıç (Quick Start)#

En güncel kararlı AI-DLC sürümünü projenize dahil etmek için aşağıdaki iki adımlı süreci takip edebilirsiniz:

1. AI-DLC Kurulumu (Install AI-DLC)#

AI-DLC kurulumu, işletim sistemine optimize edilmiş yerel betikler aracılığıyla gerçekleştirilir:

macOS, Linux veya WSL: Terminalde curl -fsSL https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.sh | sh komutu çalıştırılır.
Windows PowerShell: Standart bir PowerShell penceresinde irm https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.ps1 | iex komutu yürütülür.

Yükleyici, AI-DLC'nin ihtiyaç duyduğu yerel aidlc komutunu ve tüm çalışma ortamı (harness) çalışma zamanlarını eksiksiz kurar. Yerel kurulum kancalarını (hooks) ve komutlarını doğrudan aidlc üzerinden çalıştırdığından, sisteminizde Bun veya Node.js kurulu olması gerekmez.

Windows üzerinde kurulum geçerli kullanıcı hesabı için yapılır ve bin dizini otomatik olarak Kullanıcı PATH alanına kaydedilir. Kurulumun normal bir PowerShell penceresinden yapılması önerilir; yönetici haklarıyla çalıştırma güvenlik sebebiyle bir uyarı görüntüler. Yeni açılan terminal aidlc komutunu bulamazsa oturum yenilenmelidir. PATH ortamındaki kalıcı ve anlık değişiklikleri atlamak için -NoModifyPath parametresi kullanılabilir. Windows kaldırma işlemi yalnızca yükleyici tarafından kaydedilen PATH girdisini temizler. macOS, Linux veya WSL ortamlarında ise gerekirse yükleyicinin PATH talimatları izlenmelidir.

Proje dosyalarını kendiniz yönetmek istediğinizde veya yerel bir çalıştırılabilir ikili dosya kuramadığınız durumlarda manuel kopyalama seçeneği mevcuttur. Bun çalışma zamanının gerekli olduğu tek yer bu senaryodur: Bun kurulur, sürüm sayfasından aidlc-copy-runtime-X.Y.Z.tar.gz indirilir ve eksiksiz runtime/harness/ dizini projeye kopyalanır. Bu yöntem yerel aidlc komutunu gerektirmez.

2. Projeyi Yapılandırma (Configure a project)#

Proje kök dizinine geçerek kullanılan çalışma ortamı tanımlanır:

Proje dizinine geçiş: cd /path/to/your-project
Ortam yapılandırması: aidlc config --harness claude
Sistem doğrulaması: aidlc doctor

Komuttaki claude değeri; kiro, kiro-ide, codex, cursor, opencode veya copilot seçenekleriyle değiştirilebilir. --harness bayrağı olmadan aidlc config çalıştırıldığında etkileşimli bir kurulum sihirbazı başlatılır.

Yazılım Geliştirme ve Öğrenme Çıkarımları#

Doğrulanabilir Teslimat: Geliştiriciler, yapay zekâ ajanlarının ürettiği kodları doğrudan kabullenmek yerine adımları izlenebilir ve test edilebilir bir yaşam döngüsüne bağlar.
Ekosistem Esnekliği: Tek bir çekirdeğin farklı IDE ve CLI araçlarında aynı mantıkla çalışabilmesi, ekiplere araç bağımsızlığı ve standardizasyon kazandırır.
Pratik Teşhis: aidlc doctor komutu, ortam uyumsuzluklarını erkenden tespit ederek ajan güdümlü geliştirme süreçlerindeki sürtünmeyi azaltır.

Bu konuyu derinlemesine öğrenmek isterseniz: Production'da Agent Güvenilirliği modülüne göz atın.