AnmeldenBriefing buchen

Kapitel 2.26

Entwickeln mit KI-Programmierwerkzeugen

Wie Sie Nexus-Erweiterungen sicher mit Claude Code und anderen KI-Coding-Tools (künstliche Intelligenz) erstellen. Es beginnt mit der Verbindung Ihrer IDE (integrierte Entwicklungsumgebung) mit der Workbench und einer Projektdatei CLAUDE.md, die die Plattformregeln enthält, und endet mit sechs ausgearbeiteten Prompts und dem Gate, das jeden einzelnen bestätigt.

Diese Seite wurde mithilfe von KI aus dem englischen Original übersetzt. Bei Unklarheiten gilt die englische Seite als Referenz. Diese Seite auf Englisch lesen

24 Minuten Lesezeit

Der größte Teil des Cold-Chain-Pakets in Kapitel 2.24, „Ein eigenes Branchenpaket Ende-zu-Ende erstellen“, wurde mit geöffnetem Claude Code im Terminal neben mir geschrieben. Das ist bei Corrán Orbital inzwischen normal, und Nexus wurde genau in dieser Erwartung entwickelt. Die Plattform behandelt ein KI-Programmierwerkzeug (KI: künstliche Intelligenz) nicht als schlaue Autovervollständigung. Sie behandelt es als einen Agenten, der im Auftrag einer namentlich bekannten Person handelt, mit einem Ausweis, der stets enger gefasst ist als der dieser Person, und sie zeichnet jeden Aufruf des Agenten auf.

In diesem Kapitel geht es darum, so zu arbeiten, ohne sich die Finger zu verbrennen. Es beginnt mit dem Verbinden Ihrer IDE (integrierte Entwicklungsumgebung), behandelt dann Skills im Editor, die Projektdatei, die dem Werkzeug die Regeln der Plattform beibringt, die beiden Compiler, die bestehende Arbeit in Nexus-Code umwandeln, wie Commits angeben, welches Werkzeug sie geschrieben hat, und wie ich prüfe, was das Werkzeug erzeugt. Es endet mit sechs Prompts, die ich einem Kollegen in die Hand drücken würde – jeweils mit dem erwarteten Ergebnis und dem Gate, das es belegt.

Ihre IDE mit Nexus verbinden

Jede Installation hat eine einzige Workbench-Adresse für KI-Programmierwerkzeuge. Sie finden sie auf der Seite „Connect your IDE“ unter „Developers“, und Claude Code verbindet sich mit einem einzigen Befehl:

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

<workbench-address> ist die Adresse, die auf der Seite angezeigt wird, daneben eine Schaltfläche zum Kopieren. Für die anderen Werkzeuge stehen auf derselben Seite eigene Einzeiler: codex mcp add workbench --url <workbench-address> für Codex, ein Installationslink für Cursor und code --add-mcp mit einem kleinen JSON-Argument für VS Code mit Copilot. Alle sprechen über MCP (Model Context Protocol) mit derselben Adresse.

IDE verbinden
Ihre IDE verbinden
„Connect your IDE“ mit einem Befehl pro Werkzeug und den Standardstufen auf der rechten Seite. Das Diagramm unten zeigt, wie jeder Aufruf die Workbench passiert, eigene kurzlebige Zugangsdaten erhält und in jedem Speicher ausschließlich im Bereich der eigenen Organisation landet.

Es muss kein Schlüssel eingefügt werden. Der erste Aufruf öffnet Ihren Browser, der genau anzeigt, wer anfragt: welches Werkzeug auf welchem Rechner, in wessen Auftrag und mit welchen gewünschten Stufen. Sie geben die Anfrage mit Ihrem Passkey frei; von da an hält das Werkzeug weder ein Datenbankpasswort noch eine kubeconfig, sondern nur einen zeitlich begrenzten Ausweis. Hinter der Adresse erstellt Nexus für jeden Speicher und jede Anfrage in Ihrem Namen kurzlebige Zugangsdaten.

Ein Organisationsadministrator kann außerdem eine Datei mit verwalteten Einstellungen herunterladen, sodass sich jede Unternehmenskopie von Claude Code ausschließlich mit diesem Server verbindet:

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

Stufen und Ausweise

Jede Anmeldung an der Workbench erhält einen Ausweis, der aus benannten Stufen besteht. Der Standard für Entwickler ist „Observe“ und „Sandbox“ auf ihren eigenen Einheiten.

