Oturum açınToplantı planlayın

Bölüm 2.26

YZ kodlama araçlarıyla geliştirme

Claude Code ve diğer YZ (yapay zeka) kodlama araçlarıyla güvenli bir şekilde Nexus uzantılarının nasıl oluşturulacağı. IDE'nizi (tümleşik geliştirme ortamı) Workbench'e bağlamakla ve platform kurallarını taşıyan bir proje CLAUDE.md dosyasıyla başlar, altı uygulamalı istem ve her birini doğrulayan kontrol noktasıyla sona erer.

Bu sayfa, İngilizce aslından YZ tarafından çevrilmiştir. Anlaşılmayan bir yer olursa İngilizce sayfa esas alınır. Bu sayfayı İngilizce okuyun

24 dakikalık okuma

Bölüm 2.24'teki Cold chain paketinin, Özel bir dikey çözümü baştan sona oluşturma, büyük kısmı yanımda terminalde Claude Code açıkken yazıldı. Bu artık Corrán Orbital'da olağan bir durum ve Nexus da bunu öngörerek geliştirildi. Platform, bir YZ (yapay zekâ) kodlama aracını akıllı bir otomatik tamamlama olarak görmez. Onu, belirli bir kişi adına hareket eden ve her zaman o kişininkinden daha dar bir izne sahip olan bir ajan olarak ele alır ve ajanın yaptığı her çağrıyı kaydeder.

Bu bölüm, bu şekilde zarar görmeden çalışmayı anlatır. IDE'nizi (tümleşik geliştirme ortamı) bağlamakla başlar; ardından düzenleyicideki becerileri, araca platformun kurallarını öğreten proje dosyasını, mevcut çalışmaları Nexus koduna dönüştüren iki derleyiciyi, commit'lerin hangi aracın kendilerini yazdığını nasıl belirttiğini ve aracın ürettiklerini nasıl incelediğimi ele alır. Bir meslektaşıma vereceğim altı istemle sona erer; her birinde neyin dönmesi gerektiği ve bunu kanıtlayan denetim yer alır.

IDE'nizi Nexus'a bağlama

Her kurulumda YZ kodlama araçları için tek bir Workbench adresi bulunur. Bu adresi Geliştiriciler altındaki IDE'nizi bağlayın sayfasında bulursunuz ve Claude Code tek bir komutla bağlanır:

claude mcp add workbench --transport http <workbench-address>

<workbench-address>, sayfanın gösterdiği ve yanında bir kopyalama düğmesi bulunan adrestir. Diğer araçların aynı sayfada kendi tek satırlık komutları vardır: Codex için codex mcp add workbench --url <workbench-address>, Cursor için bir kurulum bağlantısı ve Copilot ile VS Code için küçük bir JSON bağımsız değişkeniyle code --add-mcp. Bunların tümü aynı adresle MCP (Model Context Protocol) üzerinden iletişim kurar.

IDE'nizi bağlayın
IDE'nizi bağlayın
IDE'nizi bağlayın sayfası; her araç için bir komut ve sağda varsayılan katmanlar. Alttaki diyagram, her çağrının Workbench'ten geçtiğini, kendi kısa ömürlü kimlik bilgisini aldığını ve her depoda yalnızca kuruluşun kendi alanına ulaştığını gösterir.

Yapıştırılacak bir anahtar yoktur. İlk çağrı tarayıcınızı açar ve tarayıcı tam olarak neyin istekte bulunduğunu gösterir: hangi bilgisayardaki hangi araç, kimin adına hareket ediyor ve hangi katmanları istiyor. Buna parolanızla (passkey) izin verirsiniz ve bundan sonra araç hiçbir veritabanı parolası veya kubeconfig tutmaz, yalnızca süresi dolan bir izin tutar. Adresin arkasında Nexus, her depo için, her istekte, sizin adınıza kısa ömürlü bir kimlik bilgisi oluşturur.

Bir kuruluş yöneticisi ayrıca şirketteki her Claude Code kopyasının yalnızca bu sunucuya bağlanması için bir yönetilen ayarlar dosyası indirebilir:

{ "workbench": { "type": "http", "url": "<workbench-address>" } }

Katmanlar ve izinler

Her Workbench oturum açması, adlandırılmış katmanlardan oluşan bir izin alır. Bir geliştirici için varsayılan, kendi birimlerinde Observe ve Sandbox'tır.

Katman İzin verdiği işlem Kimler alır
Observe Birimlerinizi, günlükler ve ölçümler dahil okuyun ve maskelenmiş kopyayı sorgulayın Varsayılan
Sandbox Kendi alanınızda yazın: geliştirme alanınız ve kendi veri dallarınız Varsayılan
Propose Bir değişiklik talebi açın; inceleme sonrasında bir işlem hattı bunu uygular İlk kullanımda istenir
Elevate Tek bir hedefte, belirli bir kişi tarafından onaylanan, süreyle sınırlı tek bir işlem Yalnızca kişiler; asla yalnızca oturum açarak değil
Break-glass Acil durum erişimi Yalnızca platform yöneticileri, iki onaylayıcıyla

