Git-Setup für das Konzept

So setzt du GitHub-Account, Organisation und Repository auf, damit das Heimatdesign-Konzept als Markdown abgelegt und mit mir früh codebasiert geteilt werden kann. Hintergrund: Das Projekt von Anfang an LLM-lesbar und context-engineering-tauglich aufstellen.

1 – GitHub-Account anlegen
  1. Auf github.com/signup registrieren
  2. Geschäftliche E-Mail nutzen – die, unter der du auch sonst auftrittst
  3. Username kurz und klar wählen, z. B. mroebbecke oder marc-roebbecke
  4. Free-Plan reicht – private Repos sind inklusive
  5. Zwei-Faktor-Authentifizierung direkt aktivieren: Settings → Password and authentication → 2FA
2 – Organisation anlegen

Eine Organisation trennt das Projekt sauber von deinem persönlichen Account und macht die Rechtevergabe einfacher.

  1. Oben rechts auf das Profilbild → Your organizationsNew organization
  2. Plan: Free
  3. Name: heimatdesign (oder heimatdesign-org, falls vergeben)
  4. Kontakt-E-Mail eintragen, „belongs to my personal account" wählen
  5. Onboarding-Schritt „Invite members" überspringen – das machen wir später
3 – Repository anlegen
  1. In der Organisation: New repository
  2. Name: konzept oder heimatdesign-konzept
  3. Visibility: Private – später ggf. öffnen
  4. „Add a README file" anhaken
  5. „Add .gitignore" → None – für reine Markdown-Repos nicht nötig
  6. Create repository
4 – Mich einladen

Repository öffnen → SettingsCollaborators and teamsAdd people.

Rolle: Write – kann pushen, aber keine Settings ändern. Weitere Mitlesende ergänzen wir später, wenn die Konstellation steht.

5 – Struktur für LLM-Lesbarkeit

Dateien direkt im Browser anlegen: Repository → Add fileCreate new file. Empfohlene Grundstruktur:

README.md                  ← Einstieg: Was ist das Projekt, wer macht mit, wo liegt was
CONTEXT.md                 ← Globaler Projekt-Kontext für LLMs (Vision, Stakeholder, Constraints)
konzept/
  00-vision.md
  01-zielgruppen.md
  02-formate.md
  03-programm.md
  ...
recherche/
  referenzen.md
  inspiration.md
meetings/
  2026-04-29-kickoff.md
decisions/
  001-name.md             ← ein Entscheid pro Datei (ADR-Stil)

Konventionen, die LLM-Arbeit später viel leichter machen:

6 – Arbeiten ohne Git-CLI

Git muss nicht lokal installiert werden. Drei einfache Wege:

7 – Was du davon hast, dass es im Git liegt

Sobald das Repository steht:

Unsicher beim ersten Setup? Kurze Nachricht an David – ich kann das initiale Scaffolding einmalig anlegen, sobald ich als Collaborator hinzugefügt bin.