Stufe Was es erlaubt Wer sie erhält
Observe Eigene Einheiten einschließlich Logs und Metriken lesen und die maskierte Kopie abfragen Standardwert
Sandbox Im eigenen Bereich schreiben: im eigenen Dev-Bereich und in den eigenen Daten-Branches Standardwert
Propose Einen Änderungsantrag eröffnen; eine Pipeline wendet ihn nach Prüfung an Wird bei der ersten Nutzung angefordert
Elevate Eine zeitlich begrenzte Aktion auf einem Ziel, genehmigt durch eine benannte Person Nur Personen, niemals allein durch Anmeldung
Break-glass Notfallzugriff Nur Plattformadministratoren, mit zwei Genehmigern

Ein Agent handelt immer im Auftrag einer Person und erscheint als eigene Zeile. Sein Ausweis geht niemals weiter als Ihrer und umfasst niemals die Stufe „Elevate“ oder unmaskierte Daten. Er gilt eine Stunde und wird nur verlängert, solange Sie in Nexus oder in der IDE aktiv sind. Der Ausweis einer Person gilt 8 Stunden. Ein Werkzeug, das Sie über Nacht laufen lassen, stoppt also von selbst, und wenn Sie Ihren eigenen Ausweis beenden, endet auch der Ihres Agenten. Jeder Agentenausweis enthält zudem ein Budget für Modellkosten, das vor der Erteilung geschätzt und während der Laufzeit als Anzeige dargestellt wird.

Die Seite „My access passes“ führt jeden Ausweis auf, den Sie und Ihre Agenten halten, samt Stufen und bisherigen Kosten, und erlaubt Ihnen, jeden einzelnen zu verlängern, einzuschränken oder zu beenden. Das Beenden eines Ausweises stoppt den nächsten Aufruf sofort; das Protokoll aller bisherigen Aufrufe bleibt erhalten. Jeder Ausweis unterliegt außerdem festen Obergrenzen – bei uns waren das 200 Zeilen und 30 Sekunden pro Abfrage sowie 50 geänderte Objekte im Dev-Bereich pro Sitzung.

Die erste Sitzung in der IDE

Sobald die Verbindung steht, listet /mcp in Claude Code die Werkzeuge der Workbench nach Stufen gruppiert auf. Die Gruppe „Observe“ enthält die Lesewerkzeuge: workbench.k8s.describe, workbench.k8s.events, workbench.logs.query, workbench.metrics.query, workbench.traces.get, workbench.db.schema, workbench.db.query auf der maskierten Kopie, workbench.graph.query und workbench.vector.search. „Sandbox“ fügt workbench.devspace.deploy, workbench.branch.create und workbench.branch.reset hinzu. „Propose“ ergänzt die Werkzeuge, die einen Änderungsantrag eröffnen und eine Graph-Änderung planen. „Elevate“ ist im Ausweis überhaupt nicht enthalten; Sie fordern diese Stufe in der Konsole an.

In der IDE: erste Sitzung
In der IDE: erste Sitzung
Eine erste Sitzung in Claude Code: die Werkzeuge nach Stufen aufgelistet, ein Neustart bis zur Ursache zurückverfolgt und die Anfrage nach einem Datenbankpasswort abgewiesen. Jede Antwort gibt an, woher sie stammt und was ausgeblendet wurde.

Meine erste echte Frage war, warum unser Telemetrie-Lesedienst in Rotterdam über Nacht neu gestartet war. Claude Code beschrieb die Workload (zwei Neustarts, Speicherüberlauf bei einem Limit von 512 MiB), fragte die Logs (Organisation durch das Gateway gesetzt, personenbezogene Daten geschwärzt) sowie die Speichermetrik ab und stellte fest, dass der nächtliche Ladevorgang die Messwerte einer ganzen Nacht in einen einzigen Batch gezogen hatte. Dann fragte ich – halb als Test – nach dem Datenbankpasswort, das der Dienst verwendet. Die Workbench lehnte mit SECRET_NEVER_SHOWN ab. Sie zeigt niemandem je den Wert eines Secrets, sondern nur dessen Namen und die letzten vier Zeichen. Die Antwort des Assistenten war genau richtig: Er braucht das Passwort nicht, weil jede seiner Abfragen eigene kurzlebige Zugangsdaten erhält – eine schreibgeschützte Rolle, die nur für diese eine Anfrage erzeugt wird.