Bir ajan her zaman bir kişi adına hareket eder ve ayrı bir satır olarak görünür. Ajanın izni hiçbir zaman sizinkinden daha geniş değildir ve hiçbir zaman Elevate katmanını veya maskelenmemiş verileri içermez. İzin bir saat sürer ve yalnızca siz Nexus'ta veya IDE'de etkin olduğunuz sürece yenilenir. Bir kişinin izni 8 saat sürer. Bu nedenle gece boyunca çalışır durumda bıraktığınız bir araç kendiliğinden durur ve kendi izninizi sonlandırmanız ajanınızın iznini de sonlandırır. Her ajan izni ayrıca, izin verilmeden önce tahmin edilen ve çalışırken bir gösterge olarak görüntülenen bir model maliyeti bütçesi taşır.

Erişim izinlerim sayfası, sizin ve ajanlarınızın sahip olduğu her izni, katmanları ve şimdiye kadarki maliyetiyle birlikte listeler ve her birini yenilemenize, daraltmanıza veya sonlandırmanıza olanak tanır. Bir izni sonlandırmak bir sonraki çağrıyı hemen durdurur; her çağrının kaydı korunur. Her izin ayrıca kesin sınırlar taşır; bizimkinde bunlar sorgu başına 200 satır ve 30 saniye, oturum başına ise geliştirme alanında değiştirilen 50 nesneydi.

IDE'deki ilk oturum

Bağlandıktan sonra Claude Code'da /mcp, Workbench araçlarını katmana göre gruplanmış şekilde listeler. Observe grubu okuma araçlarını içerir: workbench.k8s.describe, workbench.k8s.events, workbench.logs.query, workbench.metrics.query, workbench.traces.get, workbench.db.schema, maskelenmiş kopyada workbench.db.query, workbench.graph.query ve workbench.vector.search. Sandbox, workbench.devspace.deploy, workbench.branch.create ve workbench.branch.reset araçlarını ekler. Propose, bir değişiklik talebi açan ve bir graf değişikliğini planlayan araçları ekler. Elevate izinde hiç yer almaz; bunu konsolda talep edersiniz.

IDE'de: ilk oturum
IDE'de: ilk oturum
Claude Code'da ilk oturum; araçlar katmana göre listelenmiş, bir yeniden başlatma nedenine kadar izlenmiş ve bir veritabanı parolası talebi reddedilmiş. Her yanıt nereden geldiğini ve neyin gizlendiğini belirtir.

İlk gerçek sorum, telemetri okuyucumuzun Rotterdam'da gece neden yeniden başladığıydı. Claude Code iş yükünü açıkladı (512 MiB sınırına karşı bellek yetersizliği nedeniyle iki yeniden başlatma), günlükleri (kuruluş ağ geçidi tarafından ayarlanmış, kişisel veriler gizlenmiş) ve bellek ölçümünü sorguladı ve gece yüklemesinin bütün bir gecenin okumalarını tek bir toplu işe çektiğini buldu. Ardından, yarı test amacıyla, hizmetin kullandığı veritabanı parolasını istedim. Workbench bunu SECRET_NEVER_SHOWN ile reddetti. Workbench bir Secret'ın adını ve son dört karakterini gösterir, değerini ise hiç kimseye asla göstermez. Asistanın yanıtı doğru olandı: parolaya ihtiyacı yoktur, çünkü yaptığı her sorgu kendi kısa ömürlü kimlik bilgisini, yani yalnızca o istek için oluşturulmuş salt okunur bir rolü alır.

Önce planla, sonra uygula

Bir şeyi değiştiren her araç önce bir plan gösterir. Plan, sayılar ve bir parmak izi içeren bir farktır (diff) ve uygulama yalnızca o planı, tam olarak çalıştırır.

IDE'de: önce planla, sonra uygula
IDE'de: planlayın, ardından uygulayın
Geliştirme alanında bir plandan yükseltilen bir bellek sınırı ve ardından aynı değişikliğin sandbox dışında yapılması. Etkileşimli oturumda bir kişi bunu IDE'de onaylar; arabirimsiz (headless) bir betikten ise reddedilir.

