Log indBook en briefing

Kapitel 2.26

Byg med AI-kodeværktøjer

Sådan bygger I Nexus-udvidelser sikkert med Claude Code og andre AI-kodeværktøjer (kunstig intelligens). Det starter med at forbinde jeres IDE (integreret udviklingsmiljø) til Workbench og en projektfil ved navn CLAUDE.md, der indeholder platformsreglerne, og slutter med seks gennemarbejdede prompts samt den kontrolport, der beviser hver enkelt.

Denne side er oversat af AI fra den engelske original. Hvis noget er uklart, er den engelske side gældende. Læs denne side på engelsk

24 minutters læsetid

Størstedelen af Cold chain-pakken i kapitel 2.24, Opbygning af en tilpasset branchepakke fra ende til anden, blev skrevet med Claude Code åben i terminalen ved siden af mig. Det er normalt hos Corrán Orbital nu, og Nexus blev bygget med det for øje. Platformen behandler ikke et AI-kodningsværktøj (kunstig intelligens) som en smart autofuldførelse. Den behandler det som en agent, der handler på vegne af en navngiven person, med et adgangspas, der altid er snævrere end den persons, og den registrerer hvert kald, agenten foretager.

Dette kapitel handler om at arbejde på den måde uden at komme til skade. Det begynder med at forbinde Deres IDE (integreret udviklingsmiljø) og dækker derefter skills i editoren, projektfilen, der lærer værktøjet platformens regler, de to compilere, der omdanner eksisterende arbejde til Nexus-kode, hvordan commits angiver, hvilket værktøj der skrev dem, og hvordan jeg gennemgår det, værktøjet producerer. Det slutter med seks prompts, jeg ville give en kollega, hver med det, der bør komme tilbage, og den kontrol, der beviser det.

Forbind jeres IDE til Nexus

Hver installation har én Workbench-adresse til AI-kodningsværktøjer. De finder den på siden Forbind Deres IDE under Udviklere, og Claude Code forbinder med én kommando:

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

<workbench-address> er den adresse, siden viser, med en kopieringsknap ved siden af. De andre værktøjer har deres egne one-liners på samme side: codex mcp add workbench --url <workbench-address> til Codex, et installationslink til Cursor og code --add-mcp med et lille JSON-argument til VS Code med Copilot. De taler alle MCP (Model Context Protocol) med den samme adresse.

Forbind Deres IDE
Forbind Deres IDE
Forbind Deres IDE, med én kommando pr. værktøj og standardniveauerne til højre. Diagrammet nederst viser hvert kald, der passerer Workbench, får sine egne kortlivede legitimationsoplysninger og kun lander i organisationens eget område i hvert lager.

Der er ingen nøgle at indsætte. Det første kald åbner Deres browser, som viser præcis, hvad der spørger: hvilket værktøj på hvilken computer, på vegne af hvem, og med ønske om hvilke niveauer. De tillader det med Deres passkey, og fra da af har værktøjet hverken databaseadgangskode eller kubeconfig, kun et adgangspas, der udløber. Bag adressen opretter Nexus kortlivede legitimationsoplysninger til hvert lager, for hver anmodning, som Dem.

En organisationsadministrator kan også downloade en fil med administrerede indstillinger, så hver af virksomhedens kopier af Claude Code forbinder til denne server og ingen anden:

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

Niveauer og adgangspas

Hvert Workbench-login får et adgangspas, der består af navngivne niveauer. Standarden for en udvikler er Observe og Sandbox på vedkommendes egne enheder.

Niveau Hvad den tillader Hvem får det
Observe Læs Deres enheder, herunder logfiler og målinger, og forespørg den maskerede kopi Standard
Sandbox Skriv i Deres eget område: Deres dev-område og Deres egne datagrene Standard
Propose Opret en ændringsanmodning; en pipeline anvender den efter gennemgang Anmodes om ved første brug
Elevate Én tidsbegrænset handling på ét mål, godkendt af en navngiven person Kun personer, aldrig alene ved login
Break-glass Nødadgang Kun platformadministratorer, med to godkendere

En agent handler altid på vegne af en person og vises som sin egen linje. Dens adgangspas er aldrig bredere end Deres og omfatter aldrig niveauet Elevate eller umaskerede data. Det varer en time og fornyes kun, mens De er aktiv i Nexus eller i IDE'en. En persons adgangspas varer 8 timer. Et værktøj, De lader køre natten over, stopper altså af sig selv, og når De afslutter Deres eget adgangspas, afsluttes Deres agents også. Hvert agentpas har desuden et budget for modelomkostninger, der anslås, før adgangspasset tildeles, og vises som en måler, mens det kører.

