trBaşlangıç

Başlangıç

Ön gereksinimler

  • Node.js ≥ 20.10
  • pnpm 9.x — Corepack ile: corepack enable
  • Python ≥ 3.12
  • uv Python bağımlılık yönetimi için — kurulum

Kur

git clone https://github.com/lokomotifai/lokomotif-kit.git
cd lokomotif-kit
corepack enable
pnpm install
cd packages/eval && uv sync
cd ../..

Kurulumu doğrula

pnpm typecheck
pnpm lint
pnpm test
pnpm validate:modules

Her komut temiz çıkış vermeli. Bir şey hata verirse devam etmeden önce çıktıyla birlikte issue aç.

Modül scaffold et

Modüller tam olarak bir RTCSG concern’üne ait: role, task, context, style ya da guardrail. Her composition’ın en az bir role veya task’a ihtiyacı vardır, bu yüzden kendi projende role ile başlamak iyi bir başlangıç:

pnpm -F @lokomotif/cli start -- modules new role finance/your-role

Bu komut şunları yazar:

  • modules/roles/finance/your-role.yaml — TODO marker’lı modül iskeleti.
  • modules/roles/finance/__tests__/your-role.eval.yaml — eval test placeholder.

TODO’ları gerçek pratiğe göre uyarla. Modüller gerçek pratiği yansıtmak zorundadır — kural ve arkasındaki politika için Modül Yazımı (EN canonical, TR yakında).

Modülü doğrula

pnpm validate:modules

Schema doğrulayıcısı modules/**/*.yaml dosyalarını gezer, her birini doğrular ve hataları JSON Pointer yolu ile bildirir. Yeşil bir koşu, her modülün şekil olarak doğru olduğu anlamına gelir.

Eval çalıştır

cd packages/eval
uv run lokomotif-eval run

Harness her modülü ve sibling __tests__/<name>.eval.yaml dosyasını yükler, her check’i çalıştırır ve pass/fail raporlar. Varsayılan LLM judge deterministik stub — CI API key’siz çalışır.

Flow kompoze et

Bir flow modülleri tek bir prompt’ta birleştirir:

# flow.yaml
name: kvkk-board-brief
modules:
  - roles/finance/your-role # yukarıda scaffold ettiğin role
  - contexts/finance/kvkk-compliance
  - styles/cross-industry/executive-board-brief
  - guardrails/cross-industry/pii-tr
pnpm -F @lokomotif/cli start -- compose flow.yaml

CLI sırayı R → T → C → S → G’ye kanonikleştirir, tekrarlananları siler ve tek bir prompt üretir. Her composition’ın en az bir role veya task içermesi gerekir — compose her ikisi de boşsa hata verir. Programatik kullanım için @lokomotif/sdk’dan compose() fonksiyonunu çağır.

v0.1.0’da gelen modüller. Üç Pass-1 modülü: contexts/finance/kvkk-compliance, styles/cross-industry/executive-board-brief, guardrails/cross-industry/pii-tr. Roller ve task’lar (roles/finance/aml-analyst, tasks/general/structured-summary) Pass-2 olarak v0.2.0’da gelecek — o zamana kadar kendi rolünü/task’ını yazmalısın. Bkz. ROADMAP.md.

Sonraki adımlar

  • Metod — RTCSG, Olgunluk Spektrumu, Üç-Ufuk Adaptasyon Yolculuğu.
  • Sözlük — firmanın sahiplendiği terimler, kullanım ve emekli ifadeler.
  • CLI — lokomotif komut referansı (EN canonical).
  • Blueprints — Anthropic SDK, Dify, n8n, LangGraph (EN canonical).
Hoş GeldinizMetod