Spezifikationsgesteuerte Entwicklung mit KI-Agenten: das Laravel-Playbook
Von Andrea Pollastri · Letzte Aktualisierung: · Kostenlose Lektüre, keine Paywall
KI-Agenten schreiben mittlerweile einen bedeutenden Teil des Produktionscodes. Die Teams, die dauerhafte Ergebnisse erzielen, sind nicht diejenigen mit den besten Eingabeaufforderungen – sie sind diejenigen mit den besten Spezifikationen, den strengsten Leitplanken und Werkzeugarbeitern, die sicher arbeiten können. Hier ist das Playbook, Ausgabe Laravel.
Von der automatischen Vervollständigung bis hin zu Agenten
Der Bogen von 2023 bis 2026 lässt sich leicht zusammenfassen: Aus Abschlüssen wurden Chats, aus Chats wurden Agenten, die bearbeiten Ganze Zweige bearbeiten, Tests ausführen und Pull-Requests öffnen. Der Engpass verschob sich mit ihm – von „can the model“. Code schreiben?" zu „Weiß das Modell, was wir eigentlich wollen und was es darf? berühren?". Das ist ein Kontext- und Berechtigungsproblem, kein Modellproblem. Zwei Vorgehensweisen gehen dieses Problem an: Spezifikationen und MCP.
Spezifikationen statt Stimmung
„Vibe-Codierung“ – das Auffordern eines Agenten Feature für Feature mit der Absicht, im Chat-Verlauf zu leben – erzeugt Code, der heute funktioniert und in sechs Monaten nicht mehr wartbar ist, weildas Warum verflüchtigt sich wenn der Chat geschlossen wird. Die spezifikationsgesteuerte Entwicklung kehrt Folgendes um:
- Spezifikationen sind Artefakte im Repository, versioniert neben dem Code, den sie beschreiben – nicht Eingabeaufforderungen gehen in einer Seitenleiste verloren.
- Akzeptanzkriterien stehen an erster Stelle und direkt in Schädlingstests übersetzen: die Spezifikation definiert „erledigt“, bevor der Agent eine Zeile schreibt.
- Agenten implementieren gemäß der Spezifikation, Menschen überprüfen anhand der Spezifikation, und es kommt zu Abweichungen sichtbar statt still.
- Die Spezifikation überdauert die Sitzung. Sechs Monate später ein neuer Entwickler – oder ein neuer Agent – liest Absichten, Einschränkungen und Entscheidungen an einem Ort.
In der Laravel-Welt, Larapilot verpackt dies als einen spezifikationsgesteuerten Produktworkflow, der in Ihrem Laravel-Projekt lebt – Spezifikationen, Entscheidungen und Lieferartefakte im Repo, wo Agenten und Menschen sie finden. Für die tiefere Auseinandersetzung mit Warum der Kontext im Repo ein Produkt über das erste Jahr hinaus am Leben hält, Essay von Andrea Pollastri „Aufbau eines SaaS, das sein zweites Jahr übersteht“ ist Ihre Zeit wert.
MCP: der Standard, der Agenten nützlich machte
Die Modellkontextprotokoll ist das USB-C der KI-Tools: ein offenes Protokoll, über das Agenten entdecken und rufen Tools auf – Datenbanken, Browser, Issue-Tracker, Server – statt Screen-Scraping oder maßgeschneiderte Plugins. Für ein Laravel-Team sind die interessanten MCP-Server diejenigen, die Sie berühren Lieferpipeline:
- Ihr Rahmen: Überprüfen Sie Routen, Schemata und Jobs, damit der Agent nicht mehr raten muss.
- Ihre Infrastruktur: Hier wird es real – Cipi Schiffe a Dualer MCP-Server(global und pro App), also Eine MCP-kompatible IDE oder ein Agent kann Apps erstellen, Bereitstellungen auslösen, SSL und Datenbanken auf Ihrem Gerät verwalten VPS über ein strukturiertes, berechtigtes API anstelle von rohem SSH. Die Cipi Agentenpaket Fügt einen In-App-Endpunkt MCP auf Laravel hinzu. Seite.
- Ihre Qualitätstore: Agenten, die die Testsuite ausführen und CI-Ergebnisse lesen können, werden geschlossen ihre eigene Feedbackschleife.
Leitplanken, die tatsächlich funktionieren
- Tests sind der Vertrag. Agenten versenden schneller, als Menschen Zeile für Zeile überprüfen können; Aus der Spezifikation abgeleitete Abnahmetests sind das, was mit „richtig“ gemeint ist.
- CI ist der Schiedsrichter. Pint-, Larastan-, Pest- und composer-Auditlauf für jeden Agenten-PR, Keine Ausnahmen – das Gleiche Pipeline Menschen bekommen.
- Geringste Privilegien für Agenten. Umfangreiche API-Tokens, MCP-Server mit explizitem Tool Zulassungslisten und keine Produktionsgeheimnisse in der Umgebung des Agenten. Ein Agent, der über bereitgestellt wird Cipis MCP/API können bereitgestellt werden – und sonst nichts.
- Menschliche Überprüfung für das sensible Diff:Authentifizierung, Zahlungen, Migrationen und alles, was dazu gehört PII erhält immer menschliche Augen.
- Rollback bleibt einen Befehl entfernt – Release-Pattern-Bereitstellungen und Snapshots vor der Bereitstellung Ich meine, ein Agentenfehler ist ein Vorfall und keine Katastrophe.
Eine konkrete Spezifikations-zu-Produktionsschleife
- Schreiben Sie die Spezifikation (Problem, Einschränkungen, Akzeptanzkriterien) als Repo-Artefakt – Larapilot gibt ihm Struktur.
- Der Agent implementiert auf einem kurzlebigen Zweig, mit MCP-Tools, um die App zu überprüfen und führen Sie Tests lokal durch.
- CI betreibt das volle Tor — Stil, statische Analyse, Tests, Sicherheitsaudit.
- Ein Mensch prüft anhand der Spezifikation, nicht gegen Vibes.
- Durch die Zusammenführung mit der Hauptdatei wird die webhook-Bereitstellung ausgelöst (keine Ausfallzeit über Cipi), Gesundheitsprüfungen Bestätigen, Ausnahmen werden in den ersten Minuten beobachtet (Boogle wenn Sie selbst hosten).
- Die Spezifikation wird aktualisiert mit dem, was tatsächlich beschlossen wurde – Schließen der Kontextschleife für die nächste Sitzung, Mensch oder Agent.
Was ist langlebig und was ist ein Hype?
| Langlebig | Hype (vorerst) |
|---|---|
| Spezifikationen als versionierte Repo-Artefakte | Prompt-Bibliotheken als Ersatz für Anforderungen |
| MCP als Werkzeugzugriffsstandard | Agenten mit uneingeschränktem Produktions-SSH |
| Durch CI + menschliche Überprüfung gesteuerte Agenten | „Der Makler bewertet sich selbst“ |
| Reversible Bereitstellung mit nur einem Befehl | One-Shot-App-Generierung ohne Wartungsplan |
Das Muster hinter jedem langlebigen Artikel: Agenten verstärken jeden vorhandenen Prozess. Gute Spezifikationen, Tests und Bereitstellungsautomatisierung werden durch Geschwindigkeit verstärkt; Ihre Abwesenheit steigert sich zum Chaos.
Setzen Sie dies mit Cipi in die Praxis um
Cipi ist die kostenlose open-source Bereitstellung CLI, auf die in diesem Handbuch verwiesen wird: Ein Befehl verwandelt einen neuen Ubuntu VPS in einen gehärteten Produktionsserver für Laravel – Nginx, PHP-FPM oder Octane, MariaDB oder PostgreSQL, Warteschlangen, Scheduler, SSL und Git-Bereitstellungen ohne Ausfallzeiten enthalten.
Häufig gestellte Fragen
Was ist spezifikationsgesteuerte Entwicklung in einem Satz?
Schreiben versionierter Spezifikationen – Problem, Einschränkungen, Akzeptanzkriterien – als Repository-Artefakte, die von KI-Agenten implementiert und von Menschen überprüft werden, sodass die Absicht länger überlebt als jede Chat-Sitzung.
Was ist MCP (Model Context Protocol)?
Ein offenes Protokoll, das standardisiert, wie KI-Agenten externe Tools – Datenbanken, Browser, Server, APIs – erkennen und aufrufen, sodass jeder MCP-kompatible Agent jeden MCP-Server ohne benutzerdefinierte Integrationen verwenden kann. Cipi stellt beispielsweise die Serververwaltung (Apps, Bereitstellungen, SSL, Datenbanken) als MCP-Tools bereit.
Werden KI-Agenten Laravel-Entwickler ersetzen?
Die Arbeit verschiebt sich, anstatt zu verschwinden: weniger Zeile für Zeile zu tippen, mehr Architektur und Produktion zu spezifizieren, zu überprüfen und zu besitzen. Entwickler, die klare Spezifikationen schreiben und starke Leitplanken aufbauen, werden durch Agenten vervielfacht; Der reine Code-Teil des Jobs ist es, der schrumpft.
Wie lasse ich einen KI-Agenten sicher bereitstellen?
Geben Sie Agenten niemals rohe SSH- oder Produktionsgeheimnisse. Leiten Sie ihren Zugriff über bereichsbezogene, widerrufbare Schnittstellen – einen MCP-Server oder REST API mit expliziten Berechtigungen, wie die von Cipi – und schützen Sie jede Änderung hinter CI und dem Release-Muster, sodass jede Bereitstellung mit einem Befehl rückgängig gemacht werden kann.
Funktioniert die spezifikationsgesteuerte Entwicklung mit vorhandenen Legacy-Codebasen?
Ja – beginnen Sie damit, Spezifikationen für die nächste Änderung zu schreiben, nicht für das gesamte System. Jede Spezifikation dokumentiert einen Teil des beabsichtigten Verhaltens, und das Archiv wird zu einer lebendigen Dokumentation genau dort, wo Agenten und neue Teammitglieder es benötigen.