Siden Mine adgangspas viser alle de adgangspas, De og Deres agenter har, med deres niveauer og hvad de indtil videre har kostet, og lader Dem forny, indsnævre eller afslutte hvert enkelt. Når et adgangspas afsluttes, stoppes det næste kald med det samme; registreringen af hvert kald bevares. Hvert adgangspas har også faste grænser, som hos os var 200 rækker og 30 sekunder pr. forespørgsel samt 50 ændrede objekter i dev-området pr. session.

Den første session i IDE'et

Når forbindelsen er oprettet, viser /mcp i Claude Code Workbench-værktøjerne grupperet efter niveau. Gruppen Observe indeholder læseværktøjerne: workbench.k8s.describe, workbench.k8s.events, workbench.logs.query, workbench.metrics.query, workbench.traces.get, workbench.db.schema, workbench.db.query på den maskerede kopi, workbench.graph.query og workbench.vector.search. Sandbox tilføjer workbench.devspace.deploy, workbench.branch.create og workbench.branch.reset. Propose tilføjer de værktøjer, der opretter en ændringsanmodning og planlægger en grafændring. Elevate er slet ikke på adgangspasset; det anmoder De om i konsollen.

I IDE'en: første session
I IDE'en: første session
En første session i Claude Code, med værktøjerne opført efter niveau, en genstart sporet til sin årsag og en anmodning om en databaseadgangskode, der afvises. Hvert svar angiver, hvor det kom fra, og hvad der blev skjult.

Mit første rigtige spørgsmål var, hvorfor vores telemetrilæser genstartede i Rotterdam i løbet af natten. Claude Code beskrev workloaden (to genstarter, løbet tør for hukommelse mod en grænse på 512 MiB), forespurgte logfilerne (organisation sat af gatewayen, personoplysninger skjult) og hukommelsesmålingen og fandt ud af, at den natlige indlæsning trak en hel nats målinger ind i én batch. Derefter bad jeg den, halvt som en test, om den databaseadgangskode, tjenesten bruger. Workbench afviste med SECRET_NEVER_SHOWN. Den viser en Secrets navn og sidste fire tegn, aldrig værdien, til nogen. Assistentens svar var det rigtige: den har ikke brug for adgangskoden, fordi hver forespørgsel, den foretager, får sine egne kortlivede legitimationsoplysninger, en skrivebeskyttet rolle oprettet til netop den ene anmodning.

Planlæg, og anvend derefter

Hvert værktøj, der ændrer noget, viser først en plan. Planen er en diff med optællinger og et fingeraftryk, og anvendelsen kører kun præcis den plan.

I IDE'en: planlæg, og anvend derefter
I IDE'en: planlæg, og anvend derefter
En hukommelsesgrænse hævet i dev-området ud fra en plan og derefter den samme ændring uden for sandkassen. I den interaktive session bekræfter en person den i IDE'en; fra et headless script afvises den.

Inden for Deres eget dev-område anvendes ændringen med det samme. Uden for det skal en person bekræfte i IDE'en, og ændringen går til pipelinen, som anvender den efter gennemgang. Det fører til to afvisninger, og begge ramte mig:

  • Fra et script uden nogen ved tastaturet, såsom claude -p i et cron-job, er der ingen måde at vise bekræftelsesboksen på, så en ændring uden for sandkassen afvises med CONFIRMATION_UNAVAILABLE. Intet sker. Kør den i en interaktiv session.
  • En anvendelse, der henviser til en plan, som denne session aldrig har lavet, eller en plan, der er ændret, afvises med PLAN_FINGERPRINT_MISMATCH, før noget kører. Planlæg igen.

Læsesmitte

Kundeindhold kan skjule instruktioner beregnet til en assistent. Når en session har læst det, mister sessionen derfor sine værktøjer til at skrive og til at nå uden for Nexus, indtil en person bekræfter én skrivning eller starter en ny session.

I IDE'en: læsesmitte
I IDE'en: read-taint
Et skadesdokument læst på den maskerede kopi, med en skjult instruktion, som assistenten ignorerede. Den næste skrivning afvises, indtil personen bekræfter den ene skrivning eller starter en ny session.

