Logg innBestill en gjennomgang

Kapittel 2.26

Bygge med KI-kodeverktøy

Hvordan bygge Nexus-utvidelser trygt med Claude Code og andre kodeverktøy med KI (kunstig intelligens). Det starter med å koble ditt IDE (integrert utviklingsmiljø) til Workbench og en prosjektfil kalt CLAUDE.md som bærer plattformreglene, og avsluttes med seks gjennomarbeidede ledetekster og kontrollpunktet som beviser hver enkelt.

Denne siden er oversatt med KI fra den engelske originalen. Hvis noe er uklart, er den engelske siden referansen. Les denne siden på engelsk

24 minutter å lese

Mesteparten av Cold chain-pakken i kapittel 2.24, Bygge en tilpasset vertikal fra start til slutt, ble skrevet med Claude Code åpent i terminalen ved siden av meg. Det er normalt hos Corrán Orbital nå, og Nexus ble bygd med det for øye. Plattformen behandler ikke et KI-kodeverktøy (kunstig intelligens) som en smart autofullføring. Den behandler det som en agent som handler på vegne av en navngitt person, med et adgangspass som alltid er smalere enn denne personens, og den registrerer hvert kall agenten gjør.

Dette kapitlet handler om å arbeide på den måten uten å ta skade. Det begynner med å koble til IDE-en din (integrert utviklingsmiljø), og dekker deretter ferdigheter i redigeringsprogrammet, prosjektfilen som lærer verktøyet plattformens regler, de to kompilatorene som gjør eksisterende arbeid om til Nexus-kode, hvordan commits oppgir hvilket verktøy som skrev dem, og hvordan jeg gjennomgår det verktøyet produserer. Det avsluttes med seks ledetekster jeg ville gitt en kollega, hver med hva som bør komme tilbake og kontrollen som beviser det.

Koble ditt IDE til Nexus

Hver installasjon har én Workbench-adresse for KI-kodeverktøy. Du finner den på siden Koble til IDE-en din under Utviklere, og Claude Code kobler til med én kommando:

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

<workbench-address> er adressen siden viser, med en kopieringsknapp ved siden av. De andre verktøyene har sine egne énlinjere på samme side: codex mcp add workbench --url <workbench-address> for Codex, en installasjonslenke for Cursor og code --add-mcp med et lite JSON-argument for VS Code med Copilot. Alle snakker MCP (Model Context Protocol) med den samme adressen.

Koble til IDE-en din
Koble til IDE-en
Koble til IDE-en din, med én kommando per verktøy og standardnivåene til høyre. Diagrammet nederst viser hvert kall som passerer Workbench, får sin egen kortlivede legitimasjon og bare havner i organisasjonens eget område i hvert lager.

Det finnes ingen nøkkel å lime inn. Det første kallet åpner nettleseren din, som viser nøyaktig hva som spør: hvilket verktøy på hvilken datamaskin, på vegne av hvem, og hvilke nivåer det ønsker. Du tillater det med passnøkkelen din, og fra da av har verktøyet ikke noe databasepassord eller kubeconfig, bare et adgangspass som utløper. Bak adressen lager Nexus en kortlivet legitimasjon for hvert lager, for hver forespørsel, som deg.

En organisasjonsadministrator kan også laste ned en fil med administrerte innstillinger, slik at hver kopi av Claude Code i bedriften kobler til denne serveren og ingen annen:

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

Nivåer og adgangspass

Hver pålogging i Workbench får et adgangspass bestående av navngitte nivåer. Standarden for en utvikler er Observe og Sandbox på egne enheter.

Nivå Hva den tillater Hvem får det
Observe Lese enhetene dine, inkludert logger og målinger, og spørre den maskerte kopien Standard
Sandbox Skrive i ditt eget område: ditt utviklingsområde og dine egne datagrener Standard
Propose Åpne en endringsforespørsel; en pipeline tar den i bruk etter gjennomgang Bes om ved første bruk
Elevate Én tidsbegrenset handling på ett mål, godkjent av en navngitt person Kun personer, aldri bare ved pålogging
Break-glass Nødtilgang Kun plattformadministratorer, med to godkjennere

