Alles als Code: Wie man ein Unternehmen mit einem einzigen Monorepo betreibt

• Kasava verwaltet den gesamten Produktentwicklungsprozess in einem einzigen Monorepo und integriert dabei Code, Dokumentation, Marketing und Betriebsdaten
• Alle Änderungen werden in einem einzelnen Commit abgebildet, sodass Backend, Frontend, Website und Dokumentation gleichzeitig aktualisiert werden
• AI-Tools greifen direkt auf Code, Dokumentation und Website zu, um Konsistenzprüfungen, automatische Dokumentationsaktualisierungen und Content-Reviews durchzuführen
• Mit CLAUDE.md, Selective CI/CD und einer unabhängigen npm-Projektstruktur wird die Komplexität großer Repositories minimiert
• Dieser Ansatz stärkt eine AI-native Entwicklungskultur und beseitigt die Grenzen zwischen Produkt, Content und Betrieb, was schnelle Deployments und Zusammenarbeit ermöglicht

---

Bedeutung von AI-nativer Entwicklung und Monorepo

• Kasava integriert alle Plattformbestandteile in einem einzigen Git-Repository und umfasst nicht nur Code, sondern auch Dokumentation, Marketing, E-Mails und Investorenunterlagen
  • Beispiele: frontend/, backend/, website/, docs/, marketing/, external/ sowie mehr als 5.470 TypeScript-Dateien
• AI greift gleichzeitig auf Code und Dokumentation zu und ermöglicht kontextbasierte Automatisierung
  • Dokumentationsänderungen, Preisänderungen auf der Website und Blog-Validierung werden in einer einzigen AI-Konversation verarbeitet
• Alle Änderungen werden über denselben Git-Workflow (git push) deployt
  • Code, Inhalte, Dokumentation und Marketing durchlaufen dieselben Review-, CI/CD- und Audit-Prozesse
• Dieser Ansatz erhöht Geschwindigkeit und Konsistenz und etabliert eine Kultur, in der „alles als Code verwaltet“ wird

Warum alles in einem Repository zusammenführen?

• Atomare Änderungen über Grenzen hinweg (Atomic Changes)
  • Bei Änderungen an einer Backend-API werden Frontend-Typdefinitionen und Dokumentation im selben Commit aktualisiert
  • Beispiel: Beim Hinzufügen einer Asana-Integration werden Backend, Frontend, Dokumentation und Website in einem PR zusammengeführt
• Single Source of Truth
  • Mit einer einzigen billing-plans.json werden Tarifgrenzen definiert, auf die alle Services verweisen
  • AI prüft automatisch die Konsistenz zwischen Backend, Frontend und Website
• Projektübergreifendes Refactoring
  • In der IDE lassen sich Code, Dokumentation und sogar Blog-Beispiele repositoryweit durchsuchen und bearbeiten
• Gemeinsame Tools und Pipelines
  • Gemeinsames CI/CD, Abhängigkeiten und Suchumgebung vereinfachen die Verwaltung

Repository-Struktur und Komponenten

• Core Application:
  • frontend/ basiert auf Next.js 16 + React 19, backend/ nutzt Cloudflare Workers + Hono + Mastra
  • Bei API-Änderungen werden Typsicherheit und Test-Utilities gemeinsam genutzt
• Marketing:
  • Enthält website/, marketing/blogs/, investor-deck/, email/
  • Blogs, E-Mails und Investorenmaterialien werden alle als Code versioniert und können per git revert zurückgesetzt werden
• Documentation:
  • docs/ ist die öffentliche Dokumentation auf Basis von Mintlify, docs-internal/ enthält interne Architekturdokumente
  • Zusammen mit dem Code durchsuchbar und statt eines Wikis stets in Echtzeit aktuell
• External Services:
  • Umfasst externe Deployment-Services wie Chrome-Erweiterung, Google Docs Add-on und GCP Functions
  • Durch gemeinsame API-Verträge werden Änderungen gleichzeitig übernommen
• Development Infrastructure:
  • Enthält Mock-Server und Test-Tools für die lokale Entwicklung wie github-simulator/, infra-tester/, scripts/

Betriebsweise und Entwicklungskultur

• Keine Workspaces
  • Jedes Verzeichnis bleibt ein eigenständiges npm-Projekt, um Abhängigkeitskonflikte zu vermeiden
• Selective CI/CD
  • GitHub Actions werden pfadbasiert ausgelöst, sodass nur relevante Tests ausgeführt werden
• CLAUDE.md-Regeln
  • In jedem wichtigen Verzeichnis werden Tech-Stack, Befehle und Architekturentscheidungen dokumentiert
  • AI-Assistenten lesen diese Informationen, um den Projektkontext zu verstehen
• Konsistente Tool-Konfiguration
  • Gemeinsame Einstellungen wie .prettierrc, .eslintrc, tsconfig.json bleiben einheitlich

Herausforderungen und Gegenmaßnahmen

• Repository-Größe: Der aktuelle Clone dauert etwa 20 Sekunden, Git zeigt keine Performance-Probleme
  • Große Assets sollen künftig in R2/S3 ausgelagert werden
• Build-Zeit: Jedes Projekt wird unabhängig gebaut, mit schnellen Rebuilds durch Turbopack, Wrangler und WXT
• Berechtigungsgrenzen: Kleine Teams haben Vollzugriff, bei Bedarf lassen sich CODEOWNERS und Branch Protection einsetzen
• Kontextwechsel: Der Wechsel zwischen verschiedenen Sprachen (TypeScript, Apps Script, MJML) wird durch CLAUDE.md und einheitliche Formate erleichtert

Fazit

• Kasavas Monorepo ist nicht nur ein Trend, sondern ein Werkzeug zur Maximierung der Produktivität durch Kontextintegration
• Backend, Frontend, Dokumentation und Marketing arbeiten in einer einzigen Änderung zusammen, und AI validiert dies in Echtzeit
• Dadurch fungiert das „Monorepo“ letztlich nicht als Einschränkung, sondern als Beschleuniger (force multiplier)