Jeg mødte dette i et skadesdokument, der indeholdt et afsnit rettet til "assistenten" med en anmodning om at kopiere skadestabellen til en ekstern adresse. Claude Code ignorerede det og sagde det. Da jeg derefter bad den tilføje afvigelsen til min grengraf, blev skrivningen afvist med SESSION_TAINTED. Jeg kunne bekræfte den ene skrivning efter at have læst dens plan eller starte en ny session, der ikke havde læst dokumentet. Logfiler og målinger smitter ikke en session. Dokumenter, sager, mails og grafkildetekst gør alle. Den skjulte tekst blev registreret i min aktivitetslog som instruktioner fundet i indhold, uden dens ordlyd.

En anden organisation

Intet, De skriver, kan nå en anden organisations data. Spørger De efter dem, afviser hvert lager med TENANT_BOUNDARY. En organisationsværdi, der sniges ind i en logforespørgsel, erstattes af gatewayen med Deres egen. Det er ikke en manglende tilladelse. Hvert lag på vejen er afgrænset til Deres organisation, så der er ingen, der kan tildele den fra Deres position, og en platformadministrators adgang ville heller ikke hjælpe. Hvis to organisationer aftaler at dele data, er det en aftale, der oprettes mellem dem, aldrig noget, en IDE-session gør.

Færdigheder i IDE'et og Claude Code

Skills Engine-skills er SKILL.md-mapper, og Claude Code læser de samme mapper. Biblioteket synkroniseres til ~/.claude/skills i Deres egen hjemmemappe, skrivebeskyttet, med Deres kladder ved siden af i ~/.claude/skills/drafts. Skills, som Deres organisation har udgivet, er derfor tilgængelige i Deres editor uden kopiering, og det, De skriver lokalt, går tilbage gennem de samme test og den samme godkendelse som alt, der skrives i konsollen.

Færdigheder i IDE'et og Claude Code
Færdigheder i IDE'et og Claude Code
En skill skrevet og testet i editoren og derefter sendt gennem den samme godkendelse som en, der er lavet i konsollen. Bemærk, at udgivelsen blev tilbageholdt, fordi forfatteren ikke kan godkende sin egen ændring.

Fra terminalen, i det repository, der indeholder skillen, fører to npm-scripts den fra Deres editor ind i biblioteket:

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

Validate kontrollerer formatet og testtilfældene. Upload opretter en kladde, og hvis indholdet svarer til en allerede udgivet version, returnerer den i stedet den version (CONTENT_HASH_ALREADY_PUBLISHED). Udgivelse tilbageholdes til godkendelse, når skillen kræver det, og De kan ikke godkende Deres egen ændring. En kørsel startet fra et script uden en modelrute afvises med SKILLS_ENGINE_BINDING_MISSING: dispatcheren vælger ruten, og motoren kontrollerer, at den blev angivet, og gætter aldrig en. Kapitel 2.24, Opbygning af en tilpasset branchepakke fra ende til anden, viser de samme scripts i et helt projekt.

Agenter og Claude Code når også biblioteket over MCP via i alt 13 værktøjer. Blandt dem finder og læser list_skills og get_skill en skill, match_prompt og discover_skills angiver, hvilken skill der passer til en opgave, invoke_skill kører en, og sync_skills_local kopierer biblioteket til Deres skills-mappe. Hvert kald kører som den person, der startede det, inden for vedkommendes tilladelsesliste. En skill kan aldrig udvide sine værktøjer ud over tilladelseslisten for den, der kører den.

En CLAUDE.md-projektfil, der indeholder platformsreglerne

Claude Code læser en CLAUDE.md i roden af repositoriet ved starten af hver session. Det er den billigste sikkerhedsforanstaltning, De har, fordi den lægger platformens regler foran modellen, før den skriver noget. SDK-kontrollerne (software development kit) fanger alligevel de fleste fejl, men en regel, som modellen har læst på forhånd, koster Dem ikke et mislykket build.

Skriv den som regler med deres begrundelser, ikke som ambitioner. Her er den i vores Cold chain-plugin-repository, let 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 fil som denne til at virke. Hver regel navngiver den mekanisme, der håndhæver den, så modellen kan kontrollere sit eget arbejde mod det samme, som pipelinen vil. Definitionen af færdig er en liste over kommandoer med exitkoder, ikke en fornemmelse. Og den forbyder de specifikke genveje, en model griber til, når et build er rødt, såsom at slette testen eller lade en manglende organisation falde tilbage til en pladsholder.

Indføring af SDK-korpusset som kontekst

SDK-dokumentationen er et sæt på 28 bind, skrevet så en udvikler eller en LLM (stor sprogmodel) kan bygge et komplet produktionsplugin alene ud fra materialet, uden adgang til platformens private kode. Hver wire-struktur og fejlkode, et plugin møder, findes i selve dokumenterne.

