Git und GitHub - Artifacture

Dein Code liegt in deinen Repositories. Artifacture legt keine an und hostet keine.

Warum das so bleibt

Es ist die Antwort auf die Frage, die jeder zu Recht stellt: Was passiert, wenn ich hier wieder aufhöre?

Antwort: nichts. Deine Repositories gehören dir, liegen dort, wo du sie angelegt hast, und haben keine Abhängigkeit zu uns. Was Artifacture kennt, sind die Adressen und die Vorgeschichte deiner Items — nicht der Code selbst.

Wie die Ablage aussieht

Zwei Ebenen. Oben das Umbrella: ein eigenes Repository, das dein Projekt beschreibt, ohne es zu enthalten — Architekturentscheidungen, Projektanweisungen, Dokumentation. Darunter, in src/, deine Code-Repositories, jedes mit eigener Historie und eigenen Berechtigungen.

mein-projekt/          das Umbrella, eigenes Repository
  CLAUDE.md
  ADR/
  Docs/
  src/
    api/               dein Code, eigenes Repository
    web/               dein Code, eigenes Repository

Das Umbrella verfolgt den Inhalt von src/ nicht mit. Beide Ebenen bleiben getrennt, und du kannst jederzeit eine davon allein weiterverwenden.

Zwei Regeln, an die wir uns halten

Nichts wird überschrieben, was du geschrieben hast. Der Setup-Befehl legt fehlende Repositories an ihren Platz und aktualisiert vorhandene nur vorwärts. Kein Zurücksetzen, kein erneutes Klonen über einen bestehenden Arbeitsstand. Unfertige Arbeit im Verzeichnis bleibt unfertige Arbeit im Verzeichnis.

Alles unterhalb von src/ ist tabu. Wenn das Toolset erneuert wird, wird alles darüber aktualisiert und dein Code nicht angefasst. Damit lässt sich der Setup-Befehl gefahrlos auf einem Rechner ausführen, auf dem schon gearbeitet wurde.

GitHub oder etwas anderes

Der Standardweg ist GitHub, aber Artifacture kennt nur Git-Adressen. Was dahinter liegt, ist deine Sache — ein anderer Anbieter, ein eigener Server. Solange dein Assistent die Zugangsdaten hat, funktioniert es.

Was du damit zu tun hast

Ein leeres Repository für das Umbrella anlegen und es in Artifacture hinterlegen. Liegt dein Code schon irgendwo, trägst du die Repositories im Projekt-Setup dazu ein — einen Namen und die Adresse, je Dienst eine Zeile.

Alles Weitere macht der Setup-Befehl.

Was im Umbrella liegt und warum → Das Umbrella
Der Ablauf beim Anlegen → Erste Schritte