A Vipe Coding POC – Prompt 2 – Review & Spec-Abgleich

Prompt 2 — Review & Spec-Abgleich

Jetzt wird es spannend. Codex hat im ersten Schritt die Grundstruktur gebaut, aber Prompt 2 ist der Moment, in dem klar wird, ob das alles wirklich der SPEC entspricht oder ob wir schon früh in die falsche Richtung laufen.
Der Auftrag war simpel: „Prüfe alles gegen SPEC.md, liste Abweichungen auf, korrigiere sie.“

Und genau das passiert hier. Kein Skill, kein Pattern, kein fancy Agent.
Nur ein klassischer Spec-Review: Dateien prüfen, Pfade vergleichen, Services abgleichen, Dockerfile gegen die Vorgaben halten, nginx-Routing checken, index.php anschauen.
Ein nüchterner, technischer Abgleich.

Codex geht das erstaunlich gründlich an. Erst wird die Struktur auditiert, dann werden fehlende Verzeichnisse identifiziert, .gitkeep-Dateien gesetzt, damit alles versionierbar ist.
Danach folgt der Blick auf das PHP-Dockerfile: Composer-Installation korrigiert, Extensions sauber eingebaut, Opcache aktiviert.
Alles so, wie es in der SPEC steht.

Auch nginx bekommt ein Update: Frontcontroller-Routing präzisiert, Query-Strings durchgereicht, die Routen /, /api, /docs, /health und /metrics sauber abgebildet.
Nichts Spektakuläres, aber wichtig.

Die Skripte migrate.sh und seed.sh werden auf Ausführbarkeit geprüft, YAML wird einmal kurz syntaktisch getestet, und am Ende landet alles in einem Commit.
Sogar der PR wird aktualisiert.
– technisch, methodisch, fast schon chirurgisch.

Was wurde korrigiert?

  • Die Ordnerstruktur entsprach nicht vollständig der SPEC — fehlende Verzeichnisse wurden ergänzt und mit .gitkeep versionierbar gemacht.
  • Das PHP-Dockerfile wurde überarbeitet: Composer-Installer statt Copy, Extensions und Opcache sauber eingebaut.
  • nginx-Routing wurde präzisiert und an die SPEC angepasst.
  • Alle Services in der Compose sind korrekt konfiguriert, inklusive node-build im Profil build.
  • public/index.php ist weiterhin minimal und korrekt.

Review-Checkliste

  • Pfade/Struktur: vollständig und nachweisbar.
  • Services: alle vorhanden und spec-konform.
  • node-build: korrekt im Profil build.
  • PHP Dockerfile: wird korrekt verwendet.
  • nginx Routing: korrekt.
  • index.php: minimal & korrekt.

Testing

PHP Syntax: alles grün.
Skripte ausführbar: ja.
Docker Compose Test: nicht möglich (CLI nicht verfügbar).

Damit ist Prompt 2 abgeschlossen. Die Struktur steht jetzt nicht nur, sie ist auch wirklich spec-konform.
Der erste kleine Stolperstein ist damit ausgeräumt — und das Projekt fühlt sich plötzlich ein Stück realer an.