Det gør det til usædvanligt god kontekst. I praksis giver jeg Claude Code de bind, opgaven berører, frem for hele sættet: manifest- og HTTP-bindene til en ny rute, databasebindet til en migrering, fejlkataloget, når en afvisning er involveret, og altid overensstemmelsestjeklisten, fordi den er hele materialet som en afkrydsningsliste. Bed modellen foretrække et observeret faktum frem for sin egen hukommelse om, hvordan et framework normalt fungerer. Når de to er uenige, har materialet ret om denne platform.

Generér en vejledning ud fra manifestet til frontendudvikleren på Deres team i stedet for at 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 må kalde, med hver afvisning, den kan få tilbage, så den er også god kontekst for den model, der skriver webappen. Commit den, og kontrollér den i CI (kontinuerlig integration) med --check --lint, så den ikke kan glide væk fra manifestet.

Indpakning af et eksisterende kodelager: /plugin-create

Skillen /plugin-create omdanner et eksisterende repository eller en API-specifikation (application programming interface) til et Nexus-plugin. Angiv kilden, når De kalder den:

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

Den arbejder i faser. Først kloner og analyserer den kilden og fastlægger sprog og framework, API-overfladen, databasen og dens migreringer, og hvad tingen faktisk gør. Den udskriver en analyserapport og vælger en indpakningsstrategi ud fra det, den fandt:

Kilde Strategi
REST API (representational state transfer) i Node.js En Express-indpakning omkring de eksisterende ruter
REST API i Python En FastAPI-indpakning
Full-stack Node.js og React En backend-wrapper med en adapter til brugergrænsefladen (UI)
Kommandolinjeværktøj Et Express-API, der kører kommandoerne
Bibliotek eller SDK Et Express-API, der eksponerer dets funktioner
Kompleks platform Én plugin-container med en nginx-proxy foran

Derefter genererer det backend og dens migreringer, en UI, manifestet og testene. Betragt det, det skriver, som et stærkt første udkast, og hold det til samme standard som alt andet. I vores repository betød det tre trin, før nogen gennemgik det. Vi løftede dets manifest til v2-kontrakten med create-nexus-plugin migrate --write, som tilføjer lovsætningerne og nægter at opfinde et entrypoint. Derefter fik vi det til at bestå create-nexus-plugin validate. Og vi kørte nexus-gates, indtil det blev grønt, hvilket i vores tilfælde betød at erstatte tenant-headere, som wrapperen selv læste, med SDK'ets scope guard og at tilføje de tre akser til dets tabeller. Udrulning forbliver hos installationens release-kanaler; ignorer eventuelle udrulningsfiler, som udkastet indeholder.

mockup-compiler: fra skærmbilleder til fungerende kode

Den anden compiler arbejder den modsatte vej. mockup-compiler tager et projekts mockups, som kan løbe op i tusindvis af skærmbilleder, og kompilerer dem til fungerende UI, backend for frontend (BFF)-ruter og SQL, bevist tro mod kilden skærmbillede for skærmbillede af gates med exitkoder. Den sporer hvert tegnet ord til den kildelinje, der tegnede det, forbinder hvert skærmbillede med dets specifikation, udleder de domæneændringer, skærmbillederne kræver, og udsender kontrakterne og migreringerne sammen med en specifikation af de demodata, hvert skærmbillede har brug for.

To regler adskiller den fra at bede en model om at "bygge disse skærmbilleder":

  • Compileren først. Alt, hvad der kan vides, beregnes deterministisk. En model bruges kun til typede huller: den skriver et artefakt mod et skema, en deterministisk kontrol accepterer det eller navngiver hver fejl, og modellen får højst 3 reparationsrunder, der fødes med kontrollens rapport.
  • Hver gate har en negativ kontrol med en plantet fejl. Når verify kører et projekts gates for et skærmbillede, får en kopi af træet én plantet fejl pr. gate, og hvis en gate lader sin plantede fejl passere, markeres hele kørslen som upålidelig. En gate, der ikke kan fejle, afbryder kørslen.

Arbejdet kører i faser, hver med sin egen tilstand og sin egen gate:

