Open-Source-Full-Stack-Template mit FastAPI, React 19 und Postgres. Mocks und ungetestete Routen führen zum Build-Fehler, damit KI-Agenten ehrlich bleiben.

Beschreibung

burntop ist ein Open-Source-Full-Stack-Template, das speziell für Anwendungen entwickelt wurde, die von KI-Programmieragenten erstellt werden. Es umfasst FastAPI, React 19 (TanStack Start), Tailwind 4, shadcn/ui und PostgreSQL 18 sowie Session-basierte Authentifizierung, Google OAuth, Referenz-CRUD-Funktionalität und eine sofort einsatzbereite Docker-Compose-Konfiguration. Der entscheidende Unterschied sind die Schutzmechanismen. Das Template setzt ausschließlich auf End-to-End-Tests: 161 Backend-Tests gegen eine echte Postgres-Instanz und 42 Playwright-Tests gegen den gesamten Stack. 39 Mocking-Bibliotheken sind verboten, sodass das Importieren eines Mocks den Build fehlschlagen lässt. Eine Route, die von keinem Test aufgerufen wird, eine Seite ohne zugehörige Spec oder ein Modell ohne Migration führen ebenfalls zum Abbruch. Eine Funktion gilt erst dann als fertig, wenn „make ci“ erfolgreich durchläuft – so kann die KI keine grünen Häkchen vortäuschen. Kompatibel mit Claude Code, Cursor, Codex oder jedem Agenten, der AGENTS.md liest. Verschachtelte AGENTS.md-Dateien und ein Skill für Projektstandards geben dem Agenten vor, wie neue Funktionen implementiert werden. Kostenlos; der Quellcode ist öffentlich auf GitHub verfügbar: https://github.com/agusmdev/fullstack-ai-template