En agent handler alltid på vegne av en person og vises som en egen linje. Adgangspasset er aldri bredere enn ditt og inkluderer aldri Elevate-nivået eller umaskerte data. Det varer i én time og fornyes bare mens du er aktiv i Nexus eller IDE-en. En persons adgangspass varer i 8 timer. Et verktøy du lar kjøre over natten, stopper altså av seg selv, og når du avslutter ditt eget adgangspass, avsluttes også agentens. Hvert agentpass har også et budsjett for modellkostnader, som anslås før passet tildeles og vises som en måler mens det kjører.

Siden Mine adgangspass viser alle adgangspass du og agentene dine har, med nivåer og hva de har kostet så langt, og lar deg fornye, innsnevre eller avslutte hvert av dem. Når et adgangspass avsluttes, stoppes neste kall umiddelbart; registreringen av hvert kall består. Hvert adgangspass har også harde grenser, som hos oss var 200 rader og 30 sekunder per spørring, og 50 endrede objekter i utviklingsområdet per økt.

Den første økten i IDE-et

Når du er tilkoblet, viser /mcp i Claude Code Workbench-verktøyene gruppert etter nivå. Observe-gruppen inneholder leseverktøyene: workbench.k8s.describe, workbench.k8s.events, workbench.logs.query, workbench.metrics.query, workbench.traces.get, workbench.db.schema, workbench.db.query på den maskerte kopien, workbench.graph.query og workbench.vector.search. Sandbox legger til workbench.devspace.deploy, workbench.branch.create og workbench.branch.reset. Propose legger til verktøyene som åpner en endringsforespørsel og planlegger en grafendring. Elevate er ikke med i adgangspasset i det hele tatt; det ber du om i konsollen.

I IDE-en: første økt
I IDE-en: første økt
En første økt i Claude Code, med verktøyene listet etter nivå, en omstart sporet til årsaken og en forespørsel om et databasepassord som avvises. Hvert svar oppgir hvor det kom fra og hva som ble skjult.

Mitt første reelle spørsmål var hvorfor telemetrileseren vår startet på nytt i Rotterdam i løpet av natten. Claude Code beskrev arbeidslasten (to omstarter, tomt for minne mot en grense på 512 MiB), spurte loggene (organisasjon satt av gatewayen, personopplysninger sladdet) og minnemålingen, og fant at den nattlige innlastingen trakk en hel natts avlesninger inn i én batch. Deretter ba jeg den, halvt som en test, om databasepassordet tjenesten bruker. Workbench avviste med SECRET_NEVER_SHOWN. Den viser navnet og de fire siste tegnene i en Secret, aldri verdien, til noen. Assistentens svar var det riktige: den trenger ikke passordet, fordi hver spørring den gjør får sin egen kortlivede legitimasjon, en skrivebeskyttet rolle laget for akkurat den forespørselen.

Planlegg, og ta i bruk

Hvert verktøy som endrer noe, viser først en plan. Planen er en diff med antall og et fingeravtrykk, og apply kjører bare den planen, nøyaktig.

I IDE-en: planlegg, og ta i bruk
I IDE-en: planlegg, deretter bruk
En minnegrense hevet i utviklingsområdet fra en plan, og deretter samme endring utenfor sandkassen. I den interaktive økten bekrefter en person den i IDE-en; fra et skript uten grensesnitt avvises den.

