CodeGuard

Prüflisten und Zweitleser

Wann CodeGuard den Agenten anhält, eine feste Prüfliste durchzugehen, was sie verlangt und wer seine Arbeit gegenlesen soll – neu mit API-Limits und SQL-Qualität.

8 Prüflisten vor riskanten Schritten

Vor bestimmten Schritten hält CodeGuard den Agenten an, eine feste Prüfliste durchzugehen, statt zu improvisieren, und den Schritt erst zu tun, wenn die Punkte belegt sind.

WannWas die Prüfliste verlangt
Eine Entscheidung steht anDie Frage mit Empfehlung und den Folgen jeder Möglichkeit stellen.
„Das ist kaputt“Erst wird der Befund bestätigt, dann gehandelt – nicht auf einen Verdacht hin umgebaut.
Deploy und ReleaseTests grün, Weg zurück bekannt, deine Freigabe liegt vor.
Urteile über DatenZahlen sind auf zwei Wegen hergeleitet und nennen ihre Quelle.
Datenbank-MigrationenRückwärtsverträglich, ohne Datenverlust, in der richtigen Reihenfolge.
Neue PaketeGebraucht, gepflegt, ohne bekannte Sicherheitslücken, mit passender Lizenz.
Fremde APIs und eigene Endpunkte (neu)Zeitlimits, Wartezeiten, Obergrenzen und Drosselung – siehe unten.
SQL wird geschrieben oder geändert (neu)Die Abfrage ist richtig, sicher und schnell – siehe unten.

Neu: API-Limits

Fehlende Limits gehören zu den häufigsten Fehlern in KI-geschriebenem Code: Ein Aufruf hängt ohne Zeitlimit, eine Wiederholung verbraucht über Nacht das Kontingent, eine Anmeldung lässt sich beliebig oft durchprobieren. Darum hält CodeGuard den Agenten an, darauf zu achten, sobald er eine fremde API anspricht oder einen eigenen Endpunkt baut.

Bei fremden APIs:

  • die Limits des Anbieters nachgelesen, mit Quelle
  • ein Zeitlimit für jeden Aufruf
  • die Antwort „zu viele Anfragen“ (429) erkannt und die angegebene Wartezeit (Retry-After) eingehalten
  • Wiederholungen mit wachsender Pause und fester Obergrenze – und nur dort, wo eine Wiederholung nichts doppelt auslöst
  • Menge, Kontingent und Kosten gedeckelt
  • Fehler sichtbar statt verschluckt

Bei eigenen Endpunkten:

  • Drosselung bei Anmeldung, Passwort-Zurücksetzen, Registrierung, Versand, Uploads und teuren Abfragen
  • Obergrenzen für Größe von Anfragen und Länge von Ergebnislisten
  • eine klare Antwort mit Wartezeit, wenn jemand zu viel anfragt

Zusätzlich gibt CodeGuard direkt beim Schreiben einen Hinweis, wenn neuer Code typische Fälle enthält: einen Aufruf fremder Dienste ohne Zeitlimit, eine endlose Wiederholung bei Fehlern oder eine Anmeldung, Registrierung bzw. Passwort-Zurücksetzung ohne Drosselung. Der Hinweis nennt Datei und Zeile und hält die Arbeit nicht auf. Er findet typische Fälle; Umwege können durchrutschen.

Geplant, Änderungen vorbehalten: dieselben Punkte im Code-Review des Dashboards.

Neu: SQL-Qualität

Bisher hält CodeGuard Änderungen und Löschungen an Daten, die es erkennt, bis zu deiner Zustimmung auf. Neu hält es den Agenten an, auch darauf zu achten, ob eine Abfrage gut ist – im Programmcode, in Skripten, in Migrationen und bei einzelnen Abfragen.

ZielWas die Prüfliste verlangt
RichtigPasst zum echten Schema, Verknüpfungen liefern nichts doppelt, leere Werte, Gruppierung, Datum und Zeitzonen stimmen.
SicherWerte als Parameter statt in den Text gebaut, Änderungen und Löschungen nur mit Bedingung und vorher gezählt, in einer Transaktion, große Mengen in Teilen.
SchnellNur die nötigen Spalten, Bedingungen, die einen Index nutzen können, ein Index für neue Spalten, begrenzte Ergebnismengen, keine Abfrage je Zeile in einer Schleife.
SkriptePassender Datenbank-Dialekt, wiederholbar, ohne lange Sperren.

Zusätzlich gibt CodeGuard direkt beim Schreiben einen Hinweis, wenn neues SQL – in SQL-Dateien und in Abfragen im Programmcode – typische Fehler enthält: eine Änderung oder Löschung ohne Bedingung, einen Ausschluss, der bei leeren Werten still nichts liefert, einen Vergleich mit einem leeren Wert, der nie zutrifft, eine Bedingung oder Suche, die keinen Index nutzen kann, alle Spalten statt der nötigen, unvollständige Klammern oder Anführungszeichen und einen Ausführungsplan, der die Anweisung wirklich ausführt. Der Hinweis nennt Datei und Zeile und hält die Arbeit nicht auf. Er findet typische Fälle, keine vollständige Syntaxprüfung.

Geplant, Änderungen vorbehalten: eine Prüfung im Code-Review des Dashboards und die Prüfung gegen eine Test-Datenbank, die du je Repository hinterlegst. An das Passwort dieser Datenbank kommt der Agent nicht einfach heran.

5 Arbeitsweisen

CodeGuard hält den Agenten an, je nach Aufgabe einer festen Arbeitsweise zu folgen.

ArbeitsweiseWas sie verlangt
PlanenZiel, betroffene Stellen, Schritte und Weg zurück festlegen, bevor gebaut wird.
BauenErst nachsehen, was es schon gibt, dann ändern, dann mit einem ausgeführten Test belegen.
FehlersucheErst die Ursache finden und belegen, dann reparieren – kein schneller Flicken am Symptom.
AufräumenNur ein Bericht, was weg könnte; löschen erst nach deiner Zustimmung.
DatenanalyseZahlen über Daten auf zwei Wegen herleiten, bevor sie genannt werden.

6 Zweitleser

CodeGuard hält den Agenten an, Pläne, fertige Änderungen, Datenbank-Migrationen, neue Abhängigkeiten und einzelne Befunde von einem Zweitleser gegenlesen zu lassen und vor dem Bauen einen weiteren suchen zu lassen, ob es das Gesuchte schon gibt. Die prüfenden Zweitleser bekommen nur das Ergebnis, nicht die Absicht – und finden deshalb Fehler, statt sie zu bestätigen.

6 Prüfebenen

CodeGuard hält den Agenten an, fertige Änderungen auf diesen Ebenen durchzusehen: Daten, Logik, Effizienz, Redundanz, Sicherheit und Selbstkritik – also unnötiger Code, Platzhalter und Behauptungen ohne Beleg.