Gentle-AI für Einsteiger: Erinnerung, Workflow und Nachweise für einen vorhandenen KI-Coding-Agenten

Für wen das gedacht ist

Sie nutzen bereits einen KI-Coding-Agenten und stoßen dabei immer wieder auf dieselbe Sache: Sobald er den Code fertig geschrieben hat, leert er den Kontext und beginnt die nächste Runde wieder bei null; er hat keine stabile Einschätzung Ihres Projekts; und hinterher bleibt nichts als die Möglichkeit, den Diff selbst Zeile für Zeile zu lesen, um nachzuweisen, was er tatsächlich geändert hat.

Genau gegen diese Alltagserfahrung richtet sich Gentle-AI. Es ersetzt Ihren Agenten nicht, sondern legt eine deterministische Engineering-Umgebung über den Agenten, den Sie bereits haben. Die offizielle Kurzfassung lautet "The deterministic engineering environment", und es geht um genau drei Dinge: Erinnerung, Workflow und Nachweise.

Geeignet ist das für Entwickler mit einem echten Repository, die möchten, dass sich der Agent Projektkonventionen langfristig merkt; für Teamleitungen, die wünschen, dass der Agent einem festen Ablauf folgt, statt jedes Mal frei zu improvisieren; und für Situationen, in denen jede Änderung einen abgleichbaren Nachweis hinterlassen soll, damit Zusammenarbeit und Übergabe leichtfallen.

Umgekehrt löst es Wünsche wie ein anderes, angenehmeres Editor- oder Modell-Setup nicht: Es geht um die Arbeitsweise Ihres bestehenden Agenten, nicht darum, welches Werkzeug Sie benutzen. Wenn es nur um ein Wegwerf-Skript geht und Sie keine nachvollziehbare Historie brauchen, überlegen Sie erst, ob sich eine zusätzliche Konfigurationsebene überhaupt lohnt.

In 3 Minuten zum ersten Versuch

Gehen Sie nur den einen offiziellen Weg: Öffnen Sie das Quickstart.

https://github.com/Gentleman-Programming/gentle-ai/blob/main/docs/quickstart.md

Voraussetzung: Ein unterstützter Agent (etwa Claude Code) ist bereits installiert und darf Ihr Projektverzeichnis lesen und schreiben. Gentle-AI liefert selbst keinen Agenten aus, sondern schreibt lediglich die Konfiguration in den Agenten, den Sie schon haben. Offiziell werden 17 Integrationen angegeben; die Unterschiede je Agent stehen in docs/agents.md, und diese Übersichtstabelle verrät Ihnen zugleich, welche Fähigkeiten ein bestimmter Agent bekommt.

Nehmen Sie sich vor dem Start eine Minute für diese Tabelle und prüfen Sie, ob der Agent, den Sie täglich nutzen, darin steht. Steht er nicht drin, wechseln Sie den Agenten, bevor Sie über Konfiguration sprechen – ein Vorbeischleifen führt nur zu einer Umgebung, die sich nicht installieren lässt und deren Wirkung Sie nicht erklären können.

Maßgeblich für den Installationsort ist das Zielverzeichnis, das im Quickstart für Ihren Agenten genannt wird. Die Startseite sagt nur, dass native Konfiguration erstellt wird, und listet die Ablagepfade je Agent nicht auf – raten Sie also nicht aus dem Gedächtnis und übernehmen Sie nicht einfach den Pfad eines anderen Agenten.

Lassen Sie den Agenten nach der Installation nicht sofort große Umbauten machen. Geben Sie ihm zuerst einen rein lesenden Auftrag: Er soll die Projektstruktur lesen, darlegen, wie er das Repository verstehen will, und einen Plan vorlegen, bevor er etwas tut. Dieser Schritt schreibt keine Dateien und führt keine Befehle aus – das Risiko ist am geringsten. Wenn es um Dateiänderungen, Shell-Ausführung oder externe Anfragen geht, lassen Sie ihn die zu ändernden Dateien und die geplanten Aktionen einzeln auflisten und lassen Sie ihn erst nach Ihrer Bestätigung los.