I ditt eget utviklingsområde kjører apply umiddelbart. Utenfor må en person bekrefte i IDE-en, og endringen går til pipelinen, som tar den i bruk etter gjennomgang. Det fører til to avvisninger, og begge rammet meg:

  • Fra et skript uten noen ved tastaturet, for eksempel claude -p i en cron-jobb, er det ingen måte å vise bekreftelsesboksen på, så en endring utenfor sandkassen avvises med CONFIRMATION_UNAVAILABLE. Ingenting skjer. Kjør den i en interaktiv økt.
  • En apply som viser til en plan denne økten aldri laget, eller til en plan som er endret, avvises med PLAN_FINGERPRINT_MISMATCH før noe kjøres. Planlegg på nytt.

Lesesmitte

Kundeinnhold kan skjule instruksjoner beregnet på en assistent. Så snart en økt har lest slikt innhold, mister økten derfor verktøyene for å skrive og for å nå ut av Nexus, inntil en person bekrefter én skriving eller starter en ny økt.

I IDE-en: lesesmitte
I IDE-en: lesesmitte
Et kravdokument lest på den maskerte kopien, med en skjult instruksjon som assistenten ignorerte. Neste skriving avvises inntil personen bekrefter akkurat den skrivingen eller starter en ny økt.

Jeg støtte på dette i et kravdokument som inneholdt et avsnitt rettet til «assistenten», med beskjed om å kopiere kravtabellen til en ekstern adresse. Claude Code ignorerte det og sa ifra. Da jeg deretter ba den legge avviket til grengrafen min, ble skrivingen avvist med SESSION_TAINTED. Jeg kunne bekrefte akkurat den skrivingen etter å ha lest planen, eller starte en ny økt som ikke hadde lest dokumentet. Logger og målinger smitter ikke en økt. Dokumenter, saker, e-post og kildetekst i grafer gjør det. Den skjulte teksten ble registrert i aktivitetsloggen min som instruksjoner funnet i innhold, uten selve ordlyden.

En annen organisasjon

Ingenting du skriver, kan nå en annen organisasjons data. Ber du om det, avviser hvert lager med TENANT_BOUNDARY. En organisasjonsverdi som smugles inn i en loggspørring, erstattes av gatewayen med din egen. Det er ikke en manglende tillatelse. Hvert lag på veien er avgrenset til din organisasjon, så det finnes ingen som kan gi den fra der du sitter, og en plattformadministrators tilgang ville heller ikke hjelpe. Hvis to organisasjoner blir enige om å dele data, er det en avtale som settes opp mellom dem, aldri noe en IDE-økt gjør.

Ferdigheter i IDE-et og Claude Code

Ferdigheter i Skills Engine er SKILL.md-mapper, og Claude Code leser de samme mappene. Biblioteket synkroniseres til ~/.claude/skills i din egen hjemmekatalog, skrivebeskyttet, med utkastene dine ved siden av i ~/.claude/skills/drafts. Ferdighetene organisasjonen din har publisert, er dermed tilgjengelige i redigeringsprogrammet uten kopiering, og det du skriver lokalt, går tilbake gjennom de samme testene og den samme godkjenningen som alt som skrives i konsollen.

Ferdigheter i IDE-et og Claude Code
Ferdigheter i IDE-et og Claude Code
En ferdighet skrevet og testet i redigeringsprogrammet, og deretter sendt gjennom samme godkjenning som en laget i konsollen. Legg merke til at publiseringen ble holdt tilbake fordi forfatteren ikke kan godkjenne sin egen endring.

Fra terminalen, i depotet som inneholder ferdigheten, tar to npm-skript den fra redigeringsprogrammet og inn i biblioteket:

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

Validate kontrollerer formatet og testtilfellene. Upload lager et utkast, og hvis innholdet samsvarer med en allerede publisert versjon, returneres den versjonen i stedet (CONTENT_HASH_ALREADY_PUBLISHED). Publish holdes tilbake for godkjenning når ferdigheten krever det, og du kan ikke godkjenne din egen endring. En kjøring startet fra et skript uten modellrute avvises med SKILLS_ENGINE_BINDING_MISSING: fordeleren velger ruten, og motoren kontrollerer at den ble oppgitt, uten noen gang å gjette. Kapittel 2.24, Bygge en tilpasset vertikal fra start til slutt, viser de samme skriptene i et helt prosjekt.