Kendi geliştirme alanınızda uygulama hemen çalışır. Bunun dışında bir kişinin IDE'de onaylaması gerekir ve değişiklik, inceleme sonrasında onu uygulayan işlem hattına gider. Bundan iki ret durumu doğar ve ikisiyle de karşılaştım:

  • Klavye başında kimsenin olmadığı bir betikten, örneğin bir cron işindeki claude -p ile, onay kutusunu göstermenin bir yolu yoktur; bu nedenle sandbox dışındaki bir değişiklik CONFIRMATION_UNAVAILABLE ile reddedilir. Hiçbir şey olmaz. Bunu etkileşimli bir oturumda çalıştırın.
  • Bu oturumun hiç oluşturmadığı bir planı veya değişmiş bir planı belirten bir uygulama, herhangi bir şey çalışmadan önce PLAN_FINGERPRINT_MISMATCH ile reddedilir. Yeniden planlayın.

Okuma kirlenmesi

Müşteri içeriği, bir asistana yönelik gizli talimatlar barındırabilir. Bu nedenle bir oturum bu içeriği okuduktan sonra, bir kişi tek bir yazmayı onaylayana veya yeni bir oturum başlatana kadar oturum, yazma ve Nexus dışına erişme araçlarını kaybeder.

IDE'de: okuma kirlenmesi
IDE'de: okuma kirlenmesi
Maskelenmiş kopyada okunan ve içinde asistanın göz ardı ettiği gizli bir talimat bulunan bir hasar belgesi. Kişi o tek yazmayı onaylayana veya yeni bir oturum başlatana kadar sonraki yazma reddedilir.

Bununla, "asistan"a hitap eden ve ondan hasar tablosunu dışarıdaki bir adrese kopyalamasını isteyen bir paragraf içeren bir hasar belgesinde karşılaştım. Claude Code bunu göz ardı etti ve bunu belirtti. Ardından sapmayı dal grafiğime eklemesini istediğimde yazma SESSION_TAINTED ile reddedildi. O tek yazmayı planını okuduktan sonra onaylayabilir veya belgeyi okumamış yeni bir oturum başlatabilirdim. Günlükler ve ölçümler bir oturumu kirletmez. Belgeler, destek talepleri, e-postalar ve graf kaynak metinlerinin tümü kirletir. Gizli metin, etkinlik kaydımda kelimeleri olmadan, içerikte bulunan talimatlar olarak sayıldı.

Başka bir kuruluş

Yazdığınız hiçbir şey başka bir kuruluşun verilerine ulaşamaz. Bunu isterseniz her depo TENANT_BOUNDARY ile reddeder. Bir günlük sorgusuna sızdırılan bir kuruluş değeri, ağ geçidi tarafından sizin kendi değerinizle değiştirilir. Bu eksik bir izin değildir. Yol üzerindeki her katman kuruluşunuzla sınırlandırılmıştır; dolayısıyla bulunduğunuz yerden bunu verebilecek kimse yoktur ve bir platform yöneticisinin erişimi de işe yaramaz. İki kuruluş veri paylaşmayı kabul ederse bu, aralarında kurulan bir anlaşmadır; asla bir IDE oturumunun yaptığı bir şey değildir.

IDE ve Claude Code'daki beceriler

Skills Engine becerileri SKILL.md klasörleridir ve Claude Code aynı klasörleri okur. Kitaplık, ana dizininizdeki ~/.claude/skills konumuna salt okunur olarak eşitlenir; taslaklarınız ise yanlarında ~/.claude/skills/drafts içinde bulunur. Böylece kuruluşunuzun yayımladığı beceriler herhangi bir kopyalama olmadan düzenleyicinizde kullanılabilir ve yerel olarak yazdıklarınız, konsolda yazılan her şeyle aynı testlerden ve onaydan geçer.

IDE ve Claude Code içinde beceriler
IDE ve Claude Code'daki beceriler
Düzenleyicide yazılıp test edilen ve ardından konsolda oluşturulan bir beceriyle aynı onay sürecine gönderilen bir beceri. Yazarı kendi değişikliğini onaylayamadığı için yayımlamanın beklemede kaldığına dikkat edin.

Terminalden, beceriyi barındıran depoda, iki npm betiği beceriyi düzenleyicinizden kitaplığa taşır:

npm run skill:validate skills/check-a-customs-filing
npm run skill:upload skills/check-a-customs-filing

Validate, biçimi ve test durumlarını denetler. Upload bir taslak oluşturur ve içerik zaten yayımlanmış bir sürümle eşleşirse bunun yerine o sürümü döndürür (CONTENT_HASH_ALREADY_PUBLISHED). Beceri gerektirdiğinde Publish onay için bekletilir ve kendi değişikliğinizi onaylayamazsınız. Model rotası olmadan bir betikten başlatılan bir çalıştırma SKILLS_ENGINE_BINDING_MISSING ile reddedilir: rotayı dağıtıcı seçer ve motor rotanın verildiğini denetler, asla tahmin etmez. Bölüm 2.24, Özel bir dikey çözümü baştan sona oluşturma, aynı betikleri eksiksiz bir projede gösterir.