Zwei beobachtbare Erfolgssignale gibt es: Wechseln Sie in eine andere Sitzung und der Agent kann die in Ihrem Projekt bereits geltenden Konventionen immer noch benennen – die Erinnerung ist also auf der Platte gelandet. Und innerhalb derselben Sitzung hält er einen festen Ablauf ein: erst der Plan, dann das Handeln, dann ein abgleichbarer Nachweis, statt nur eine Antwort zurückzuwerfen. Die offizielle Beschreibung des vollständigen Wegs lautet: Mit einem Prompt bis zu einem Commit mit Prüfergebnis.

Anwendungsfälle

Fall eins: Mit einem Prompt von der Idee bis zum Commit mit Prüfergebnis. Genau diese Linie demonstriert der Abschnitt auf der Repository-Startseite: Die Erinnerung holt den Projektkontext zurück, der Workflow begrenzt die Schritte, die Nachweise erklären die Änderung. Bei den Nachweisen endet es – die Startseite zeigt diese Kette, aber ohne schrittweise Oberflächendetails; die tatsächliche Reihenfolge und die Artefakte richten sich nach Quickstart und docs/intended-usage.md.

Fall zwei: Dem Agenten Erinnerung, Workflow und überprüfbare Nachweise ergänzen. Der Weg ist, gemäß Quickstart Konfiguration für den gewählten Agenten zu schreiben; offiziell genannte Optionen sind persistentes Gedächtnis, ausgewählte skills, MCP-Server und personas. Zu beachten ist: Die Startseite nennt nur die Namen dieser Konfigurationspunkte, nicht welche Datei zu welchem Agenten gehört und was bei Konflikten gilt. Das gehört in docs/agents.md und in die jeweilige Agentendokumentation nachgeschlagen.

Was beide Fälle gemeinsam haben: Sie müssen den Agenten, den Sie gerade nutzen, nicht ersetzen; hinzu kommen nur zwei Dinge – sich merken und klar darlegen. Die Startseite liefert keine quantifizierten Daten zu Effizienz- oder Qualitätsgewinn, also erwarten Sie nicht, dass sie den Nutzen für Sie belegt.

Grenzen des Einsatzes

Es ist eine Konfigurationsebene, kein neuer Agent und keine IDE: Zuerst braucht es einen unterstützten Agenten, in den die Konfiguration hineinschreiben kann. Offiziell werden 17 Integrationen angegeben, doch die Startseite nennt nur einen Teil davon; ob ein bestimmter Editor oder ein Kommandozeilenwerkzeug dabei ist, steht in der Übersichtstabelle in docs/agents.md – verlassen Sie sich nicht darauf, dass alles funktioniert.

Die Startseite beschreibt die zweite Prüfung lediglich als optional und in ihrem Umfang begrenzt, ohne Schwellenwerte oder Einsatzfälle zu nennen. Betrachten Sie sie nicht als Qualitätssperre; wichtige Änderungen sehen Sie sich weiterhin selbst an.

Details zu Installationsort und Ablage der Konfigurationspunkte stehen verstreut in der Dokumentation der einzelnen Agenten; die Startseite liefert nur den Einstieg. Wenn Sie Pfade übernehmen, achten Sie darauf, welchem Agenten der jeweilige Abschnitt gehört.

Dokumentation, Website und Wiki sind derzeit durchweg englisch; übernehmen Sie Befehle und Pfade unverändert und achten Sie auf Groß- und Kleinschreibung. Auf der Repository-Startseite hängen zwei Einstiegspunkte, zur Website und zum Wiki – bei konkreten Konfigurationsfragen zu einem bestimmten Agenten schauen Sie zuerst dort nach einer fertigen Antwort.