# Düzenek Mühendisliği (Harness Engineering)

## Docs

- [01 — Aynı Model, Farklı Sonuç](https://harness.lokomotif.ai/dersler/01-yetkin-ajanlar-neden-basarisiz.md): Aynı model, aynı prompt, farklı çevre. Çıktı kategorik olarak farklı. Modelden önce sorgulanması gereken şey düzenektır.
- [02 — Düzeneğin Anatomisi](https://harness.lokomotif.ai/dersler/02-duzenek-gercekte-nedir.md): Düzenek (harness) bir prompt dosyası değil, model ağırlıklarının dışında kalan her şeydir: talimat, araç, ortam, durum ve geri bildirimden oluşan beş katmanlı bir mühendislik birimi.
- [03 — Repo: Hakikat Kaynağı](https://harness.lokomotif.ai/dersler/03-repo-neden-hakikat-kaynagi-olmali.md): Düzenek Mühendisliği (Harness Engineering) için repo, ajanın tek hakikat kaynağıdır. Repoda olmayan bilgi, ajan için yoktur.
- [04 — Şişmiş Talimat Sendromu](https://harness.lokomotif.ai/dersler/04-tek-buyuk-talimat-dosyasi-neden-basarisiz.md): Düzenek Mühendisliği (Harness Engineering) müfredatında dördüncü durak: tek dev AGENTS.md neden çürür, yönlendirici dosya + konu dokümanları neden çalışır.
- [05 — Vardiya Defteri](https://harness.lokomotif.ai/dersler/05-uzun-gorevler-neden-sureklilik-kaybeder.md): Bağlam penceresi sonludur, unutkanlık varsayılandır. Süreklilik ancak dosya sistemine yazılıp vardiya rutinleriyle uygulandığında ayakta kalır.
- [06 — Önce Temel, Sonra Duvar](https://harness.lokomotif.ai/dersler/06-baslangic-neden-kendi-fazina-sahip-olmali.md): Başlangıç (initialization) ayrı bir fazdır, ayrı bir optimizasyon hedefi vardır. Uygulama ile karıştırıldığında dört yerden birden çatlar. Düzenek Mühendisliği (Harness Engineering) müfredatının altıncı dersi.
- [07 — WIP=1 Disiplini](https://harness.lokomotif.ai/dersler/07-ajanlar-neden-asiriya-kacar-ve-yarim-birakir.md): Aşırıya kaçmak ve yarım bırakmak aynı madalyonun iki yüzüdür. Kanban'dan WIP=1, Little's Law ve VCR ile Düzenek Mühendisliği (Harness Engineering) bu simbiyozu kırar.
- [08 — Özellik Listesi Bir Primitiftir](https://harness.lokomotif.ai/dersler/08-ozellik-listeleri-neden-duzenegin-temel-bilesenleridir.md): Düzenek Mühendisliği (Harness Engineering) içinde özellik listesi (feature list) insan için bir not değil, scheduler, verifier, handoff reporter ve progress tracker'ın okuduğu işletim primitifidir.
- [09 — Erken Zafer İlanı](https://harness.lokomotif.ai/dersler/09-ajanlar-neden-erken-zafer-ilan-eder.md): Ajan 'tamamlandı' der; e-posta hiç gönderilmemiştir. Tamamlanma yargısı ajanın değil, Düzenek Mühendisliği (Harness Engineering) sözleşmesinin işidir.
- [10 — Üç Katmanlı Doğrulama Kapısı](https://harness.lokomotif.ai/dersler/10-uctan-uca-test-neden-sonuclari-degistirir.md): Birim testler bileşen sınırlarına mimari olarak kördür. Yalnız uçtan uca test sistem düzeyi kusurların yokluğunu kanıtlar — ve ajanın davranışını değiştirir.
- [11 — Düzeneğin Gözleri](https://harness.lokomotif.ai/dersler/11-gozlemlenebilirlik-neden-duzenegin-icinde-olmali.md): Gözlemlenebilirlik, Düzenek Mühendisliği (Harness Engineering) için sonradan eklenen bir özellik değil; runtime ve süreç olmak üzere iki paralel katmanda birlikte tasarlanan mimari bir özelliktir.
- [12 — Temiz Teslim](https://harness.lokomotif.ai/dersler/12-her-oturum-neden-temiz-durum-birakmali.md): Entropi varsayılan. Düzenek Mühendisliği (Harness Engineering) uzun vadeli güvenilirliği işletim disiplinine bağlar. Temiz state, tamamlanma tanımının parçasıdır.
- [Açık kaynak müfredat](https://harness.lokomotif.ai/index.md): AI kod ajanlarını güvenilir kılan çevreyi tasarlamak — repo, durum, geri bildirim, doğrulama ve gözlemlenebilirlik. 12 ders, 6 proje, 8 kopyala-kullan şablon.
- [AGENTS.md](https://harness.lokomotif.ai/kutuphane/agents-md.md): Repo kökündeki yönlendirici dosya: ajanın iniş sayfası, ansiklopedi değil router.
- [Makefile & init.sh](https://harness.lokomotif.ai/kutuphane/bootstrap.md): Tek komutla başlatan, tek komutla doğrulayan bir ortam aparatı için minimum çalışan iskelet.
- [features.json](https://harness.lokomotif.ai/kutuphane/features-json.md): Düzeneğin (harness) geri bildirim aparatının primitifi — scheduler, verifier, handoff reporter ve progress tracker'ın okuduğu makine-okunabilir özellik listesi.
- [Genel Bakış](https://harness.lokomotif.ai/kutuphane/index.md): Düzenek Mühendisliği (Harness Engineering) için kopyala-kullan aparat şablonları.
- [OpenTelemetry İz](https://harness.lokomotif.ai/kutuphane/otel-trace.md): Her oturum için tek bir iz — runtime gerçeğini AgentOps, Inspect AI ve Jaeger arasında taşıyabilen tek standart.
- [PROGRESS.md & DECISIONS.md](https://harness.lokomotif.ai/kutuphane/progress-decisions.md): Vardiya defteri ile gerekçe günlüğü: süreklilik kaybını yapısal olarak engelleyen iki durum aparatı.
- [Session Close & Quality Doc](https://harness.lokomotif.ai/kutuphane/session-close.md): Bir oturum ya commit ile ya rollback ile biter; ortada kalış yok. İki aparat: çıkış kontrol listesi ve modül başına sağlık tablosu.
- [Sprint Sözleşmesi & Rubrik](https://harness.lokomotif.ai/kutuphane/sprint-rubric.md): Üreten ile değerlendiren arasında kod yazımından önce kurulan ön-anlaşma ve değerlendirme varyansını düşüren A/B/C/D bant tablosu.
- [verifier.md & Definition of Done](https://harness.lokomotif.ai/kutuphane/verifier-dod.md): Tamamlanma yargısını yapandan alıp denetleyene veren iki sözleşme: verifier'ın rolü ve AGENTS.md içindeki DoD bloğu.
- [01 — Kural Öncelikli](https://harness.lokomotif.ai/projeler/01-yalniz-prompt-vs-kural-oncelikli.md): Aynı görev, iki düzenek seviyesi. Yalın prompt'tan AGENTS.md + Makefile + smoke test'e geçişin etkisini kendi reponuzda ölçün.
- [02 — Bilgi Mimarisi](https://harness.lokomotif.ai/projeler/02-ajan-okunabilir-calisma-alani.md): Bloated tek AGENTS.md'den yönlendirici dosya + konu dokümanları + per-module ARCHITECTURE.md'ye geçiş. Bilgi görünürlüğü boşluğunu kapatın.
- [03 — Vardiya Süreklilik](https://harness.lokomotif.ai/projeler/03-cok-oturumlu-sureklilik.md): Yarım kalmış bir özelliği kasıtlı bırak; süreklilik aparatları (PROGRESS.md + DECISIONS.md + init.sh + vardiya rutinleri) ile bir sonraki oturum dakikalar içinde devam etsin.
- [04 — Geri Bildirim Halkası](https://harness.lokomotif.ai/projeler/04-calisma-zamani-geri-bildirimi.md): Serbest formda features.md'den yapılandırılmış features.json + verify.sh + WIP=1 kuralına. Çalışma zamanı geri bildirimini ajan otomasyonuna bağlayın.
- [05 — Yapan ve Denetleyen](https://harness.lokomotif.ai/projeler/05-oz-dogrulama-ve-rol-ayrimi.md): Aynı kod tabanı, iki rol modeli. Tek executor'da gizli kalan PUT-404 bug'ı, yapan/denetleyen ayrımı + üç katmanlı doğrulama ile 30 saniyede yakalanır.
- [06 — Capstone: Bütünleşik Düzenek](https://harness.lokomotif.ai/projeler/06-butunlesik-duzenek-capstone.md): Beş aparat + gözlemlenebilirlik + temiz teslim, tek bir çalışan kod tabanında birleşir. Tam OpenTelemetry instrumentation, Quality.md, session_close.sh, idempotent cleanup.

## OpenAPI Specs

- [openapi](https://harness.lokomotif.ai/api-reference/openapi.json)