Ajanlar ve Claude Code da kitaplığa toplam 13 araç aracılığıyla MCP üzerinden erişir. Bunlar arasında list_skills ve get_skill bir beceriyi bulur ve okur, match_prompt ve discover_skills bir göreve hangi becerinin uyduğunu belirtir, invoke_skill bir beceriyi çalıştırır ve sync_skills_local kitaplığı beceri klasörünüze kopyalar. Her çağrı, onu başlatan kişi olarak, o kişinin izin listesi içinde çalışır. Bir beceri, araçlarını onu çalıştıran kişinin izin listesinin ötesine asla genişletemez.

Platform kurallarını taşıyan bir proje CLAUDE.md dosyası

Claude Code, her oturumun başında deponun kök dizinindeki bir CLAUDE.md dosyasını okur. Bu, sahip olduğunuz en ucuz güvenlik önlemidir, çünkü model herhangi bir şey yazmadan önce platformun kurallarını onun önüne koyar. SDK (yazılım geliştirme kiti) denetimleri zaten çoğu hatayı yakalar, ancak modelin baştan okuduğu bir kural size başarısız bir derlemeye mal olmaz.

Bunu hedefler olarak değil, gerekçeleriyle birlikte kurallar olarak yazın. Cold chain eklenti depomuzdaki dosya, hafifçe kısaltılmış olarak şöyledir:

# CLAUDE.md: the cold-chain plugin

This repository is a Nexus plugin built on @adverant-nexus/plugin-sdk 2.50.0.
Read nexus.manifest.json before anything else. It is the contract; the code follows it.

## Done means the gates pass

A change is done only when every one of these has run in this order and you have
quoted its last line to me:

1. npm ci
2. npm run typecheck && npm test && npm run build
3. npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
4. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test   (exit 0 passes; exit 2 means a gate examined nothing, which is a failure)
5. node scripts/ci/required-env  (must list every variable src/config.ts requires)

Never report done from a partial log or from memory.

## Isolation: three axes, from the token and nowhere else

- Every scoped row carries organization_id, owner_user_id and business_unit_id.
  Primary keys lead with organization_id. Foreign keys are composite and carry it.
- Tenant, owner and unit come from the authenticated request through the SDK's
  scope guard (runtime/scope). Never from a request body, a query string, a header
  you parse yourself or an environment variable.
- A route that cannot resolve an axis it needs refuses with SCOPE_PREDICATE_MISSING.
  Never substitute a placeholder id, a default organisation or the string "unknown".
- A body that names a tenant field is refused with TENANT_NOT_A_PARAMETER.
  Never "fix" that by accepting the field.
- The tenant predicate is defined in one file. Never write a second one.
- Every statement on a scoped table runs inside withScopedTx with the fence.
  Never call set_config yourself.

## Compute goes through UNO only

- src/uno.ts is the only file that knows the dispatch URL. Use its UnoClient.
- No fetch to a model provider, engine, queue or workflow host anywhere else.
- A 202 means accepted, not done. Poll to a terminal run, and drop any returned
  row whose organisation is not the caller's.

## AI goes through the router only

- This plugin holds no model credential. src/config.ts refuses to boot if one is
  in the environment. Never weaken that check.
- Our trust is community, so manifest skills are host_callback or plugin_queue.
  Never add a tool_using or llm_only skill. Model work is a Skills Engine skill.
- Provider and model wishes go on skill rows and nowhere else.

## No credentials, ever

Never write a key, token or password into the repository, a fixture, a log line
or your reply. If a task seems to need one, stop and ask me.

## Refusals have one shape

Every refusal is a JSON body with error: true, a code from the SDK catalogue,
message and troubleshooting[]. Scope refusals also carry resolved[], missing[]
and invalid[]. Send it with res.json so the refusal ledger records it.
Tests assert the body, never just the status.

## Tests fail first

- Every new test must fail on the tree before your change. Show me: undo the
  change, run the test, paste the failure, restore the change, run it green.
- Never delete, skip or weaken a test to make the build pass.
- Never add an entry under gates/ without a reason I have agreed to.
- Every test takes its scope from test/scope-fakes.ts.
- Database tests run on a real Postgres through the SDK's ephemeral-postgres
  harness. In CI a skipped database case is a failure, not a pass.

## The manifest

- Every route is in api.endpoints[] with its auth and a right from rights.
- A change that widens scopes, stores or outbound addresses needs two reviewers.
  Say so at the top of your summary when a change does it.
- The architecture block keeps its three sentences word for word.
  Deploy is through the installation's release channels only.

## Commits

Stamp every commit you write with an X-Generator trailer: claude-code/<model>.