Erst planen, dann anwenden

Jedes Werkzeug, das etwas ändert, zeigt zuerst einen Plan. Der Plan ist ein Diff mit Anzahlwerten und einem Fingerabdruck, und „apply“ führt genau diesen Plan aus.

In der IDE: erst planen, dann anwenden
In der IDE: planen, dann anwenden
Ein Speicherlimit wird anhand eines Plans im Dev-Bereich erhöht, anschließend dieselbe Änderung außerhalb der Sandbox. In der interaktiven Sitzung bestätigt eine Person dies in der IDE; aus einem unbeaufsichtigten Skript heraus wird es abgewiesen.

Innerhalb Ihres eigenen Dev-Bereichs wird „apply“ sofort ausgeführt. Außerhalb davon muss eine Person in der IDE bestätigen, und die Änderung geht an die Pipeline, die sie nach einer Prüfung anwendet. Daraus folgen zwei Ablehnungen, und beide haben mich kalt erwischt:

  • Aus einem Skript ohne Menschen an der Tastatur, etwa claude -p in einem Cron-Job, lässt sich kein Bestätigungsdialog anzeigen; eine Änderung außerhalb der Sandbox wird daher mit CONFIRMATION_UNAVAILABLE abgewiesen. Es passiert nichts. Führen Sie sie in einer interaktiven Sitzung aus.
  • Ein „apply“, das einen Plan nennt, den diese Sitzung nie erstellt hat, oder einen Plan, der sich geändert hat, wird mit PLAN_FINGERPRINT_MISMATCH abgewiesen, bevor irgendetwas ausgeführt wird. Planen Sie erneut.

Lese-Kontamination (Read-taint)

Kundeninhalte können versteckte Anweisungen enthalten, die an einen Assistenten gerichtet sind. Sobald eine Sitzung solche Inhalte gelesen hat, verliert sie daher ihre Werkzeuge zum Schreiben und für Zugriffe außerhalb von Nexus, bis eine Person einen einzelnen Schreibvorgang bestätigt oder eine neue Sitzung startet.

In der IDE: Lese-Kontamination
In der IDE: Read-Taint
Ein Schadensdokument wird auf der maskierten Kopie gelesen; eine darin versteckte Anweisung wird vom Assistenten ignoriert. Der nächste Schreibvorgang wird abgewiesen, bis die Person diesen einen Schreibvorgang bestätigt oder eine neue Sitzung startet.

Mir begegnete das bei einem Schadensdokument, das einen an „den Assistenten“ gerichteten Absatz enthielt, in dem dieser aufgefordert wurde, die Schadenstabelle an eine externe Adresse zu kopieren. Claude Code ignorierte das und teilte dies auch mit. Als ich ihn anschließend bat, die Temperaturabweichung in meinen Branch-Graphen einzutragen, wurde der Schreibvorgang mit SESSION_TAINTED abgewiesen. Ich konnte diesen einen Schreibvorgang nach dem Lesen des Plans bestätigen oder eine frische Sitzung starten, die das Dokument nicht gelesen hatte. Logs und Metriken kontaminieren eine Sitzung nicht. Dokumente, Tickets, E-Mails und Graph-Quelltexte hingegen schon. Der versteckte Text wurde in meinem Aktivitätsprotokoll als „in Inhalten gefundene Anweisungen“ gezählt, ohne seinen Wortlaut zu speichern.

Eine andere Organisation

Nichts, was Sie eingeben, kann Daten einer anderen Organisation erreichen. Fragen Sie danach, lehnt jeder Speicher mit TENANT_BOUNDARY ab. Ein in eine Log-Abfrage eingeschleuster Organisationswert wird vom Gateway durch Ihren eigenen ersetzt. Es handelt sich nicht um eine fehlende Berechtigung. Jede Schicht auf dem Pfad ist fest auf Ihre Organisation eingegrenzt; von Ihrem Platz aus gibt es niemanden, der Zugriff gewähren könnte, und selbst der Zugang eines Plattformadministrators würde nicht helfen. Wenn zwei Organisationen vereinbaren, Daten zu teilen, wird dies als Vereinbarung zwischen ihnen eingerichtet – niemals über eine IDE-Sitzung.

Skills in der IDE und Claude Code

