Das Cookbook

Das Cookbook ist eine Sammlung von Markdown-Rezepten, die Ihr Agent bei Bedarf abruft. Die Rezepte schreiben wir, also Menschen, auf Grundlage echter Deploys. Angewendet werden sie mit dem Urteilsvermögen Ihres Agenten.

Was drinsteht

Ein Paket, nach Themen geordnet: der Standard-Ablauf für Deploys, eine Checkliste zur Überprüfung, Rezepte zur Fehlersuche, Kontingentgrenzen und wie man mit ihnen umgeht, laufender Betrieb sowie Muster für mehrere Apps und Services. Stack-spezifische Fallstricke, etwa eine Eigenheit beim Prerendering in Next.js, eine Allowlist für Preview-Hosts in Astro oder die Dimensionierung eines Paars aus FastAPI und Celery, stehen in diesen Abschnitten. So muss Ihr Agent sie nicht bei jedem Deploy neu lernen.

Ihr Agent bekommt das Cookbook mit einem einzigen Aufruf von nyx_brain, zusammen mit dem aktuellen Zustand Ihres Projekts. Darin stehen der immer gültige Kern und die Stack- und Themenrezepte, die für Ihr Repo und Ihr Briefing am relevantesten sind. Einen weiteren Abrufschritt auf Seiten des Agenten gibt es nicht. Die Auswahl passiert auf dem Server, bevor die Antwort rausgeht.

Auf einer dedizierten Instanz gehen die eigenen Regeln Ihrer Organisation vor. Ihre Referenzarchitekturen und Ihre Cloud-Strategie haben Vorrang vor jedem Rezept. Siehe Architekturvorgaben.

Warum statisch und nicht generiert

Wir lassen das Rezept nicht zur Laufzeit von einem LLM schreiben. Dafür gibt es drei Gründe:

• Vorhersagbarkeit. Ein Rezept, das gestern funktioniert hat, funktioniert auch heute. Zwischen zwei Deploys verändert sich nichts unbemerkt.
• Fehlersuche. Geht etwas schief, können wir genau den Text lesen, den der Agent gesehen hat, und nachvollziehen, warum.
• Prüfbar und unabhängig veröffentlicht. Ein Rezept ist fester Text und keine neue Generierung. Deshalb können wir genau festhalten, welche Version bei einem Deploy im Einsatz war. Und wir aktualisieren Rezepte in ihrem eigenen Rhythmus, entkoppelt vom Backend, ohne Redeploy und ohne Neubau des Agenten auf Ihrer Seite.

Urteilsvermögen statt Orchestrierung

Das Rezept ist ein Vorschlag aus Erfahrung, keine feste Abfolge. Sieht Ihr Agent etwas, womit das Rezept nicht gerechnet hat, etwa eine ungewöhnliche Build-Konfiguration, ein fehlendes Secret oder eine Registry, die das Rezept nicht kennt, weicht er ab. Eine Zustandsmaschine erzwingen wir nie.

Darin liegt der Kompromiss. Die Ausgaben sind von Lauf zu Lauf nicht byte-gleich, aber im Ergebnis gleichwertig. Zwei Deploys desselben Repos durch denselben Agenten enden beide mit App Available, erreichbarem Ingress und vorhandener Dokumentation.

Rezepte lesen

Rezepte richten sich an Agenten. Sie sind im Imperativ in der zweiten Person geschrieben und sprechen den Agenten an, der sie liest. Auf dieser Website blättern Sie nicht darin.

Wollen Sie sehen, was Ihr Agent bei einem bestimmten Deploy gesehen hat, fragen Sie den Agenten. Das Cookbook ist das Ergebnis des Tools nyx_brain, und in den meisten Clients können Sie die Ergebnisse von MCP-Tools einsehen.

Weiter: Next.js-App ausrollen