Agenter og Claude Code når også biblioteket via MCP, gjennom 13 verktøy i alt. Blant dem finner og leser list_skills og get_skill en ferdighet, match_prompt og discover_skills angir hvilken ferdighet som passer til en oppgave, invoke_skill kjører en, og sync_skills_local kopierer biblioteket til ferdighetsmappen din. Hvert kall kjøres som personen som startet det, innenfor personens tillatelsesliste. En ferdighet kan aldri utvide verktøyene sine utover tillatelseslisten til den som kjører den.

En prosjektfil kalt CLAUDE.md som bærer plattformreglene

Claude Code leser en CLAUDE.md i roten av depotet ved starten av hver økt. Det er det billigste sikkerhetstiltaket du har, fordi det legger plattformens regler foran modellen før den skriver noe. SDK-kontrollene (programvareutviklingssett) fanger uansett de fleste feil, men en regel modellen har lest på forhånd, koster deg ingen mislykket bygging.

Skriv den som regler med begrunnelser, ikke som ambisjoner. Her er den i depotet for Cold chain-tillegget vårt, noe forkortet:

# 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>.

Tre ting får en slik fil til å fungere. Hver regel navngir mekanismen som håndhever den, slik at modellen kan kontrollere sitt eget arbeid mot det samme som pipelinen vil. Definisjonen av ferdig er en liste over kommandoer med avslutningskoder, ikke en følelse. Og den forbyr de konkrete snarveiene en modell griper til når en bygging er rød, for eksempel å slette testen eller å sette en manglende organisasjon til en plassholder som standard.

Mate inn SDK-korpuset som kontekst

SDK-dokumentasjonen består av 28 bind, skrevet slik at en utvikler eller en LLM (stor språkmodell) kan bygge et komplett produksjonstillegg ut fra korpuset alene, uten tilgang til plattformens private kode. Hver meldingsstruktur og feilkode et tillegg møter, står i selve dokumentene.

Det gjør den til uvanlig god kontekst. I praksis gir jeg Claude Code de bindene oppgaven berører i stedet for hele settet: manifest- og HTTP-bindene for en ny rute, databasebindet for en migrering, feilkatalogen når en avvisning er involvert, og samsvarssjekklisten alltid, fordi den er hele korpuset som en avkrysningsliste. Be modellen foretrekke et observert faktum framfor sin egen hukommelse av hvordan et rammeverk vanligvis fungerer. Når de to er uenige, har korpuset rett om denne plattformen.

For frontendutvikleren i teamet ditt kan du generere en veiledning fra manifestet i stedet for å skrive en:

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

Den viser hver rute webappen kan kalle, med hver avvisning den kan få tilbake, så den er også god kontekst for modellen som skriver webappen. Commit den, og kontroller den i CI (kontinuerlig integrasjon) med --check --lint, slik at den ikke kan avvike fra manifestet.

Pakke inn et eksisterende kodelager: /plugin-create

Ferdigheten /plugin-create gjør et eksisterende depot eller en API-spesifikasjon (programmeringsgrensesnitt) om til et Nexus-tillegg. Oppgi kilden når du starter den:

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

Den arbeider i faser. Først kloner og analyserer den kilden og finner ut språk og rammeverk, API-overflaten, databasen og migreringene, og hva løsningen faktisk gjør. Den skriver ut en analyserapport og velger en innpakkingsstrategi ut fra det den fant:

Kilde Strategi
REST-API (representational state transfer) i Node.js En Express-innpakning rundt de eksisterende rutene
REST-API i Python En FastAPI-innpakning
Fullstack Node.js og React En backend-omslutning med en adapter for brukergrensesnitt (UI)
Kommandolinjeverktøy Et Express-API som kjører kommandoene
Bibliotek eller SDK Et Express-API som eksponerer funksjonene
Kompleks plattform Én plugin-container med en nginx-proxy foran