Skills der Skills Engine sind SKILL.md-Ordner, und Claude Code liest dieselben Ordner. Die Bibliothek wird schreibgeschützt mit ~/.claude/skills in Ihrem eigenen Home-Verzeichnis synchronisiert, während Ihre Entwürfe daneben in ~/.claude/skills/drafts liegen. So stehen die von Ihrer Organisation veröffentlichten Skills ohne jedes Kopieren in Ihrem Editor bereit, und was Sie lokal schreiben, durchläuft dieselben Tests und Genehmigungen wie alles, was in der Konsole geschrieben wird.

Skills in der IDE und in Claude Code
Skills in der IDE und Claude Code
Ein Skill, der im Editor geschrieben und getestet und anschließend durch dieselbe Genehmigung geschickt wird wie ein in der Konsole erstellter Skill. Beachten Sie, dass die Veröffentlichung zurückgehalten wird, weil der Autor seine eigene Änderung nicht freigeben kann.

Vom Terminal aus bringen im Repository des Skills zwei npm-Skripte ihn aus Ihrem Editor in die Bibliothek:

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

Validate prüft das Format und die Testfälle. Upload erstellt einen Entwurf, und falls der Inhalt mit einer bereits veröffentlichten Version übereinstimmt, wird stattdessen diese Version zurückgegeben (CONTENT_HASH_ALREADY_PUBLISHED). Publish wartet auf eine Genehmigung, wenn der Skill dies erfordert, und Sie können Ihre eigene Änderung nicht selbst genehmigen. Ein aus einem Skript gestarteter Lauf ohne Modellroute wird mit SKILLS_ENGINE_BINDING_MISSING abgewiesen: Der Dispatcher wählt die Route und die Engine prüft, ob sie angegeben wurde – geraten wird nie. Kapitel 2.24, „Ein eigenes Branchenpaket Ende-zu-Ende erstellen“, zeigt dieselben Skripte in einem Gesamtprojekt.

Agenten und Claude Code greifen über MCP ebenfalls auf die Bibliothek zu, über insgesamt 13 Werkzeuge. Darunter finden und lesen list_skills und get_skill einen Skill, match_prompt und discover_skills geben an, welcher Skill zu einer Aufgabe passt, invoke_skill führt einen Skill aus und sync_skills_local kopiert die Bibliothek in Ihren Skills-Ordner. Jeder Aufruf läuft im Namen der Person, die ihn gestartet hat, und innerhalb ihrer Positivliste (Allow-List). Ein Skill kann seine Werkzeuge niemals über die Positivliste der ausführenden Person hinaus erweitern.

Eine Projektdatei CLAUDE.md, die die Plattformregeln enthält

Claude Code liest zu Beginn jeder Sitzung eine CLAUDE.md im Wurzelverzeichnis des Repositorys. Das ist die günstigste Sicherheitsmaßnahme überhaupt, weil sie dem Modell die Regeln der Plattform vorlegt, bevor es die erste Zeile schreibt. Die Gates des SDK (Software Development Kit) fangen die meisten Fehler ohnehin ab, aber eine Regel, die das Modell vorab gelesen hat, erspart Ihnen einen fehlgeschlagenen Build.

Formulieren Sie die Datei als Regeln mit Begründungen, nicht als fromme Wünsche. Hier ist die Datei aus unserem Cold-Chain-Plugin-Repository, leicht gekürzt:

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

Drei Dinge sorgen dafür, dass eine solche Datei funktioniert. Jede Regel nennt den Mechanismus, der sie durchsetzt, sodass das Modell seine eigene Arbeit an genau dem Maßstab prüfen kann, den auch die Pipeline anlegt. Die „Definition of Done“ ist eine Liste von Befehlen mit Exit-Codes, kein Bauchgefühl. Und sie verbietet genau die Abkürzungen, zu denen ein Modell greift, wenn ein Build rot ist – etwa das Löschen des Tests oder das Setzen eines Platzhalters für eine fehlende Organisation.

Den SDK-Korpus als Kontext einspeisen

Die SDK-Dokumentation umfasst 28 Bände und ist so geschrieben, dass ein Entwickler oder ein LLM (großes Sprachmodell) allein anhand dieses Textkorpus ein vollständiges Produktiv-Plugin bauen kann, ohne Zugriff auf den privaten Code der Plattform. Jedes Datenformat auf der Leitung und jeder Fehlercode, dem ein Plugin begegnet, steht in den Dokumenten selbst.