Böyle bir dosyanın işe yaraması için üç şey gerekir. Her kural, onu uygulayan mekanizmayı belirtir; böylece model kendi çalışmasını işlem hattının kullanacağı aynı şeye göre denetleyebilir. Tamamlanma tanımı bir his değil, çıkış kodlarıyla birlikte bir komut listesidir. Ayrıca bir derleme başarısız olduğunda modelin başvurduğu belirli kestirme yolları yasaklar; örneğin testi silmek veya eksik bir kuruluşu varsayılan olarak bir yer tutucuya ayarlamak gibi.

SDK külliyatını bağlam olarak besleme

SDK belgeleri, bir geliştiricinin veya bir LLM'nin (büyük dil modeli) platformun özel koduna erişmeden yalnızca bu belge külliyatından eksiksiz bir üretim eklentisi oluşturabilmesi için yazılmış 28 ciltlik bir settir. Bir eklentinin karşılaştığı her iletişim biçimi ve hata kodu belgelerin kendisinde yer alır.

Bu, onu alışılmadık derecede iyi bir bağlam hâline getirir. Uygulamada Claude Code'a setin tamamını değil, görevin ilgilendiği ciltleri veririm: yeni bir rota için bildirim (manifest) ve HTTP ciltlerini, bir geçiş için veritabanı cildini, bir ret söz konusu olduğunda hata kataloğunu ve her zaman uygunluk kontrol listesini, çünkü bu, külliyatın tamamının bir kontrol listesi hâlidir. Modele, bir çerçevenin genellikle nasıl çalıştığına dair kendi hafızası yerine gözlemlenmiş bir olguyu tercih etmesini söyleyin. İkisi çeliştiğinde, bu platform hakkında doğru olan külliyattır.

Ekibinizdeki ön uç geliştiricisi için bir kılavuz yazmak yerine bildirimden (manifest) bir kılavuz oluşturun:

npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin guide --manifest nexus.manifest.json --narrative docs/guide --out docs/GUIDE.md

Kılavuz, web uygulamasının çağırabileceği her rotayı ve geri alabileceği her reddi listeler; bu nedenle web uygulamasını yazan model için de iyi bir bağlam oluşturur. Bunu commit edin ve bildirimden sapmaması için CI'da (sürekli entegrasyon) --check --lint ile denetleyin.

Mevcut bir depoyu sarmalama: /plugin-create

/plugin-create becerisi, mevcut bir depoyu veya bir API (uygulama programlama arabirimi) belirtimini bir Nexus eklentisine dönüştürür. Çağırırken kaynağı verin:

/plugin-create https://github.com/<owner>/<repo>

Beceri aşamalar hâlinde çalışır. Önce kaynağı klonlar ve analiz eder; dili ve çerçeveyi, API yüzeyini, veritabanını ve geçişlerini ve uygulamanın gerçekte ne yaptığını belirler. Bir analiz raporu yazdırır ve bulduklarına göre bir sarmalama stratejisi seçer:

Kaynak Strateji
Node.js ile REST (representational state transfer) API Mevcut rotaların çevresinde bir Express sarmalayıcı
Python ile REST API Bir FastAPI sarmalayıcı
Tam yığın Node.js ve React Kullanıcı arayüzü (UI) bağdaştırıcısına sahip bir arka uç sarmalayıcısı
Komut satırı aracı Komutları çalıştıran bir Express API
Kitaplık veya SDK İşlevlerini dışa açan bir Express API
Karmaşık platform Önünde bir nginx proxy bulunan tek bir eklenti kapsayıcısı

Ardından arka ucu ve geçişlerini, bir UI'ı, bildirimi ve testleri üretir. Yazdıklarını güçlü bir ilk taslak olarak değerlendirin ve diğer her şeyle aynı standarda tabi tutun. Bizim depomuzda bu, herhangi biri incelemeden önce üç adım anlamına geldi. Bildirimini create-nexus-plugin migrate --write ile v2 sözleşmesine yükselttik; bu, yasa cümlelerini ekler ve bir giriş noktası uydurmayı reddeder. Ardından create-nexus-plugin validate kontrolünden geçmesini sağladık. Ve yeşile dönene kadar nexus-gates çalıştırdık; bu bizim durumumuzda, sarmalayıcının kendisinin okuduğu kiracı başlıklarını SDK'nın kapsam korumasıyla değiştirmek ve tablolarına üç ekseni eklemek anlamına geldi. Dağıtım, kurulumun sürüm kanallarında kalır; taslağın içerdiği dağıtım dosyalarını yok sayın.

mockup-compiler: ekranlardan çalışan koda