Deretter genererer det backend og tilhørende migreringer, et UI, manifestet og testene. Behandle det det skriver som et sterkt første utkast, og hold det til samme standard som alt annet. I vårt repository betydde det tre trinn før noen gjennomgikk det. Vi løftet manifestet til v2-kontrakten med create-nexus-plugin migrate --write, som legger til lovsetningene og nekter å finne på et inngangspunkt. Deretter fikk vi det til å bestå create-nexus-plugin validate. Og vi kjørte nexus-gates til det ble grønt, noe som i vårt tilfelle betydde å erstatte tenant-headere som omslutningen leste selv med SDK-ets scope-vakt, og å legge til de tre aksene i tabellene. Utrulling forblir hos installasjonens utgivelseskanaler; ignorer eventuelle utrullingsfiler i utkastet.

mockup-compiler: fra skjermbilder til fungerende kode

Den andre kompilatoren arbeider motsatt vei. mockup-compiler tar et prosjekts mockuper, som kan utgjøre tusenvis av skjermbilder, og kompilerer dem til fungerende UI, backend for frontend-ruter (BFF) og SQL, bevist tro mot kilden skjermbilde for skjermbilde av porter med avslutningskoder. Den sporer hvert tegnet ord til kildelinjen som tegnet det, kobler hvert skjermbilde til sin spesifikasjon, utleder domeneendringene skjermbildene trenger, og genererer kontraktene og migreringene sammen med en spesifikasjon av demodataene hvert skjermbilde trenger.

To regler skiller den fra å be en modell om å «bygge disse skjermbildene»:

  • Kompilator først. Alt som kan vites, beregnes deterministisk. En modell brukes bare til typede hull: den skriver en artefakt mot et skjema, en deterministisk kontrollør godtar den eller navngir hver feil, og modellen får maksimalt 3 reparasjonsrunder basert på kontrollørens rapport.
  • Hver port har en negativ kontroll med innplantet feil. Når verify kjører et prosjekts porter for et skjermbilde, får en kopi av treet én innplantet feil per port, og hvis en port slipper gjennom sin innplantede feil, merkes hele kjøringen som upålitelig. En port som ikke kan feile, avbryter kjøringen.

Arbeidet kjøres i trinn, hvert med sin egen modus og sin egen port:

Trinn Modus Hva porten beviser
Fest pin Tegningen er identisk på tvers av to bygg, med unike skjermbilde-id-er
Sporing trace Hvert tegnet ord spores til nøyaktig én kildelinje
Kobling join Hver kompilerte plass samsvarer med kilden som tegnet den
Spesifikasjon spec Hvert skjermbilde har sin rad i spesifikasjonen
Domeneendring domain Forslaget dekker alt skjermbildene leser og skriver, med koder fra SDK-katalogen
Kontrakter shape-check, emit-contracts Hvert lest felt har en form hentet fra kolonnen eller deklarert
SQL og lager emit-sql, emit-store Migreringen kjøres mot en ekte Postgres, med tester som feiler først
Verden world Demodataene dekker cellene i hvert skjermbilde
Binding bind Den avgjorte delen av hver binding, med resten oppført som navngitte hull
Verifisering verify Prosjektets egne porter per skjermbilde, hver bevist i stand til å feile

Den eneste prosjektspesifikke inndataen er .mockup-compiler.json, adapteren. Den angir hvordan en side markerer ett skjermbilde, og hvilke SQL- og lager-idiomer som skal genereres. Den navngir også tenant-aksene, med den som leder hver nøkkel, og autorisasjonskallet hver skriving utfører. mockup-compiler init --project <dir> skriver et skjelett der hver ikke-utfylt oppføring avvises ved navn. Et prosjekt uten egen UI-kompilator kan ikke bruke compile, baseline-check, join eller world, og disse modusene sier fra med NO_PROJECT_COMPILER i stedet for å feile lenger ned.

