How To mindCode

1 · Was ist mindCode?

mindCode ist unser interner Git-Server. Stell dir GitHub vor, aber selbst gehostet, nur für mindsquare-Kollegen, mit unserem Microsoft-Account-Login. Hier kommt rein:

• Konzepte für Kundenprojekte (Markdown, Diagramme)
• Wiederverwendbare Code-Templates und Skill-Markdowns
• Diskussion zu neuen Ideen vor dem Kundeneinsatz
• Versionierte Doku für interne Tools

2 · Einloggen

1. Öffne mindcode.mindsquare.de/user/login im Browser.
2. Klicke auf den orangen Button „Sign in with entra".
3. Microsoft-Maske → mit deinem mindsquare-Account anmelden (gleiches Passwort wie für Outlook/Teams).
4. Beim ersten Login wird automatisch ein mindCode-Account für dich angelegt. Dein Username = Local-Part deiner Email (also richter für richter@mindsquare.de).

3 · Dein erstes Repository erstellen

Ein Repository (kurz: Repo) ist wie ein Ordner mit Versionsgeschichte. Jede Idee, jedes Konzept, jedes Tool kommt in sein eigenes Repo.

1. Oben rechts neben deinem Avatar auf das +-Symbol → „Neues Repository".
2. Owner: dein eigener Account (für persönliche Drafts) oder eine Org wie aito, mindsquare, sandbox (für offizielle Sachen).
3. Repository Name: kurz, kleinbuchstaben, mit Bindestrichen statt Leerzeichen.
   ✓ customer-onboarding-konzept

   ✗ Mein cooles Konzept!!
4. Beschreibung: ein Satz, was drin ist. Wird in der Repo-Liste angezeigt.
5. Visibility: standardmäßig Public (= alle mindCode-User sehen es). Nur auf Private stellen, wenn die Inhalte wirklich sensibel sind.
6. Initialize Repository ankreuzen, plus:
   • README.md ✓ (immer)
   • .gitignore → passenden Template wählen (z.B. Node, Python, VisualStudio)
   • License → leer lassen für interne Sachen
7. Create Repository klicken. Fertig.

4 · Repo lokal klonen

Damit du am Code arbeiten kannst, brauchst du eine lokale Kopie. Das nennt man klonen.

1. Auf der Repo-Seite oben rechts auf „HTTPS" oder „SSH" klicken und die URL kopieren.
   Welches nehmen? Erstmal HTTPS, ist einfacher. Später SSH einrichten (siehe Abschnitt 9) — dann musst du nicht jedesmal Passwort eingeben.
2. Im Terminal: in den Ordner navigieren, wo das Repo hin soll.

   cd ~/projects

3. Klonen:

   git clone https://mindcode.mindsquare.de/aito/customer-onboarding-konzept.git
   cd customer-onboarding-konzept

4. Beim ersten Mal fragt Git nach Username + Passwort. Username = dein mindCode-Username (z.B. richter). Password = dein Personal Access Token, NICHT dein Microsoft-Passwort.
   Microsoft-Passwort funktioniert nicht für Git! Du brauchst einen Token. So gehts:

   1. In mindCode: Avatar → Settings → Applications → Generate New Token
   2. Name: z.B. „MacBook Robert"
   3. Scopes: read:repository, write:repository
   4. Token kopieren (wird nur EINMAL angezeigt!)
   5. Statt Passwort den Token im Terminal eingeben

5 · Erste Änderung committen & pushen

Drei Schritte: Datei ändern → Commit → Push.

5.1 · Datei ändern

Editor deiner Wahl auf, README anpassen oder neue Datei erstellen:

echo "# Customer Onboarding Konzept

Hier sammeln wir den Standard-Prozess für SAP-Kunden-Onboarding.

## Phasen
1. Discovery
2. Setup
3. Go-Live" > README.md

5.2 · Status checken

Was hat Git gesehen?

git status

Output sollte zeigen, dass README.md modifiziert wurde.

5.3 · Stagen & committen

git add README.md
git commit -m "README mit Phasen-Übersicht ergänzt"

5.4 · Pushen

Lokales Commit zum Server hochladen:

git push origin main

Fertig. Deine Änderung ist online auf mindCode sichtbar.

6 · Mit Markdown arbeiten

mindCode versteht Markdown — die README wird im Web automatisch gerendert.

console.log("hi")

6.1 · Bilder einbinden

Bild ins Repo legen (z.B. unter docs/screenshot.png), dann im Markdown:

![Beschreibung des Bildes](docs/screenshot.png)

6.2 · Diagramme mit Mermaid

mindCode rendert Mermaid-Diagramme automatisch. Beispiel:

```mermaid
flowchart LR
    Discovery --> Setup --> GoLive
```