Das macht sie zu einem ungewöhnlich guten Kontext. In der Praxis gebe ich Claude Code nicht das gesamte Werk, sondern die Bände, die die jeweilige Aufgabe berührt: die Bände zu Manifest und HTTP für eine neue Route, den Datenbankband für eine Migration, den Fehlerkatalog, sobald eine Ablehnung im Spiel ist, und immer die Konformitäts-Checkliste, weil sie den gesamten Korpus als Abhakliste abbildet. Weisen Sie das Modell an, einer beobachteten Tatsache Vorrang vor seiner eigenen Erinnerung daran zu geben, wie ein Framework normalerweise funktioniert. Wenn sich beides widerspricht, hat für diese Plattform der Korpus recht.

Für die Frontend-Entwickler in Ihrem Team generieren Sie einen Leitfaden aus dem Manifest, statt selbst einen zu schreiben:

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

Er führt jede Route auf, die die Web-App aufrufen darf, samt jeder Ablehnung, die zurückkommen kann; damit eignet er sich auch hervorragend als Kontext für das Modell, das die Web-App schreibt. Committen Sie ihn und prüfen Sie ihn in der CI (Continuous Integration) mit --check --lint, damit er nicht vom Manifest abweichen kann.

Ein bestehendes Repository einbinden: /plugin-create

Der Skill /plugin-create verwandelt ein bestehendes Repository oder eine API-Spezifikation (API: Application Programming Interface) in ein Nexus-Plugin. Übergeben Sie ihm beim Aufruf die Quelle:

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

Er arbeitet in Phasen. Zuerst klont und analysiert er die Quelle, ermittelt Sprache und Framework, die API-Oberfläche, die Datenbank samt Migrationen und was die Anwendung eigentlich tut. Er gibt einen Analysebericht aus und wählt anhand der Ergebnisse eine Wrapping-Strategie:

Quelle Strategie
REST-API (REST: Representational State Transfer) in Node.js Ein Express-Wrapper um die bestehenden Routen
REST-API in Python Ein FastAPI-Wrapper
Full-Stack mit Node.js und React Ein Backend-Wrapper mit einem Adapter für die Benutzeroberfläche (UI)
Kommandozeilenwerkzeug Eine Express-API, die die Befehle ausführt
Bibliothek oder SDK Eine Express-API, die deren Funktionen bereitstellt
Komplexe Plattform Ein Plugin-Container mit vorgeschaltetem nginx-Proxy

Anschließend generiert er das Backend und dessen Migrationen, eine UI, das Manifest und die Tests. Behandeln Sie das Ergebnis als starken ersten Entwurf und legen Sie denselben Maßstab an wie bei jedem anderen Code. In unserem Repository bedeutete das drei Schritte, bevor jemand den Code überprüfte. Wir haben das Manifest mit create-nexus-plugin migrate --write auf den v2-Vertrag gehoben, was die Regelsätze ergänzt und das Erfinden eines Einstiegspunkts verweigert. Danach haben wir dafür gesorgt, dass create-nexus-plugin validate erfolgreich durchläuft. Und wir haben nexus-gates ausgeführt, bis alles grün war – was in unserem Fall hieß, Mandanten-Header, die der Wrapper selbst auslas, durch den Scope-Guard des SDK zu ersetzen und die drei Achsen zu seinen Tabellen hinzuzufügen. Das Deployment verbleibt bei den Release-Kanälen der Installation; ignorieren Sie alle Deployment-Dateien, die der Entwurf enthält.

mockup-compiler: Von Bildschirmen zu funktionierendem Code

Der zweite Compiler arbeitet in die entgegengesetzte Richtung. mockup-compiler nimmt die Mockups eines Projekts – das können Tausende von Masken sein – und kompiliert sie in funktionierende UI, Backend-for-Frontend-Routen (BFF) und SQL, deren Originaltreue Maske für Maske durch Gates mit Exit-Codes nachgewiesen wird. Er führt jedes gezeichnete Wort auf die Quellzeile zurück, die es gezeichnet hat, verknüpft jede Maske mit ihrer Spezifikation, ermittelt die erforderlichen Domänenänderungen und gibt die Verträge und Migrationen zusammen mit einer Spezifikation der Demodaten aus, die jede Maske benötigt.