Regelen jeg ville tatt med meg selv om De aldri kjører den: en skriveregel som spesifikasjonen ikke angir, blir en ærlig 501 som navngir hva som mangler, aldri en gjetning. Det er den samme regelen jeg vil ha fra enhver modell som skriver kode mot skjermbilder.

Generatorattribusjon

Når et verktøy skriver en commit, bør commiten si det. Kontrakten for generatorattribusjon ber om én trailer-linje i commit-meldingen:

feat(excursions): page the nightly telemetry load

X-Generator: claude-code/<model>

Identiteten er <harness>/<model>, med små bokstaver og én skråstrek: harness er verktøyet som kjørte (claude-code), og modellen er den det kjørte. Hvis modellen endret seg under arbeidet commiten avslutter, legg til X-Generator-Session med hver identitet, eldste først, slik at arbeidet ikke tilskrives den modellen som tilfeldigvis var aktiv da commiten ble gjort. En tjeneste som omslutter noen andres commit, for eksempel en merge-kø, fører disse trailerne videre.

To egenskaper gjør dette nyttig snarere enn dekorativt. En påstand en leser ikke gjenkjenner, beholdes og vises under unregistered/<harness> med nøyaktig tekst bevart, aldri forkastet. Og traileren er selvrapportert opprinnelse, aldri bevis: ingenting signerer den, så hver flate som teller disse påstandene, viser dette forbeholdet ved siden av tallene. Identitetsgrammatikken er publisert med SDK-et som @adverant-nexus/plugin-sdk/schema/generator-id. Den er ikke et manifestfelt, fordi verktøyet som skrev en commit, er et faktum om commiten, ikke om pluginen.

Gå gjennom kode skrevet av en KI

Verktøyet skriver raskt og selvsikkert med samme stemme enten det har rett eller ikke. Min gjennomgangsrutine for endringene er kort, og jeg hopper ikke over noe av den:

  1. Les diffen, ikke sammendraget. Sammendraget sier hva modellen hadde til hensikt å gjøre.
  2. Kjør definisjonen av ferdig selv, fra rent utgangspunkt: npm ci, testene, bygget, validate og nexus-gates. Siter de siste linjene i gjennomgangen.
  3. For hver ny test, kontroller at den feiler på treet før endringen. En test som består begge veier, er pynt.
  4. Se etter snarveiene. En slettet eller hoppet over test, en ny oppføring under gates/ uten begrunnelse, en tenant-verdi lest fra en body eller en header, en standardorganisasjon, en catch som svelger en avvisning, en fetch til en adresse manifestet ikke deklarerer.
  5. Sammenlign manifestet med siste utgivelse. Ethvert nytt scope eller utgående adresse er en utvidelse, og utvidelser får to kontrollører.
  6. Kontroller at avvisningstester verifiserer hele bodyen: error, code, resolved[], missing[] og troubleshooting[].
  7. Kontroller at commiten har sin X-Generator-trailer.

Portene fanger de mekaniske feilene. De kan ikke fortelle Dem om en rute hører hjemme på listen over ikke-CRUD, eller om en backend er juridisk blokkert, og det kan heller ikke modellen; den vurderingen forblir hos Dem. Hvis det samme problemet stadig kommer tilbake, rett CLAUDE.md, ikke bare koden.

Seks gjennomarbeidede ledetekster

Hver ledetekst nedenfor er en jeg har brukt, lett ryddet opp. Etter hver: hva verktøyet bør produsere, og porten som beviser at det gjorde det. Hvis porten ikke er grønn, er arbeidet ikke ferdig, uansett hva sammendraget sier.

1. En ny Skills Engine-ferdighet

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.

