Turborepo

Turborepo ist ein Skill aus dem offiziellen Turborepo-Repository von Vercel. Laut Anbieter beschreibt er, wie ein Agent JavaScript- und TypeScript-Monorepos mit dem Turborepo-Buildsystem analysiert, strukturiert und betreibt. Der Skill ist keine eigene Buildplattform, kein Hostingkonto und kein Ersatz für das Turborepo-CLI. Er liefert Anweisungen für typische Fragen rund um turbo.json, Aufgaben, Abhängigkeiten, Cache-Ausgaben, Umgebungsvariablen, Filter, betroffene Pakete, CI und Paketgrenzen. Die fachliche Verantwortung für Quellcode, Toolchain, Runner und Freigaben bleibt beim Projektteam.

Aufgaben als Paketverantwortung

Die zentrale Empfehlung der Primärquelle lautet, Aufgaben möglichst als Skripte in den jeweiligen Paketen zu definieren. Anwendungen und Bibliotheken beschreiben ihre eigenen Build-, Test- und Lint-Skripte, während die Root-Konfiguration diese Aufgaben mit Turborepo orchestriert. Das hält Verantwortlichkeiten nahe am Code und erlaubt dem Abhängigkeitsgraphen, unabhängige Arbeit parallel zu planen. Root-Aufgaben sind nur für echte Repository-Aufgaben gedacht, die keinem Paket gehören. Der Skill hilft, solche Grenzen zu erkennen und verhindert, dass ein Root-Skript die Paketstruktur durch manuelle Verzeichniswechsel oder verkettete Einzelbefehle umgeht.

Graph, Cache und Konfiguration

Die Anleitung ordnet dependsOn, outputs, inputs, env und persistente Entwicklungsaufgaben in den Aufgaben-Graphen ein. Abhängigkeiten zwischen Paketen sollen in den Workspace-Metadaten sichtbar sein, damit eine Konfiguration mit ^build die richtige Reihenfolge herstellen kann. Ausgaben müssen beschrieben werden, wenn sie zuverlässig wiederhergestellt werden sollen. Änderungen an relevanten Umgebungsvariablen und dotenv-Dateien müssen in die Hash-Eingaben einfließen, sonst können veraltete Ergebnisse als gültig erscheinen. Für Aufgaben, die parallel laufen dürfen, deren Cache aber von Abhängigkeiten invalidiert werden muss, beschreibt die Quelle Transit-Nodes als sauberes Muster. Cache-Treffer sind dabei ein Optimierungsmechanismus und kein Beweis für fachlich korrekte Ergebnisse.

Filter, CI und Entwicklung

Für große Monorepos erklärt der Skill die Auswahl nach Paketnamen, Pfaden, Abhängigkeiten und Änderungen. Die Option affected ist laut Anbieter der bevorzugte Weg, geänderte Pakete und ihre abhängigen Pakete zu bestimmen; eine abweichende Vergleichsbasis wird ausdrücklich über die passende Umgebungsvariable festgelegt. In CI sollen Skripte die ausgeschriebene Form turbo run verwenden, während die kürzere Schreibweise für einzelne interaktive Terminalaufrufe gedacht ist. Für Entwicklungssitzungen behandelt die Quelle turbo watch, persistente Prozesse, Abhängigkeiten zwischen Entwicklungsaufgaben und interruptible-Aufgaben. Diese Hinweise ersetzen keine Prüfung des tatsächlichen CI-Systems, der Shell, der Package-Manager-Konfiguration oder der verwendeten Turborepo-Version.

Grenzen, Sicherheit und Einordnung

Der Skill liest oder verändert nicht automatisch ein Repository und gewährt keine Berechtigungen. Ein Agent kann dennoch bei einer konkreten Ausführung Dateien, Build-Artefakte, Logs oder CI-Konfigurationen verarbeiten. Tokens, Zugangsdaten und private Umgebungswerte gehören nicht in Skilltexte, Prompts, Commit-Historie oder Protokolle. Remote Cache und CI können Quellinformationen, Metadaten oder Artefakte an weitere Systeme übertragen; Aufbewahrung, Zugriff, Region und Anbieterbedingungen sind vor dem Einsatz zu prüfen. Ein lokaler Build macht Daten nicht automatisch vertraulich, wenn ein ausgewählter Agent oder Modellanbieter Inhalte verarbeitet. Die offizielle Vercel- und Turborepo-Dokumentation bleibt für aktuelle Konfigurationsdetails maßgeblich. Das Repository nennt MIT als Lizenz. Aktuelle Nutzungsbedingungen sollten direkt beim Anbieter geprüft werden; konkrete Preise nennt dieser Eintrag nicht.