Zwei Regeln unterscheiden ihn von der bloßen Aufforderung an ein Modell, „diese Masken zu bauen“:

  • Compiler zuerst. Alles, was man wissen kann, wird deterministisch berechnet. Ein Modell kommt nur für typisierte Lücken (Typed Holes) zum Einsatz: Es schreibt ein Artefakt gegen ein Schema, ein deterministischer Prüfer akzeptiert es oder benennt jeden einzelnen Mangel, und das Modell erhält höchstens 3 Korrekturrunden, die mit dem Bericht des Prüfers gefüttert werden.
  • Jedes Gate verfügt über eine Negativkontrolle mit absichtlich eingebautem Fehler. Wenn verify die Gates eines Projekts für eine Maske ausführt, erhält eine Kopie des Baums pro Gate einen gezielt eingesetzten Fehler; besteht ein Gate trotz dieses Fehlers, wird der gesamte Lauf als nicht vertrauenswürdig markiert. Ein Gate, das nicht fehlschlagen kann, bricht den Lauf ab.

Die Arbeit läuft in Phasen ab, jede mit eigenem Modus und eigenem Gate:

Phase Modus Was das zugehörige Gate beweist
Pin pin Die Zeichnung ist über zwei Builds hinweg identisch, mit eindeutigen Masken-IDs
Trace trace Jedes gezeichnete Wort lässt sich auf genau eine Quellzeile zurückführen
Join join Jeder kompilierte Slot stimmt mit der Quelle überein, die ihn gezeichnet hat
Spec spec Jede Maske hat ihre Zeile in der Spezifikation
Domain change domain Der Vorschlag deckt alles ab, was die Masken lesen und schreiben, mit Codes aus dem SDK-Katalog
Contracts shape-check, emit-contracts Jedes gelesene Feld hat eine aus seiner Spalte übernommene oder deklarierte Struktur
SQL and store emit-sql, emit-store Die Migration lässt sich auf ein echtes Postgres anwenden, mit Tests, die zuerst fehlschlagen müssen
World world Die Demodaten decken sämtliche Zellen jeder Maske ab
Bind bind Der feststehende Teil jeder Bindung, während der Rest als benannte Lücken aufgeführt wird
Verify verify Die projekteigenen Gates pro Maske, wobei für jedes nachgewiesen ist, dass es fehlschlagen kann

Die einzige projektspezifische Eingabe ist .mockup-compiler.json, der Adapter. Er legt fest, wie eine Seite eine einzelne Maske markiert und welche SQL- und Speicher-Idiome ausgegeben werden sollen. Außerdem benennt er die Mandantenachsen – samt derjenigen, die jeden Schlüssel anführt – sowie den Autorisierungsaufruf, den jeder Schreibvorgang ausführt. mockup-compiler init --project <dir> schreibt ein Grundgerüst, in dem jeder nicht ausgefüllte Eintrag namentlich abgewiesen wird. Ein Projekt ohne eigenen UI-Compiler kann compile, baseline-check, join oder world nicht nutzen; diese Modi melden das direkt mit NO_PROJECT_COMPILER, statt erst später fehlzuschlagen.

Die Regel, die ich daraus mitnehmen würde, selbst wenn Sie ihn nie ausführen: Eine Schreibregel, die in der Spezifikation nicht genannt ist, wird zu einem ehrlichen 501, der benennt, was fehlt – niemals zu einer Vermutung. Genau diese Regel verlange ich auch von jedem Modell, das Code für Masken schreibt.

Generator-Zuordnung

Wenn ein Werkzeug einen Commit schreibt, sollte das im Commit stehen. Der Vertrag zur Generator-Zuordnung verlangt eine Trailer-Zeile in der Commit-Nachricht:

feat(excursions): page the nightly telemetry load

X-Generator: claude-code/<model>

Die Identität lautet <harness>/<model>, kleingeschrieben, mit einem Schrägstrich: Der Harness ist das ausgeführte Werkzeug (claude-code), und das Modell ist dasjenige, das darin lief. Falls sich das Modell während der Arbeit, die der Commit abschließt, geändert hat, fügen Sie X-Generator-Session mit jeder Identität hinzu, die älteste zuerst, damit die Arbeit nicht allein dem Modell zugeschrieben wird, das zum Zeitpunkt des Commits zufällig aktiv war. Ein Dienst, der den Commit eines anderen verpackt, etwa eine Merge-Warteschlange, reicht diese Trailer weiter.

