Schreiben von Cursorregeln, die dafür sorgen, dass sich die KI in einer alten Codebasis verhält

Meine erste Woche der agentengesteuerten Entwicklung in unserer vier Jahre alten Codebasis brachte wunderschönen Code hervor, der gegen drei Teamkonventionen und eine Architekturentscheidung verstieß, um die wir monatelang gestritten hatten. Der Fix war keine bessere Aufforderung; es war die Niederschrift der Verfassung.

Eine gute Regeldatei ist kurz und negativ. Meine listet auf, was die Codebasis niemals tun darf: keine neuen Zustandsverwaltungsbibliotheken, Datumsangaben sind Dayjs, keine Datumsangaben, jede API-Route validiert mit den vorhandenen Zod-Schemas und berührt niemals Dateien unter Legacy/ohne zu fragen. Einschränkungen, nicht Bestrebungen, sind es, die das Verhalten des Modells verändern.

Der unerwartete Erfolg bestand darin, das Warum für jede Regel in einer Klausel zu dokumentieren. Das Modell, das weiß, dass Migrationen im letzten Quartal fehlgeschlagen sind, schreibt einen vorsichtigeren Migrationscode als jemand, der nur „Vorsicht“ gesagt hat. Der Kontext wandelt Regeln von „befolgt“ in „verstanden“ um, und verstandene Regeln werden auf Fälle verallgemeinert, die Sie nicht aufgelistet haben.

Behalten Sie eine zweite Regeldatei pro Verzeichnis für lokale Konventionen, mein Komponentenordner hat eine eigene, und widerstehen Sie dem Drang, die globale Datei aufzublähen. Ich habe meinen ersten Entwurf von vierzig auf zwölf Zeilen gekürzt, und die Unterschiede sind besser geworden, weil jede Zeile, die man hinzufügt, diejenigen verwässert, die wichtig sind.

Sechs Wochen später das messbare Ergebnis: Unterschiede, die gegen Konventionen verstoßen, sind von etwa einem Drittel auf selten gesunken, und die Kommentare zur Codeüberprüfung haben sich vom Stil zurück zur Logik verlagert. Die Regeldatei ist der günstigste leitende Ingenieur, den ich je eingestellt habe.