Fase Tilstand Hvad dens gate beviser
Fastlåsning pin Tegningen er identisk på tværs af to builds med unikke skærmbillede-id'er
Sporing trace Hvert tegnet ord spores til præcis én kildelinje
Sammenkædning join Hver kompileret plads svarer til den kilde, der tegnede den
Specifikation spec Hvert skærmbillede har sin række i specifikationen
Domæneændring domain Forslaget dækker alt, hvad skærmbillederne læser og skriver, med koder fra SDK-kataloget
Kontrakter shape-check, emit-contracts Hvert læst felt har en form, der er hentet fra dets kolonne eller erklæret
SQL og lager emit-sql, emit-store Migreringen anvendes på en rigtig Postgres med tests, der fejler først
Verden world Demodataene dækker hvert skærmbilledes celler
Binding bind Den afgjorte del af hver binding, med resten opført som navngivne huller
Verificering verify Projektets egne gates pr. skærmbillede, hver bevist i stand til at fejle

Det eneste projektspecifikke input er .mockup-compiler.json, adapteren. Den angiver, hvordan en side markerer ét skærmbillede, og hvilke SQL- og lager-idiomer der skal udsendes. Den navngiver også tenancy-akserne, herunder den, der indleder hver nøgle, og det autorisationskald, som hver skrivning foretager. mockup-compiler init --project <dir> skriver et skelet, hvor hver uudfyldt post afvises ved navn. Et projekt uden sin egen UI-compiler kan ikke bruge compile, baseline-check, join eller world, og disse tilstande oplyser det med NO_PROJECT_COMPILER i stedet for at fejle længere fremme.

Den regel, jeg ville tage med mig, selv hvis De aldrig kører den: en skriveregel, som specifikationen ikke angiver, bliver en ærlig 501, der navngiver, hvad der mangler, aldrig et gæt. Det er den samme regel, jeg ønsker af enhver model, der skriver kode mod skærmbilleder.

tilskrivning af generator

Når et værktøj skriver et commit, bør commit'et sige det. Kontrakten for generator-attribution kræver én trailer-linje i commit-beskeden:

feat(excursions): page the nightly telemetry load

X-Generator: claude-code/<model>

Identiteten er <harness>/<model>, med små bogstaver og én skråstreg: harness er det værktøj, der kørte (claude-code), og model er den model, det kørte. Hvis modellen skiftede under det arbejde, som commit'et afslutter, så tilføj X-Generator-Session med hver identitet, ældste først, så arbejdet ikke tilskrives den model, der tilfældigvis var aktiv på commit-tidspunktet. En tjeneste, der omslutter en andens commit, f.eks. en merge-kø, fører disse trailere videre.

To egenskaber gør dette nyttigt snarere end dekorativt. En påstand, som en læser ikke genkender, bevares og vises under unregistered/<harness> med den nøjagtige tekst bevaret, den kasseres aldrig. Og traileren er selvrapporteret oprindelse, aldrig bevis: intet signerer den, så enhver flade, der tæller disse påstande, viser det forbehold ved siden af tallene. Identitetsgrammatikken er udgivet med SDK'et som @adverant-nexus/plugin-sdk/schema/generator-id. Den er ikke et manifestfelt, fordi det værktøj, der skrev et commit, er en kendsgerning om commit'et, ikke om pluginet.

Gennemgang af kode, som en AI har skrevet

Værktøjet skriver hurtigt og selvsikkert med samme stemme, uanset om det har ret eller ej. Min gennemgangsrutine for dets ændringer er kort, og jeg springer intet af den over:

  1. Læs diff'en, ikke resuméet. Resuméet siger, hvad modellen havde til hensigt at gøre.
  2. Kør selv definitionen af færdig, fra rent udgangspunkt: npm ci, testene, buildet, validate og nexus-gates. Citér de sidste linjer i gennemgangen.
  3. For hver ny test skal De kontrollere, at den fejler på træet før ændringen. En test, der består begge veje, er pynt.
  4. Kig efter genvejene. En slettet eller oversprunget test, en ny post under gates/ uden begrundelse, en tenant-værdi læst fra en body eller en header, en standardorganisation, en catch, der sluger en afvisning, et fetch til en adresse, som manifestet ikke erklærer.
  5. Sammenlign manifestet med den seneste release. Ethvert nyt scope eller enhver ny udgående adresse er en udvidelse, og udvidelser får to reviewere.
  6. Kontrollér, at afvisningstests verificerer hele body'en: error, code, resolved[], missing[] og troubleshooting[].
  7. Kontrollér, at commit'et har sin X-Generator-trailer.

