Lektion 9

Praxistipps — Das reicht zum Loslegen

Code allein reicht nicht. Build, Deployment, Monitoring — alles muss fuer den Agenten lesbar sein. Docker-Interna verstehen? Unnoetig. Der Agent macht alles.

An den Agenten: “Fuege dem Server einen /health-Endpunkt hinzu. DB-Verbindungsstatus, Fehlerrate, Uptime als JSON zurueckgeben.”

Dieser Satz gibt dem Agenten Augen fuer den Systemzustand. Mit /health kann der Agent maschinell pruefen “Lebt der Server?”

An den Agenten: “Konfiguriere dieses Projekt als docker-compose.yml. App-Server und DB enthalten. docker compose up startet alles.”

Docker ist eine Box, in die die App gepackt wird, damit sie ueberall gleich laeuft. Mehr muss man nicht wissen.

An den Agenten: “Richte automatischen Rollback bei Deployment-Fehler ein. Wenn /health fehlschlaegt, zur vorherigen Version zurueck.”

Drei Saetze. Server bekommt Augen, System wird deklariert, Sicherheitsnetz wird gespannt.


Warum man so anweisen muss

4 Bedingungen fuer Agent Operable System

1. Observability — Alle Zustaende maschinell beobachtbar. /health-Endpunkt, strukturierte JSON-Logs.

2. Declarative — Alle Aktionen deklarativ definiert. docker-compose.yml, Makefile, CI/CD-Workflows. Keine Vermutungen — Dateien sind die Wahrheit.

3. Reversible — Alle Aenderungen verifizierbar und rueckgaengig machbar. Code: git revert. Infrastruktur: Terraform. DB: Migration-Down-Dateien.

4. Human-in-the-loop — Explizite Genehmigungsgates. Tests automatisch ausfuehren = ok. Production-Deployment = Genehmigung erforderlich.

Gesamtpipeline: Von “Feature hinzufuegen” bis zum Deployment

1. SSOT bearbeiten (yongol)
2. Code generieren (yongol generate)
3. Tests bestehen (Hurl + go test)
4. Build (Docker)
5. Deployment (CI/CD)
6. Monitoring (Healthcheck + Logs)
7. Fertig

Was der Mensch tut: “Feature hinzufuegen” + 2x “Genehmigt”. Der Agent: alles andere.


Reins Engineering Gesamtkurs

LektionTitel
Lektion 1Wie man KI anleitet
Lektion 2Warum man KI nicht trauen kann
Lektion 3Apps die nicht kaputtgehen
Lektion 4Entscheidungen aus dem Code heraus
Lektion 5KI mit Zuegeln
Lektion 6Bestanden heisst gesperrt
Lektion 7Schmeichelei umkehren
Lektion 8Die Fabrik des Agenten
Lektion 9Automatisierung jenseits des Codes
Lektion 10Das Gesetz der Daten

Quellenangaben

  • Observability-Prinzip — Maschinell parsbare Ausgaben (/health, JSON-Logs) als Voraussetzung fuer Agentenbetrieb
  • Docker Compose — Deklarative Service-Konfiguration
  • Terraform — Infrastructure as Code
  • Human-in-the-loop — Rueckgaengig machbare Aktionen automatisch, einflussreiche Aktionen mit Genehmigungsgate