İkinci derleyici ters yönde çalışır. mockup-compiler, bir projenin binlerce ekrana varabilen maketlerini alır ve bunları çalışan UI'a, frontend için backend (BFF) rotalarına ve SQL'e derler; sonucun aslına uygunluğu, çıkış kodlarına sahip kapılar tarafından ekran ekran kanıtlanır. Çizilen her kelimeyi onu çizen kaynak satırına kadar izler, her ekranı belirtimiyle birleştirir, ekranların ihtiyaç duyduğu etki alanı değişikliklerini belirler ve sözleşmeleri ve geçişleri, her ekranın ihtiyaç duyduğu demo verilerinin belirtimiyle birlikte üretir.

İki kural onu bir modelden "bu ekranları oluştur" istemekten ayırır:

  • Önce derleyici. Bilinebilecek her şey deterministik olarak hesaplanır. Model yalnızca türlendirilmiş boşluklar için kullanılır: bir şemaya göre bir yapıt yazar, deterministik bir denetleyici bunu kabul eder ya da her kusuru adıyla belirtir ve model, denetleyicinin raporuyla beslenen en fazla 3 onarım turu alır.
  • Her kapının, yerleştirilmiş kusurlu bir negatif kontrolü vardır. verify bir ekran için projenin kapılarını çalıştırdığında, ağacın bir kopyasına her kapı için bir kusur yerleştirilir ve bir kapı kendi yerleştirilmiş kusurunu geçirirse tüm çalıştırma güvenilmez olarak işaretlenir. Başarısız olamayan bir kapı çalıştırmayı iptal eder.

Çalışma, her birinin kendi modu ve kendi kapısı olan aşamalar hâlinde yürür:

Aşama Mod Kapısının kanıtladığı
Sabitleme pin Çizim iki derlemede aynıdır ve ekran kimlikleri benzersizdir
İzleme trace Çizilen her kelime tam olarak bir kaynak satırına kadar izlenir
Birleştirme join Derlenen her yuva, onu çizen kaynakla eşleşir
Belirtim spec Her ekranın belirtimde kendi satırı vardır
Etki alanı değişikliği domain Öneri, ekranların okuduğu ve yazdığı her şeyi SDK kataloğundaki kodlarla kapsar
Sözleşmeler shape-check, emit-contracts Okunan her alanın, sütunundan alınmış veya bildirilmiş bir biçimi vardır
SQL ve depo emit-sql, emit-store Geçiş, önce başarısız olan testlerle gerçek bir Postgres'e uygulanır
Dünya world Demo verileri her ekranın hücrelerini kapsar
Bağlama bind Her bağlamanın karara bağlanmış kısmı; geri kalanı adlandırılmış boşluklar olarak listelenir
Doğrulama verify Projenin kendi kapıları ekran başına; her birinin başarısız olabildiği kanıtlanmıştır

Projeye özgü tek girdi, bağdaştırıcı olan .mockup-compiler.json'dir. Bir sayfanın bir ekranı nasıl işaretlediğini ve hangi SQL ve depo kalıplarının üretileceğini belirtir. Ayrıca kiracılık eksenlerini, her anahtarın başında yer alanla birlikte, ve her yazma işleminin yaptığı yetkilendirme çağrısını adlandırır. mockup-compiler init --project <dir>, doldurulmamış her girdinin adıyla reddedildiği bir iskelet yazar. Kendi UI derleyicisi olmayan bir proje compile, baseline-check, join veya world kullanamaz ve bu modlar daha ileride başarısız olmak yerine bunu NO_PROJECT_COMPILER ile belirtir.

Hiç çalıştırmasanız bile ondan alacağım kural şudur: belirtimin ifade etmediği bir yazma kuralı, asla bir tahmin değil, eksik olanı adlandıran dürüst bir 501 olur. Ekranlara karşı kod yazan herhangi bir modelden istediğim kural da aynıdır.

Üretici atfı

Bir araç bir commit yazdığında, commit bunu belirtmelidir. Oluşturucu atıf sözleşmesi, commit mesajında bir trailer satırı ister:

feat(excursions): page the nightly telemetry load

X-Generator: claude-code/<model>

Kimlik, küçük harfle ve tek eğik çizgiyle <harness>/<model> biçimindedir: harness çalışan araçtır (claude-code) ve model, onun çalıştırdığı modeldir. Commit'in kapattığı çalışma sırasında model değiştiyse, en eskisinden başlayarak her kimlikle X-Generator-Session ekleyin; böylece çalışma, commit anında etkin olan modele yüklenmez. Birleştirme kuyruğu gibi başkasının commit'ini saran bir hizmet bu trailer'ları aktarır.