Gates fanger de mekaniske fejl. De kan ikke fortælle Dem, om en rute hører hjemme på listen over ikke-CRUD-ruter, eller om en backend er juridisk blokeret, og det kan modellen heller ikke; den vurdering forbliver hos Dem. Hvis det samme problem bliver ved med at vende tilbage, så ret CLAUDE.md, ikke kun koden.

Seks gennemarbejdede prompts

Hver prompt nedenfor er en, jeg har brugt, let renset. Efter hver: hvad værktøjet bør producere, og den gate, der beviser, at det gjorde det. Hvis gaten ikke er grøn, er arbejdet ikke færdigt, uanset hvad resuméet siger.

1. En ny Skills Engine-færdighed

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 producere skills/summarise-excursion/SKILL.md med name, description, allowed-tools, triggers, capabilities og version i frontmatter, sine instruktioner i body'en og testcases, der inkluderer den plantede instruktion. Beviset er npm run skill:validate skills/summarise-excursion med nul fejl, derefter npm run skill:upload skills/summarise-excursion --dry-run, der viser planen. Udgivelse er en persons beslutning bagefter, og en skill, der skriver, kræver to navngivne godkendere på Enterprise.

2. En plugin-rute med fuld service

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 producere en nummereret migrering, der tilføjer kolonnen til en tabel med de tre akser, begge ruter erklæret i api.endpoints[] med deres auth og right, rettigheden i rights-registret, handlere bag scope guard'en og tests, der verificerer, at en uautentificeret anmodning og en anmodning fra en forkert organisation afvises med fulde bodies. Beviset er nexus-gates: scope-adherence, crud-adherence, api-contract, rights-register og migrations-are-scoped består alle, og output fra de først fejlende tests står i transskriptionen.

3. En lens

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 bruge nexus.create med en plan, som De bekræfter, og derefter forme lensen mod dens base. Hvis det forsøger at vise noget, som basen ikke viser, afviser registret med LENS_CANNOT_WIDEN, og værktøjet bør rapportere det i stedet for at lede efter en vej udenom. Beviset er forhåndsvisningen som en person og, ved forfremmelse, pilot-gatens politikkontrol af, at lensen kun indsnævrer og holder personlige felter slået fra som standard.

4. En domænepakke

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 producere guidens plan, der oplister repository'et og dets første ændring, de erklærede scopes og de tre syntetiske datagrene, samt en pack.json med dens lens-klynger og leksikon. Intet oprettes, før De bekræfter fingeraftrykket. Beviset er, at skabelonens tests består på de syntetiske grene, og senere staging-gaten. Hvis pakken beder om mere end sin seneste release, tilbageholdes releasen med MANIFEST_SCOPE_WIDENED, indtil to reviewere accepterer den.

5. En dataconnector

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 producere en plugin_queue-skill, hvis queueName er <plugin name>.<name> uden kolon, en timeoutMs mellem 1 sekund og 6 timer, en worker, der henter fra køen, en migrering for hændelsestabellen, den udgående adresse i pakkens manifest (ikke i nexus.manifest.json, hvis skema ikke har et sådant felt), og legitimationsoplysningens variabelnavn i scripts/ci/required-env. Beviset er create-nexus-plugin validate, som anvender registersynkroniseringens egne regler for kønavne og timeouts, derefter nexus-gates med no-credentials og no-direct-compute grønne. Under kørsel stoppes et kald til enhver adresse, som pakkens manifest ikke har erklæret, ved kanten med EGRESS_NOT_DECLARED.

6. Et 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 producere en RouteModule med dens id, featureGroup, tom bodies og en register, der monterer en router på værtens app, med tilladelseskontrollen inde i hver handler og afvisnings-body'en i standardformen. Beviset er, at licenslinje-gaten afslutter med 0, derefter at npm ci, npm test og npm run build består i hvert sammensat udgavetræ. Kapitel 2.25, Byg til hver udgave, viser modulets skelet, og hvad gaten afviser.

Hvad det koster

At arbejde på denne måde er hurtigere, og det er ikke gratis. Hvert agentgennemløb har et budget og en levetid på en time, og en lang refaktorering betyder, at det skal fornyes. Read-taint forhindrer en session, der har læst ét kundedokument, i at skrive noget som helst, før De bekræfter, hvilket er irriterende de første par gange og præcis rigtigt. Et script kan aldrig ændre noget uden for Deres sandbox, så automatisering, der skal nå staging, går gennem en ændringsanmodning og to reviewere ligesom alle andre. Jeg vil hellere have de begrænsninger end at skulle forklare Larkfield, hvorfor en assistent e-mailede deres skadetabel et eller andet sted hen.