Dokumentation

Erstellen Sie Ihr erstes Projekt

Wandeln Sie ein verbundenes Repository in ein Projekt um, das Coroid analysieren, erstellen und testen kann.

Eine Verbindung macht Repositorys verfügbar. Ein Projekt ist die Basis, auf der Coroid tatsächlich arbeitet: Ein Projekt entspricht einem Repository und übernimmt dessen Build-Befehle, Test-Befehle, Kontext und Einstellungen.

Erstellen Sie eines aus Projekte → Neu.

Was beim Erstellen passiert

Coroid kopiert das Repository und führt eine erste Analyse durch. Dabei wird festgestellt:

  • welche Programmiersprachen und Frameworks vorhanden sind
  • wie das Projekt erstellt wird
  • wie die Tests ausgeführt werden
  • ob eine Containerisierung möglich ist

Diese Analyse ermöglicht es später einem Agenten, Ihren Code zu kompilieren und Ihr Testpaket auszuführen. Nehmen Sie sich jetzt zwei Minuten Zeit dafür – denn alles Weitere hängt davon ab, dass diese Analyse korrekt ist.

Überprüfen Sie, was erkannt wurde

Öffnen Sie die Einstellungen des Projekts und bestätigen Sie die Build- und Test-Befehle. Die Erkennung funktioniert gut bei konventionellen Aufbauweisen und weniger gut bei:

  • Monorepos, bei denen die Befehle in einem Unterordner liegen
  • Projekten, die vor dem Ausführen der Tests einen Einrichtungsschritt benötigen (Code-Generierung, Migrationen)
  • Testpaketen, die zuvor Dienste wie eine Datenbank oder eine Warteschlange benötigen

Falls einer dieser Fälle zutrifft, korrigieren Sie die Befehle manuell. Ein Agent, der Ihre Tests nicht ausführen kann, ist nicht in der Lage, seine eigene Arbeit zu verifizieren – das zeigt sich später darin, dass Aufgaben aus Gründen scheitern, die nichts mit der Änderung zu tun haben.

Sprachunterstützung

Agenten schreiben Code in jeder Programmiersprache, die in Ihrem Repository verwendet wird. Der Unterschied liegt darin, wie viel Coroid unabhängig verifizieren kann – lesen Sie dazu Sprachunterstützung und die Agentenumgebung über die in jedem Arbeitsbereich vorinstallierte Toolchain sowie über die Sprachen, für die ein Sprachserver zur Verfügung steht.

Ein Repository oder mehrere?

Ein Projekt pro Repository. Falls Ihr System mehrere Repositorys umfasst, erstellen Sie für jedes ein Projekt – Coroid kann dann die Arbeit koordinieren, die diese überspannt.

Widerstehen Sie der Versuchung, zwei Projekte auf dasselbe Repository zu richten, um verschiedene Arbeitsstränge darzustellen – verwenden Sie stattdessen Pläne, Sprints oder Spuren, damit beide Stränge dieselbe Sicht auf den Codebasis haben.

Weiter

Führen Sie Ihre erste Aufgabe aus – beschreiben Sie eine Aufgabe und verfolgen Sie ihren Verlauf.