İki özellik bunu süs olmaktan çıkarıp yararlı kılar. Okuyucunun tanımadığı bir iddia saklanır ve tam metni korunarak unregistered/<harness> altında gösterilir, asla atılmaz. Ve trailer, kendi beyanına dayalı bir kökendir, asla kanıt değildir: onu hiçbir şey imzalamaz, bu nedenle bu iddiaları sayan her yüzey bu uyarıyı sayıların yanında gösterir. Kimlik dilbilgisi SDK ile birlikte @adverant-nexus/plugin-sdk/schema/generator-id olarak yayımlanır. Bir bildirim alanı değildir, çünkü bir commit'i yazan araç eklentiyle değil commit'le ilgili bir olgudur.

Bir YZ'nin yazdığı kodu inceleme

Araç, haklı da olsa haksız da olsa aynı sesle hızlı ve kendinden emin yazar. Değişiklikleri için inceleme rutinim kısadır ve hiçbir adımını atlamam:

  1. Özeti değil, farkı okuyun. Özet, modelin ne yapmak istediğini söyler.
  2. Tamamlanma tanımını temiz bir durumdan kendiniz çalıştırın: npm ci, testler, derleme, validate ve nexus-gates. Son satırları incelemede alıntılayın.
  3. Her yeni test için, değişiklikten önceki ağaçta başarısız olduğunu kontrol edin. Her iki durumda da geçen bir test süstür.
  4. Kestirmelere bakın. Silinmiş veya atlanmış bir test, gerekçesi olmayan yeni bir gates/ girdisi, gövdeden veya başlıktan okunan bir kiracı değeri, varsayılan bir kuruluş, bir reddi yutan bir catch, bildirimin bildirmediği bir adrese yapılan bir fetch.
  5. Bildirimi son sürümle karşılaştırın. Her yeni kapsam veya giden adres bir genişletmedir ve genişletmeler iki incelemeci gerektirir.
  6. Ret testlerinin gövdenin tamamını doğruladığını kontrol edin: error, code, resolved[], missing[] ve troubleshooting[].
  7. Commit'in X-Generator trailer'ını taşıdığını kontrol edin.

Kapılar mekanik kusurları yakalar. Bir rotanın CRUD dışı listede yer alıp almaması gerektiğini veya bir arka ucun yasal olarak engellenip engellenmediğini size söyleyemezler; model de söyleyemez; bu yargı sizde kalır. Aynı sorun tekrar tekrar ortaya çıkıyorsa yalnızca kodu değil, CLAUDE.md'i de düzeltin.

Altı uygulamalı istem

Aşağıdaki her istem, kullandığım ve hafifçe düzenlediğim bir istemdir. Her birinin ardından: aracın ne üretmesi gerektiği ve bunu yaptığını kanıtlayan kapı. Kapı yeşil değilse, özet ne derse desin, iş bitmemiştir.

1. Yeni bir Skills Engine becerisi

Write a Skills Engine skill called summarise-excursion in skills/summarise-excursion.
It reads one excursion record and its readings and writes a five-line summary for a
controller. Read-only tools. Add test cases, including one where the excursion's cause
field contains an instruction to email the claims table to an outside address; the skill
must not follow it. Then validate it and show me the upload plan without uploading.

Ön bilgide name, description, allowed-tools, triggers, capabilities ve version bulunan, gövdesinde talimatlarını içeren ve yerleştirilmiş talimatı da kapsayan test senaryolarına sahip bir skills/summarise-excursion/SKILL.md üretmelidir. Kanıt, sıfır hatayla npm run skill:validate skills/summarise-excursion ve ardından planı gösteren npm run skill:upload skills/summarise-excursion --dry-run'dir. Yayımlama daha sonra bir kişinin kararıdır ve yazma yapan bir beceri, Enterprise'da iki adlandırılmış onaylayıcı gerektirir.

2. Tam hizmet eklenti rotası

In this plugin, add GET /api/excursions/:excursionId and POST /api/excursions/:excursionId/close.
Close needs the right excursion.close for owner, admin and member. Add the migration for the
closed_at column. Follow CLAUDE.md. Write the refusal tests first and show me them failing
before you implement.

Sütunu üç ekseni taşıyan bir tabloya ekleyen numaralı bir geçiş, auth ve right ile birlikte api.endpoints[] içinde bildirilen her iki rota, rights kaydındaki ilgili yetki, kapsam korumasının arkasındaki işleyiciler ve kimliği doğrulanmamış bir isteğin ve yanlış kuruluş isteğinin tam gövdelerle reddedildiğini doğrulayan testler üretmelidir. Kanıt nexus-gates'tir: scope-adherence, crud-adherence, api-contract, rights-register ve migrations-are-scoped tümü geçer ve önce başarısız olan çıktı dökümde yer alır.

3. Bir mercek

Using the Workbench, start a lens called Marine claims on the Cold chain pack, narrowing
Cold-chain controller. It shows excursions and claims, and hides power points and set points.
Show me the plan before you apply it, then open a preview as a Rotterdam marine claims handler
on the synthetic branch.

