{"id":50712073,"url":"https://github.com/lokomotifai/harness-docs","last_synced_at":"2026-06-09T16:04:05.193Z","repository":{"id":358860830,"uuid":"1242597868","full_name":"lokomotifai/harness-docs","owner":"lokomotifai","description":"Düzenek Mühendisliği (Harness Engineering) — AI kod ajanları için Türkçe açık kaynak müfredat.","archived":false,"fork":false,"pushed_at":"2026-05-19T11:52:46.000Z","size":755,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-19T12:55:11.309Z","etag":null,"topics":["ai-agents","claude-code","codex","coding-agents","context-engineering","documentation","harness-engineering","mintlify","open-source","turkish"],"latest_commit_sha":null,"homepage":"https://harness.lokomotif.ai","language":"MDX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lokomotifai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-18T15:14:58.000Z","updated_at":"2026-05-19T11:52:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/lokomotifai/harness-docs","commit_stats":null,"previous_names":["lokomotifai/harness-docs"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/lokomotifai/harness-docs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lokomotifai%2Fharness-docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lokomotifai%2Fharness-docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lokomotifai%2Fharness-docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lokomotifai%2Fharness-docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lokomotifai","download_url":"https://codeload.github.com/lokomotifai/harness-docs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lokomotifai%2Fharness-docs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34114453,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","claude-code","codex","coding-agents","context-engineering","documentation","harness-engineering","mintlify","open-source","turkish"],"created_at":"2026-06-09T16:04:03.974Z","updated_at":"2026-06-09T16:04:05.188Z","avatar_url":"https://github.com/lokomotifai.png","language":"MDX","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"images/og-cover.png\" alt=\"Düzenek Mühendisliği (Harness Engineering) — AI kod ajanlarını güvenilir kılan çevreyi tasarla\" width=\"100%\"\u003e\n\n\u003cbr/\u003e\n\u003cbr/\u003e\n\n\u003cp\u003e\n  \u003cstrong\u003eAI kod ajanlarını güvenilir kılan çevreyi tasarla.\u003c/strong\u003e\u003cbr/\u003e\n  Modeli değil — modeli kuşatan düzeneği (harness).\n\u003c/p\u003e\n\n\u003cp\u003e\n  \u003ca href=\"https://harness.lokomotif.ai\"\u003e\u003cimg alt=\"Site\" src=\"https://img.shields.io/badge/site-harness.lokomotif.ai-0E1417?style=flat-square\u0026labelColor=20333C\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg alt=\"Lisans CC0-1.0\" src=\"https://img.shields.io/badge/lisans-CC0--1.0-E5FF59?style=flat-square\u0026labelColor=1A2300\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.mintlify.com\"\u003e\u003cimg alt=\"Mintlify\" src=\"https://img.shields.io/badge/built%20with-Mintlify-20333C?style=flat-square\"\u003e\u003c/a\u003e\n  \u003cimg alt=\"Sürüm 1.0.0\" src=\"https://img.shields.io/badge/s%C3%BCr%C3%BCm-1.0.0-20333C?style=flat-square\"\u003e\n  \u003cimg alt=\"Dil: Türkçe\" src=\"https://img.shields.io/badge/dil-T%C3%BCrk%C3%A7e-20333C?style=flat-square\"\u003e\n\u003c/p\u003e\n\n\u003cp\u003e\n  \u003ca href=\"#tez\"\u003eTez\u003c/a\u003e ·\n  \u003ca href=\"#i̇çerik\"\u003eİçerik\u003c/a\u003e ·\n  \u003ca href=\"#hızlı-başlangıç\"\u003eHızlı başlangıç\u003c/a\u003e ·\n  \u003ca href=\"#öğrenme-yolu\"\u003eÖğrenme yolu\u003c/a\u003e ·\n  \u003ca href=\"#kaynaklar\"\u003eKaynaklar\u003c/a\u003e ·\n  \u003ca href=\"#katkı\"\u003eKatkı\u003c/a\u003e\n\u003c/p\u003e\n\n\u003c/div\u003e\n\n---\n\n## Tez\n\nModern AI kod ajanları — Claude, GPT, Gemini — bir vakum içinde çalışmaz. Bir **düzenek (harness)** içinde çalışır: repo, durum, geri bildirim, doğrulama ve gözlemlenebilirlik. Bir görev başarısız olduğunda refleks, modeli değiştirmek olur; çoğu zaman yanlış katman.\n\n\u003e **Aynı model, farklı düzenek, farklı sonuç.** Modeli değil; modeli kuşatan düzeneği bir mühendislik problemi olarak ele al.\n\nBu repo, o düzeneği inşa etmenin **Türkçe açık kaynak müfredatıdır**. 12 teorik ders, 6 kümülatif proje, 8 üretime hazır şablon, ve bir skill paketi. Hedef kitle: Claude Code, Codex ve benzeri AI ajanlarla üretim yapan yazılım mühendisleri.\n\n## İçerik\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\" valign=\"top\"\u003e\n      \u003ch3\u003e12 Ders\u003c/h3\u003e\n      \u003cp\u003eHer ders bir anti-örüntü teşhisi: \u003cstrong\u003eyetkin ajanlar neden başarısız olur\u003c/strong\u003e, hangi mekanizma çözer, hangi saha kanıtıyla.\u003c/p\u003e\n      \u003cp\u003e\u003cem\u003e\"Aynı Model, Farklı Sonuç\" → \"Temiz Teslim\"\u003c/em\u003e\u003c/p\u003e\n      \u003cp\u003e\u003ca href=\"dersler/\"\u003e\u003ccode\u003edersler/01..12\u003c/code\u003e\u003c/a\u003e\u003c/p\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"50%\" valign=\"top\"\u003e\n      \u003ch3\u003e6 Proje\u003c/h3\u003e\n      \u003cp\u003eKümülatif Notes API üzerinde \u003ccode\u003estarter/\u003c/code\u003e + \u003ccode\u003esolution/\u003c/code\u003e zinciri. Her proje önceki çözümün üzerine \u003cstrong\u003ebir aparat\u003c/strong\u003e ekler.\u003c/p\u003e\n      \u003cp\u003e\u003cem\u003eKural önceliği → Capstone\u003c/em\u003e\u003c/p\u003e\n      \u003cp\u003e\u003ca href=\"projeler/\"\u003e\u003ccode\u003eprojeler/01..06\u003c/code\u003e\u003c/a\u003e\u003c/p\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\" valign=\"top\"\u003e\n      \u003ch3\u003e8 Şablon\u003c/h3\u003e\n      \u003cp\u003eKopyala-kullan iskelet: \u003ccode\u003eAGENTS.md\u003c/code\u003e, \u003ccode\u003ePROGRESS.md\u003c/code\u003e+\u003ccode\u003eDECISIONS.md\u003c/code\u003e, \u003ccode\u003eMakefile\u003c/code\u003e+\u003ccode\u003einit.sh\u003c/code\u003e, \u003ccode\u003efeatures.json\u003c/code\u003e, \u003ccode\u003everifier.md\u003c/code\u003e+DoD, sprint+rubrik, OTel trace, session-close.\u003c/p\u003e\n      \u003cp\u003e\u003ca href=\"kutuphane/\"\u003e\u003ccode\u003ekutuphane/\u003c/code\u003e\u003c/a\u003e\u003c/p\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"50%\" valign=\"top\"\u003e\n      \u003ch3\u003eSkill Pack\u003c/h3\u003e\n      \u003cp\u003eClaude Code / OpenClaw uyumlu yetenek paketi. Workflow + recipe + template + script — ajanın kendi reposunda düzenek kurabilmesi için.\u003c/p\u003e\n      \u003cp\u003e\u003ca href=\"skill-pack/duzenek-yaratici/\"\u003e\u003ccode\u003eskill-pack/duzenek-yaratici/\u003c/code\u003e\u003c/a\u003e\u003c/p\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## Düzeneğin temel mekanizması\n\nBir düzenek, modeli **çevre yoluyla** yönlendirir. Beş aparatı vardır:\n\n| Aparat | Sorumluluk |\n| --- | --- |\n| **Repo** | Tek hakikat kaynağı. Talimat, kod ve karar tarihçesi burada yaşar. |\n| **Durum (state)** | Oturumlar arası süreklilik. `PROGRESS.md`, `DECISIONS.md`, init script'leri. |\n| **Çalışma zamanı geri bildirimi** | Ajan kendi kodunu test eder, hataları görür, düzeltir. |\n| **Öz-doğrulama (self-verification)** | Bağımsız rol ayrımı; halüsinasyon ve \"erken zafer ilanı\" engellenir. |\n| **Gözlemlenebilirlik (observability)** | Her eylem izlenebilir; başarısızlık sessizce gerçekleşmez. |\n\n## Hızlı başlangıç\n\n```bash\ngit clone https://github.com/lokomotifai/harness-docs.git\ncd harness-docs\n\n# Mintlify CLI ile yerel önizleme\nnpm install -g mint\nmint dev\n# → http://localhost:3000\n```\n\nSearch ve AI assistant'ı yerelde etkinleştirmek için `mint login`. İçerik bütünlüğünü doğrulamak için:\n\n```bash\nmint validate         # MDX + frontmatter + nav\nmint broken-links     # iç linkler çözülüyor mu\n```\n\n## Öğrenme yolu\n\n```\n       teorik zemin          uygulama          sentez\n            │                    │                │\n   ┌────────┴────────┐  ┌────────┴────────┐  ┌────┴─────┐\n   │   12 Ders       │→ │   6 Proje       │→ │ Capstone │\n   │   (dersler/)    │  │   (projeler/)   │  │  Proje 6 │\n   └─────────────────┘  └─────────────────┘  └──────────┘\n            │                    │\n            └──── 8 Şablon ──────┘\n                (kutuphane/)\n```\n\n1. **[Ders 01 — Yetkin Ajanlar Neden Hâlâ Başarısız Oluyor](dersler/01-yetkin-ajanlar-neden-basarisiz.mdx)** ile teorik zemini kur.\n2. **[Proje 01 — Kural Öncelikli](projeler/01-yalniz-prompt-vs-kural-oncelikli.mdx)** ile farkı kendi gözünle gör.\n3. Her dersi karşılığındaki projeyle eşleştir. Capstone'a kadar düzenek üzerine düzenek inşa et.\n\n## Repo yapısı\n\n```\n.\n├── index.mdx                       # giriş\n├── dersler/        01..12          # 12 teorik ders\n├── projeler/       01..06          # 6 proje (her biri *.mdx + 0N/{starter,solution}/)\n├── kutuphane/                      # 8 şablon + genel bakış\n├── skill-pack/duzenek-yaratici/    # Claude Code / OpenClaw uyumlu yetenek paketi\n├── images/                         # OG cover + brand assets\n├── logo/                           # marka logosu\n├── style.css                       # marka paleti override\n└── docs.json                       # Mintlify konfigürasyonu + SEO/OG\n```\n\n## Deploy\n\nSite **Mintlify Cloud** üzerinde host edilir. Üretim deploy'ı yalnızca `main` dalına push olduğunda tetiklenir (otomatik).\n\n- Özel alan adı: **[harness.lokomotif.ai](https://harness.lokomotif.ai)**\n- TLS sertifikası Mintlify tarafından otomatik yönetilir\n- Search ve AI assistant entegre çalışır\n\nMintlify yapılandırması [`docs.json`](docs.json) dosyasındadır; SEO ve Open Graph yapılandırması aynı dosyadaki `seo.metatags` bloğundadır.\n\n## Kaynaklar\n\nMüfredat, birincil kaynaklara dayanır. Her ders kullandığı kaynakları **cite eder**.\n\n- Anthropic — *Effective Harnesses for Long-Running Agents*, *Harness Design for Long-Running Apps*, *Infrastructure Noise*\n- OpenAI — *Harness Engineering for Codex*\n- HumanLayer — *Skill Issue*, *Writing a Good CLAUDE.md*, *12-Factor Agents*\n- Thoughtworks / Martin Fowler — düzenek mühendisliği üzerine\n- Manus — *Context Engineering*\n- OpenHands, LangChain, OpenTelemetry GenAI semconv\n- walkinglabs — *Learn Harness Engineering* (ilham veren müfredat, CC0)\n\n## AI ajanlar için\n\nBu repo aynı zamanda AI kod ajanları için bir **referans projedir**. Kendi reposunda çalışan bir ajan şu üç dosyayı okur:\n\n- **[CLAUDE.md](CLAUDE.md)** — yönlendirici talimat dosyası (sıkı kısıtlar, konu dokümanları haritası, vardiya rutinleri)\n- **[MEMORY.md](MEMORY.md)** — projenin yapım hikâyesi, alınmış kararlar, terim haritası, sıradaki adımlar\n- **[`skill-pack/duzenek-yaratici/`](skill-pack/duzenek-yaratici/)** — başka bir repoda kullanılmak üzere kopyalanabilen yetenek paketi\n\n## Katkı\n\nHata raporu, geliştirme önerisi, çeviri — her şey memnuniyetle karşılanır.\n\n| Konu | Yer |\n| --- | --- |\n| Hata raporu / öneri | [GitHub Issues](https://github.com/lokomotifai/harness-docs/issues) |\n| Pull request kuralları | [CONTRIBUTING.md](CONTRIBUTING.md) |\n| Davranış kuralları | [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) |\n| Güvenlik bildirimi | [SECURITY.md](SECURITY.md) |\n\n## Lisans\n\n[**CC0 1.0 Universal**](LICENSE) — kamu malı. Atıf zorunlu değildir; takdir edilir.\n\n```\nDüzenek Mühendisliği (Harness Engineering) — Lokomotif.ai\nhttps://harness.lokomotif.ai\n```\n\n## Bağlantılar\n\n- **Site:** [harness.lokomotif.ai](https://harness.lokomotif.ai)\n- **GitHub:** [github.com/lokomotifai/harness-docs](https://github.com/lokomotifai/harness-docs)\n- **İlham veren müfredat:** [walkinglabs/learn-harness-engineering](https://github.com/walkinglabs/learn-harness-engineering) (CC0)\n- **İlgili koleksiyon:** [walkinglabs/awesome-harness-engineering](https://github.com/walkinglabs/awesome-harness-engineering) (CC0)\n\n\u003cdiv align=\"center\"\u003e\n  \u003cbr/\u003e\n  \u003csub\u003eDüzenek Mühendisliği · Lokomotif.ai · 2026\u003c/sub\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flokomotifai%2Fharness-docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flokomotifai%2Fharness-docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flokomotifai%2Fharness-docs/lists"}