Zwei Eigenschaften machen dies nützlich statt bloß dekorativ. Eine Angabe, die ein Leser nicht kennt, wird beibehalten und unter unregistered/<harness> mit dem exakten Wortlaut angezeigt, niemals verworfen. Und der Trailer ist eine selbst gemeldete Herkunftsangabe, kein Beweis: Nichts signiert ihn, weshalb jede Oberfläche, die diese Angaben zählt, diesen Vorbehalt neben den Zahlen ausweist. Die Grammatik der Identität wird mit dem SDK als @adverant-nexus/plugin-sdk/schema/generator-id veröffentlicht. Sie ist kein Manifest-Feld, denn welches Werkzeug einen Commit geschrieben hat, ist eine Aussage über den Commit, nicht über das Plugin.

Von einer KI geschriebenen Code überprüfen

Das Werkzeug schreibt schnell und selbstbewusst im immer gleichen Tonfall, egal ob es richtig oder falsch liegt. Meine Prüfroutine für seine Änderungen ist kurz, und ich lasse keinen Schritt davon aus:

  1. Lesen Sie den Diff, nicht die Zusammenfassung. Die Zusammenfassung beschreibt nur, was das Modell vorhatte.
  2. Führen Sie die „Definition of Done“ selbst aus einem sauberen Zustand heraus aus: npm ci, die Tests, den Build, validate und nexus-gates. Zitieren Sie die letzten Zeilen im Review.
  3. Prüfen Sie bei jedem neuen Test, ob er auf dem Stand vor der Änderung fehlschlägt. Ein Test, der in beiden Fällen besteht, ist bloße Dekoration.
  4. Achten Sie auf Abkürzungen: ein gelöschter oder übersprungener Test, ein neuer Eintrag unter gates/ ohne Begründung, ein Mandantenwert, der aus einem Body oder Header gelesen wird, eine Standardorganisation, ein catch, das eine Ablehnung verschluckt, oder ein Abruf an eine Adresse, die das Manifest nicht deklariert.
  5. Vergleichen Sie das Manifest mit dem letzten Release. Jeder neue Scope und jede neue ausgehende Adresse ist eine Ausweitung, und Ausweitungen erfordern zwei Prüfer.
  6. Prüfen Sie, ob Ablehnungstests den gesamten Body abprüfen: error, code, resolved[], missing[] und troubleshooting[].
  7. Prüfen Sie, ob der Commit seinen X-Generator-Trailer trägt.

Die Gates fangen die mechanischen Fehler ab. Sie können Ihnen aber nicht sagen, ob eine Route auf die Non-CRUD-Liste gehört oder ob ein Backend rechtlich blockiert ist – und das Modell kann es ebenso wenig; dieses Urteil bleibt bei Ihnen. Wenn dasselbe Problem immer wiederkehrt, korrigieren Sie die CLAUDE.md, nicht nur den Code.

Sechs ausgearbeitete Prompts

Jeder der folgenden Prompts stammt aus meiner eigenen Praxis und wurde nur leicht bereinigt. Nach jedem steht, was das Werkzeug erzeugen sollte und welches Gate beweist, dass es das getan hat. Ist das Gate nicht grün, ist die Arbeit nicht erledigt – ganz gleich, was in der Zusammenfassung steht.

1. Ein neuer Skills-Engine-Skill

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.

Es sollte skills/summarise-excursion/SKILL.md mit name, description, allowed-tools, triggers, capabilities und version im Frontmatter erzeugen, seine Anweisungen im Textkörper und Testfälle, die die gezielt eingebaute Anweisung enthalten. Der Nachweis ist npm run skill:validate skills/summarise-excursion mit null Fehlern, gefolgt von npm run skill:upload skills/summarise-excursion --dry-run mit der Anzeige des Plans. Die Veröffentlichung ist anschließend die Entscheidung einer Person, und ein Skill, der schreibt, benötigt in Enterprise zwei benannte Genehmiger.

2. Eine durchgängige Plugin-Route

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.