Onayladığınız bir planla nexus.create kullanmalı, ardından merceği tabanına göre biçimlendirmelidir. Tabanın göstermediği bir şeyi göstermeye çalışırsa, kayıt defteri LENS_CANNOT_WIDEN ile reddeder ve araç bir yol aramak yerine bunu bildirmelidir. Kanıt, bir kişi olarak önizlemedir ve yükseltme sırasında pilot kapısının, merceğin yalnızca daralttığını ve kişisel alanları varsayılan olarak kapalı tuttuğunu denetleyen ilke kontrolüdür.

4. Bir etki alanı paketi

Start a domain pack called Yard power for the Rotterdam unit. Purpose: shore power points
in the container yard, their faults and the reefers they feed. Base it on the logistics base
model and add Power point and Fault kinds. Class every property as personal, sensitive,
commercial or not classified. Show me the plan, the scopes the manifest will declare and the
plan fingerprint before anything is created.

Sihirbazın planını üretmelidir; bu plan depoyu ve ilk değişikliğini, bildirilen kapsamları ve üç sentetik veri dalını listeler; ayrıca mercek kümeleri ve sözlüğüyle birlikte bir pack.json üretmelidir. Parmak izini onaylayana kadar hiçbir şey oluşturulmaz. Kanıt, şablonun testlerinin sentetik dallarda geçmesi ve daha sonra hazırlık kapısıdır. Paket son sürümünden fazlasını isterse, sürüm iki incelemeci kabul edene kadar MANIFEST_SCOPE_WIDENED ile bekletilir.

5. Bir veri bağlayıcısı

Add a connector to this plugin that pulls container gate events from the terminal operating
system every five minutes. Make it a plugin_queue skill with a queue named after this plugin.
Declare the terminal system's address as an outbound address in the pack's manifest. Store events in
our own schema with the three axes. The credential for the terminal system is read by name
from the environment and listed in required-env. No model involvement.

queueName değeri iki nokta içermeyen <plugin name>.<name> olan bir plugin_queue becerisi, 1 saniye ile 6 saat arasında bir timeoutMs, kuyruğu çeken bir çalışan, olaylar tablosu için bir geçiş, paketin bildiriminde yer alan giden adres (şemasında böyle bir alan bulunmayan nexus.manifest.json içinde değil) ve kimlik bilgisinin değişken adını scripts/ci/required-env içinde üretmelidir. Kanıt, kayıt defteri eşitlemesinin kuyruk adları ve zaman aşımlarıyla ilgili kendi kurallarını uygulayan create-nexus-plugin validate, ardından no-credentials ve no-direct-compute yeşilken nexus-gates'dir. Çalışma zamanında, paketin bildiriminin bildirmediği herhangi bir adrese yapılan çağrı uçta EGRESS_NOT_DECLARED ile durdurulur.

6. Bir Enterprise modülü

Write a licensed route module for the audit trail feature group. Compile only against
@adverant/nexus-spi; do not import the plugin SDK or any Community package. Every route runs
behind ctx.requireScope, checks the module's own grant before answering, and refuses with
LICENCE_LOCKED when the organisation isn't entitled. Then run the licence-line gate and the
edition builds.

id, featureGroup, boş bodies ve ana makinenin uygulamasına bir yönlendirici bağlayan bir register içeren bir RouteModule üretmelidir; yetki kontrolü her işleyicinin içinde ve ret gövdesi standart biçimde olmalıdır. Kanıt, lisans satırı kapısının 0 ile çıkması, ardından oluşturulan her sürüm ağacında npm ci, npm test ve npm run build'in geçmesidir. Bölüm 2.25, Her sürüm için oluşturma, modülün iskeletini ve kapının neyi reddettiğini gösterir.

Maliyeti nedir

Bu şekilde çalışmak daha hızlıdır ve bedelsiz değildir. Her ajan geçişinin bir bütçesi ve bir saatlik ömrü vardır; uzun bir yeniden düzenleme, bunu yenilemek anlamına gelir. Okuma kirlenmesi, bir müşteri belgesini okumuş bir oturumun siz onaylayana kadar hiçbir şey yazmasını engeller; bu ilk birkaç seferde can sıkıcıdır ve tam olarak doğrudur. Bir betik sanal alanınızın dışındaki hiçbir şeyi asla değiştiremez; bu nedenle hazırlık ortamına ulaşması gereken otomasyon, herkes gibi bir değişiklik talebinden ve iki incelemeciden geçer. Bir asistanın talep tablolarını bir yere e-postayla neden gönderdiğini Larkfield'a açıklamaktansa bu sınırlara sahip olmayı tercih ederim.