Det bør produsere skills/summarise-excursion/SKILL.md med name, description, allowed-tools, triggers, capabilities og version i frontmatter, instruksjonene i hoveddelen, og testtilfeller som inkluderer den innplantede instruksjonen. Beviset er npm run skill:validate skills/summarise-excursion med null feil, deretter npm run skill:upload skills/summarise-excursion --dry-run som viser planen. Publisering er en persons beslutning etterpå, og en ferdighet som skriver, trenger to navngitte godkjennere på Enterprise.

2. En rute for en fullstendig tjeneste-plugin

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.

Det bør produsere en nummerert migrering som legger kolonnen til en tabell med de tre aksene, begge rutene deklarert i api.endpoints[] med sine auth og right, rettigheten i rights-registeret, håndterere bak scope-vakten, og tester som verifiserer at en uautentisert forespørsel og en forespørsel fra feil organisasjon avvises med fullstendige bodyer. Beviset er nexus-gates: scope-adherence, crud-adherence, api-contract, rights-register og migrations-are-scoped består alle, og utdataene som feiler først, står i transkripsjonen.

3. En linse

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.

Det bør bruke nexus.create med en plan De bekrefter, og deretter forme linsen mot basen. Hvis det prøver å vise noe basen ikke viser, avviser registeret med LENS_CANNOT_WIDEN, og verktøyet bør rapportere det i stedet for å lete etter en vei rundt. Beviset er forhåndsvisningen som en person, og ved promotering pilotportens policykontroll av at linsen bare snevrer inn og holder personlige felt av som standard.

4. En domenepakke

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.

Det bør produsere veiviserens plan, med repositoryet og dets første endring, de deklarerte scopene og de tre syntetiske datagrenene, pluss en pack.json med linseklynger og leksikon. Ingenting opprettes før De bekrefter fingeravtrykket. Beviset er at malens tester består på de syntetiske grenene, og senere staging-porten. Hvis pakken ber om mer enn siste utgivelse, holdes utgivelsen tilbake med MANIFEST_SCOPE_WIDENED til to kontrollører godtar den.

5. En datatilkobling

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.

Det bør produsere en plugin_queue-ferdighet der queueName er <plugin name>.<name> uten kolon, en timeoutMs mellom 1 sekund og 6 timer, en worker som henter fra køen, en migrering for hendelsestabellen, den utgående adressen i pakkens manifest (ikke i nexus.manifest.json, hvis skjema ikke har noe slikt felt), og legitimasjonens variabelnavn i scripts/ci/required-env. Beviset er create-nexus-plugin validate, som anvender registersynkroniseringens egne regler for kønavn og tidsavbrudd, deretter nexus-gates med no-credentials og no-direct-compute grønne. Ved kjøring stoppes et kall til enhver adresse pakkens manifest ikke deklarerte, ved kanten med EGRESS_NOT_DECLARED.

6. En Enterprise-modul

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.

Det bør produsere en RouteModule med sin id, featureGroup, tom bodies og en register som monterer en router på vertens app, med tilgangskontrollen inne i hver håndterer og avvisningsbodyen i standardformen. Beviset er at lisenslinjeporten avslutter med 0, deretter at npm ci, npm test og npm run build består i hvert sammensatte utgavetre. Kapittel 2.25, Bygging for hver utgave, viser modulens skjelett og hva porten avviser.

Hva det koster

Å arbeide på denne måten er raskere, og det er ikke gratis. Hver agentrunde har et budsjett og en levetid på én time, og en lang refaktorering betyr å fornye den. Lesesmitte stopper en økt som har lest ett kundedokument, fra å skrive noe før De bekrefter, noe som er irriterende de første gangene og helt riktig. Et skript kan aldri endre noe utenfor sandkassen Deres, så automatisering som må nå staging, går gjennom en endringsforespørsel og to kontrollører som alle andre. Jeg vil heller ha disse begrensningene enn å forklare Larkfield hvorfor en assistent sendte skadetabellen deres på e-post et sted.