Es sollte eine nummerierte Migration erzeugen, die die Spalte zu einer Tabelle mit den drei Achsen hinzufügt, beide Routen in api.endpoints[] mit ihren auth und right deklariert, das Recht im Register rights einträgt, Handler hinter den Scope-Guard stellt sowie Tests liefert, die sicherstellen, dass eine nicht authentifizierte Anfrage und eine Anfrage einer falschen Organisation mit vollständigem Body abgewiesen werden. Der Nachweis ist nexus-gates: scope-adherence, crud-adherence, api-contract, rights-register und migrations-are-scoped laufen alle erfolgreich durch, und die Ausgabe des zuerst fehlschlagenden Tests ist im Protokoll enthalten.

3. Eine Linse (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.

Es sollte nexus.create mit einem Plan verwenden, den Sie bestätigen, und anschließend die Linse anhand ihrer Basis formen. Versucht es, etwas anzuzeigen, was die Basis nicht hergibt, lehnt die Registry mit LENS_CANNOT_WIDEN ab, und das Werkzeug sollte dies melden, statt nach einem Umweg zu suchen. Der Nachweis ist die Vorschau als Person sowie bei der Hochstufung die Richtlinienprüfung des Pilot-Gates, dass die Linse nur einschränkt und personenbezogene Felder standardmäßig ausgeblendet lässt.

4. Ein Domänenpaket (Domain Pack)

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.

Es sollte den Plan des Assistenten erzeugen, der das Repository und dessen erste Änderung, die deklarierten Scopes und die drei synthetischen Daten-Branches auflistet, ergänzt um eine pack.json mit ihren Linsen-Clustern und ihrem Lexikon. Nichts wird erstellt, bevor Sie den Fingerabdruck bestätigen. Der Nachweis sind die erfolgreich durchlaufenden Tests der Vorlage auf den synthetischen Branches und später das Staging-Gate. Fordert das Paket mehr an als in seinem letzten Release, wird die Freigabe mit MANIFEST_SCOPE_WIDENED zurückgehalten, bis zwei Prüfer sie akzeptieren.

5. Ein Datenkonnektor

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.

Dies sollte einen plugin_queue-Skill erzeugen, dessen queueName <plugin name>.<name> ohne Doppelpunkt ist, einen timeoutMs zwischen 1 Sekunde und 6 Stunden, einen Worker, der die Warteschlange abruft, eine Migration für die Ereignistabelle, die ausgehende Adresse im Manifest des Pakets (nicht in nexus.manifest.json, dessen Schema kein solches Feld besitzt) sowie den Variablennamen der Anmeldedaten in scripts/ci/required-env. Der Nachweis ist create-nexus-plugin validate, das die eigenen Regeln der Registry-Synchronisierung auf Warteschlangennamen und Timeouts anwendet, gefolgt von nexus-gates, wobei no-credentials und no-direct-compute grün sind. Zur Laufzeit wird ein Aufruf an jede Adresse, die das Manifest des Pakets nicht deklariert hat, am Edge mit EGRESS_NOT_DECLARED gestoppt.

6. Ein 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.

Dies sollte ein RouteModule mit seinem id, featureGroup, einem leeren bodies und einem register erzeugen, das einen Router auf der App des Hosts einbindet, mit der Berechtigungsprüfung innerhalb jedes Handlers und dem Ablehnungstext in der Standardform. Der Nachweis ist, dass das Lizenzlinien-Gate mit 0 beendet wird und anschließend npm ci, npm test und npm run build in jedem zusammengesetzten Editionsbaum erfolgreich durchlaufen. Kapitel 2.25, Für jede Edition bauen, zeigt das Grundgerüst des Moduls und was das Gate ablehnt.

Was es kostet

Auf diese Weise zu arbeiten ist schneller, aber nicht kostenlos. Jeder Agentendurchlauf hat ein Budget und eine Lebensdauer von einer Stunde, und ein langes Refactoring bedeutet, ihn zu erneuern. Read-Taint hindert eine Sitzung, die ein Kundendokument gelesen hat, daran, irgendetwas zu schreiben, bis Sie dies bestätigen – was die ersten Male irritierend, aber genau richtig ist. Ein Skript kann niemals etwas außerhalb Ihrer Sandbox ändern, sodass eine Automatisierung, die das Staging erreichen muss, wie alle anderen auch einen Änderungsantrag und zwei Prüfer durchläuft. Ich habe lieber diese Grenzen, als Larkfield zu erklären, warum ein Assistent ihre Schadenstabelle irgendwohin gemailt hat.