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.
| Wann | Was die Prüfliste verlangt |
|---|---|
| Eine Entscheidung steht an | Die 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 Release | Tests grün, Weg zurück bekannt, deine Freigabe liegt vor. |
| Urteile über Daten | Zahlen sind auf zwei Wegen hergeleitet und nennen ihre Quelle. |
| Datenbank-Migrationen | Rückwärtsverträglich, ohne Datenverlust, in der richtigen Reihenfolge. |
| Neue Pakete | Gebraucht, 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.
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.
| Ziel | Was die Prüfliste verlangt |
|---|---|
| Richtig | Passt zum echten Schema, Verknüpfungen liefern nichts doppelt, leere Werte, Gruppierung, Datum und Zeitzonen stimmen. |
| Sicher | Werte 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. |
| Schnell | Nur 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. |
| Skripte | Passender 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.
5 Arbeitsweisen
CodeGuard hält den Agenten an, je nach Aufgabe einer festen Arbeitsweise zu folgen.
| Arbeitsweise | Was sie verlangt |
|---|---|
| Planen | Ziel, betroffene Stellen, Schritte und Weg zurück festlegen, bevor gebaut wird. |
| Bauen | Erst nachsehen, was es schon gibt, dann ändern, dann mit einem ausgeführten Test belegen. |
| Fehlersuche | Erst die Ursache finden und belegen, dann reparieren – kein schneller Flicken am Symptom. |
| Aufräumen | Nur ein Bericht, was weg könnte; löschen erst nach deiner Zustimmung. |
| Datenanalyse | Zahlen ü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.