Wird zu einem schicken Flowchart-Diagramm, ohne Bild-Datei.

7 · Branches & Pull Requests

Bei größeren Änderungen direkt auf main zu pushen ist nicht ideal. Besser: Branch anlegen, Änderungen machen, dann Pull Request stellen, andere reviewen, danach mergen.

7.1 · Branch erstellen

git checkout -b feature/phase-3-detaillieren

Branch-Naming-Konvention bei mindsquare:

• feature/... — neue Funktionalität
• fix/... — Bugfix
• docs/... — nur Doku-Änderungen
• experiment/... — Spielwiese

7.2 · Änderungen + Push

git add .
git commit -m "Phase 3 Detailbeschreibung ergänzt"
git push origin feature/phase-3-detaillieren

7.3 · Pull Request stellen

1. Im mindCode-Web auf das Repo gehen.
2. Ganz oben erscheint ein Banner: „You pushed a new branch — Compare & Pull Request" → klicken.
3. Title: Was die Änderung erreicht (z.B. „Phase 3 Detail-Doku"). Description: Warum, was, was nicht. Bei Bedarf @-mention von Reviewern.
4. Create Pull Request klicken.
5. Reviewer geben Kommentare. Du machst Anpassungen → git push → PR aktualisiert sich automatisch.
6. Wenn alle zufrieden: Merge Pull Request. Default-Strategie bei mindsquare: Squash Merge (alle Commits werden zu einem zusammengefasst).

8 · Issues & Diskussion

Du hast eine Idee aber keinen Code dafür? Was unklar? Bug entdeckt? → Issue erstellen.

1. Im Repo: Tab Issues → New Issue.
2. Title: kurze Zusammenfassung. Description: Markdown-formatiert. Was, warum, ggf. Schritte zum Reproduzieren.
3. Labels nutzen: bug, idea, question, blocker.
4. Assignees: wer kümmert sich? Du selbst oder eine Kollegin per @-mention.
5. Submit. Andere können kommentieren, Issue zu Pull Request verknüpfen, schließen, etc.

9 · SSH-Key einrichten (Push ohne Passwort)

HTTPS + Token funktioniert, ist aber nervig. Einmal SSH einrichten und du musst nie wieder ein Passwort eingeben.

9.1 · Key generieren

Im Terminal:

ssh-keygen -t ed25519 -C "richter@mindsquare.de"

Drei Mal Enter drücken (Default-Pfad, leeres Passwort optional).

9.2 · Public Key kopieren

cat ~/.ssh/id_ed25519.pub

Output sieht so aus:

ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIK... richter@mindsquare.de

Diese ganze Zeile kopieren.

9.3 · In mindCode einfügen

1. Avatar → Settings → SSH / GPG Keys.
2. Add Key.
3. Title: wo der Key drauf ist (z.B. „MacBook Robert").
4. Content: die kopierte Zeile einfügen.
5. Add Key klicken.

9.4 · Bestehende Repos auf SSH umstellen

Falls du das Repo schon mit HTTPS geklont hast:

cd ~/projects/customer-onboarding-konzept
git remote set-url origin git@mindcode.mindsquare.de:aito/customer-onboarding-konzept.git
git remote -v   # check: muss git@codex... statt https://... zeigen

Wichtig: mindCode SSH läuft auf Port 2222, nicht 22. Falls du einen Verbindungsfehler bekommst, in ~/.ssh/config ergänzen:

Host mindcode.mindsquare.de
    HostName mindcode.mindsquare.de
    Port 2222
    User git

9.5 · Test

ssh -T -p 2222 git@mindcode.mindsquare.de

Antwort: Hi richter! You've successfully authenticated... → fertig.

10 · Power-Features

mindCode hat ein paar Features die nicht jeder kennt — die machen aber Riesenspaß sobald sie laufen.

10.1 · Repository-Templates

Statt jedes neue Konzept-Repo bei null anzufangen, gibt's vorgefertigte Templates mit Struktur:

Eigenes Template anlegen? Repo-Settings → Template Repository ankreuzen. Wer dann auf deinem Repo „Use this template" klickt, kriegt eine Kopie ohne Git-History.

10.2 · Project Boards (Kanban)

Wie GitHub Projects oder Trello — Issues über mehrere Repos auf einem Board verschieben. Spalten frei definierbar (z.B. Idee → In Diskussion → In Arbeit → Erledigt).

1. Im Repo: Tab Projects → + New Project
2. Type: Repository (nur dieses Repo) oder Organization (über alle aito-Repos hinweg)
3. Template auswählen: None, Basic Kanban (To Do/Doing/Done) oder Bug Triage
4. Issues per Drag&Drop in Spalten verschieben. Status synct sich automatisch.

10.3 · Time Tracking auf Issues

Pro Issue Zeit erfassen — für Aufwandsschätzung in PoCs, interne Reportings, oder einfach um zu sehen wieviel ein Konzept gebraucht hat.

1. Issue öffnen → rechts in der Sidebar Stopwatch-Symbol → Start
2. Während du arbeitest läuft die Uhr — Logout/Tab-close stört nicht
3. Fertig? Stop → Forgejo trägt die Zeit als Spent-Time ein
4. Manuell nachtragen geht auch: Add Time → Stunden+Beschreibung

Auf Repo-Ebene siehst du die Summe aller getrackten Zeiten pro Issue / pro User in der Issues-Übersicht.

10.4 · Code-Search über alle Repos

Du suchst „onboarding-prozess" oder „prompt-template" und willst wissen wer das schon mal hatte?

1. Suchfeld oben in der Topbar → Begriff eingeben → Enter
2. mindCode sucht im Volltext aller Repos die du sehen darfst
3. Ergebnis: Repo-Name + Datei + Code-Snippet mit Highlight
4. Klick auf das Snippet bringt dich direkt zur Zeile im Code

10.5 · Reactions & Mentions

Statt jedes „+1"-Kommentar zu schreiben:

• Auf jedem Issue/Comment unten links: 😀 Smiley → 👍 ❤️ 🎉 🚀 👀 ➕ 🚫
• Reactions sind anonym in der Anzeige aber gewichtet (Forgejo sortiert oft danach)
• @username in Comments → der User bekommt eine In-App-Notification + Email (sobald SMTP läuft)
• @aito-team mentions ein ganzes Team auf einmal

10.6 · Watch & Subscribe

Du willst über alle Aktivität in einem Repo informiert werden? Watch-Button oben rechts auf der Repo-Seite. Optionen:

• Participating & mentions (default) — nur wenn du involved bist
• All Activity — alle Issues, PRs, Releases
• Ignore — komplett stumm

Pro Issue/PR auch: Subscribe-Button rechts — Updates auf genau dieses Item.

11 · mindCoder via mindCode in Claude Code installieren

mindCoder ist mindsquare's Skill-Collection für Claude Code (TDD, systematisches Debugging, Codex-Excellence-Modes etc.). Der kanonische Bezugsort ist mindCode — nicht GitHub.

11.1 · Personal Access Token in mindCode erzeugen

1. In mindCode einloggen (du siehst diese Seite, also passt das schon).
2. Avatar oben rechts → Settings → Applications → Tab Manage Access Tokens.
3. Token Name: claude-code-{{your-laptop-name}} (z.B. claude-code-macbook-patrick).
4. Permissions: nur repository → Read reicht.
5. Generate Token klicken → Wert jetzt sofort kopieren, wird nur einmal angezeigt.

11.2 · Git-Credentials einmalig im Mac-Keychain ablegen

Damit du den Token nie wieder eingeben musst:

git config --global credential.helper osxkeychain

Beim ersten git clone von mindCode prompted Git nach Username + Password — Username ist dein mindCode-Username (Email-Localpart, z.B. richter), Password ist der Token von 11.1. Danach: nie wieder gefragt.

11.3 · Plugin in Claude Code installieren

In Claude Code (Terminal-Session, in der Claude Code läuft) eintippen:

/plugin marketplace add https://mindcode.mindsquare.de/mindsquare/mindCoder.git
/plugin install mindCoder@mindsquare-mindcoder

Beim ersten Mal frage Git nach den Credentials → Username/Token aus 11.1 eingeben. Plugin wird installiert, alle Skills sind sofort aktiv.

11.4 · Alternative: per SSH (komfortabler dauerhaft)

Wenn du Abschnitt 9 bereits durch hast (SSH-Key in mindCode hinterlegt), nutze stattdessen:

/plugin marketplace add ssh://git@mindcode.mindsquare.de:2222/mindsquare/mindCoder.git

Kein Token nötig, keine Prompts.

11.5 · Updates ziehen

In Claude Code:

/plugin update mindCoder@mindsquare-mindcoder

12 · Best Practices

13 · FAQ & Stolperfallen

cd mein-lokales-projekt
git init
git add .
git commit -m "Initial import"
git remote add origin https://mindcode.mindsquare.de/aito/mein-projekt.git
git branch -M main
git push -u origin main

git reset HEAD~1

git revert <commit-hash>
git push origin main

Brauchst du Hilfe?

Wenn du irgendwo hängenbleibst:

• Schreib Paddy (hoefer@mindsquare.de)
• Issue im Repo aito/codex-help öffnen
• Direkt mit Kollegen im internen Channel chatten

Diese Seite wird gepflegt — Vorschläge / Korrekturen gerne als Pull Request gegen das codex-howto-Repo.