NCA Social Media
Aktualisiert:
Autor:
Roland Golla
Grünes Clubhaus mit Schild GitHub Squad, Team aus KI Agenten prüft Code

Was ist GitHub Squad?

GitHub Squad ist ein Open Source Tool, das ein Team aus KI Agenten direkt in dein Repository legt. Lead, Frontend, Backend und Tester leben dort als Markdown Dateien, behalten ihr Wissen über Sessions hinweg und arbeiten parallel an deinen Aufgaben.
Squad läuft auf Basis von GitHub Copilot und steht unter MIT Lizenz. Entwickelt hat es Brady Gaster, das Projekt liegt heute im offiziellen GitHub Account. Der Ansatz ist bewusst schlicht: kein Vektorspeicher, keine schwere Orchestrierung, sondern Dateien im .squad Ordner, die du mit Git versionierst.
Der Mensch bleibt dabei in der Verantwortung. Laut Projekt ersetzt Squad keine Entwickler, Reviewer oder Entscheider. Es hilft bei Koordination, Wiederholung und paralleler Arbeit, die Freigabe bleibt bei dir.
Inhalt
NCA KI Workshop für Developer

Agentic Coding im Team, nicht nur im Glossar

Ein Tag inhouse mit Benjamin Klein für Developer, Tester und Admins. Context Engineering, Harness, ADRs und zwei Hands on Blöcke mit KI Agenten in eurem Setup.

  1. 1
    Kostenloses Vorgespräch
    Stand, Rollen und Ziele klären
  2. 2
    Workshoptag bei euch
    Praxis am Vormittag, Hands on danach
  3. 3
    Praxistag optional
    Agenten im eigenen Projekt
Benjamin Klein
Benjamin Klein
Senior Consultant
Zum Workshop für Developer arrow_forward

GitHub Squad mit NCA richtig einordnen

Wir testen Multi Agent Tools im eigenen Stack, bevor wir darüber schreiben. Unser Coding Alltag läuft mit OpenCode und Open Weight Modellen, abgesichert durch PHPStan, PHPUnit und Cypress. Squad nutzen wir nicht produktiv, weil es auf GitHub Copilot aufsetzt. Spannend ist es trotzdem: Squad kann sein Team auch in OpenCode einspielen, und das Konzept aus Rollen, Gedächtnis und Review passt gut zu dem, was wir Teams beibringen.
Wenn du Agenten Teams einführen willst, helfen wir beim Fundament. Im Vibe Coding Consulting bauen wir Quality Gates, bevor ein Agent Code schreibt. Wie sich Werkzeuge unterscheiden, zeigt unser Vergleich von OpenCode und Claude Code. Kosten und Budgets mehrerer Agenten steuerst du mit dem LiteLLM Proxy. Wie Freigaben im Agenten Loop sauber laufen, erklärt der Governed Agent Loop, und für parallele Arbeit ohne Konflikte lohnen sich Git Worktrees.

So arbeitet ein Squad Team im Alltag

Du beschreibst eine Aufgabe in normaler Sprache, zum Beispiel eine Login Seite mit Tests. Ein Koordinator nimmt sie an, lädt den Kontext aus dem Repo und verteilt die Arbeit. Er schreibt selbst keinen Code. Er ist nur der Router.
Danach starten die Spezialisten parallel. Jeder läuft als eigener Aufruf mit eigenem Kontextfenster. Der Backend Agent baut die Logik, der Tester schreibt passende Tests, ein Scribe hält Entscheidungen fest. So teilen sich die Agenten keinen vollen Kontext, jeder sieht das Repo für sich.
Der wichtigste Trick ist das Review. Fallen Tests durch, lehnt der Tester den Code ab. Der ursprüngliche Agent darf ihn dann nicht selbst nachbessern, ein anderer Agent übernimmt. Das sorgt für einen frischen Blick, ähnlich wie beim Vier Augen Prinzip im Team.
Am Ende landet ein Pull Request bei dir. Du prüfst und mergst. Kein Schritt geht ohne Menschen live.

Das Gedächtnis liegt als Dateien im Repo

Squad speichert alles, was das Team weiß, im Ordner .squad. Das ist der Kern des Tools. Wer das Repo klont, bekommt das eingearbeitete Team gleich mit.
Code:
          

.squad/
├── team.md # Wer im Team ist
├── routing.md # Wer was übernimmt
├── decisions.md # Gemeinsame Entscheidungen
├── agents/
│ └── {name}/
│ ├── charter.md # Rolle und Wissen
│ └── history.md # Was der Agent gelernt hat
├── skills/ # Wiederverwendbares Wissen
└── log/ # Session Verlauf

decisions.md ist das gemeinsame Gehirn. Jede Entscheidung, etwa eine Bibliothek oder eine Namenskonvention, wird dort angehängt. Jeder Agent liest die Datei vor der Arbeit. Dazu schreibt jeder Agent in seine eigene history.md, was er über dein Projekt gelernt hat.
Der Vorteil: Du siehst jederzeit, was ein Agent weiß. Das Wissen ist lesbar, versioniert und im Code Review prüfbar. Wiederverwendbares Wissen liegt als Skill Datei vor, ähnlich wie beim SKILL.md Format.

GitHub Squad installieren und starten

Squad braucht Node.js ab Version 22.5, Git und die GitHub CLI. Die Installation läuft über npm, Homebrew oder WinGet. Alle Wege liefern dieselbe CLI.
Code:
          

npm install -g @bradygaster/squad-cli
cd mein-projekt
squad init

squad init führt dich Schritt für Schritt durch das Setup. Mit --preset default bekommst du sofort ein fertiges Team mit Rollen und Routing Regeln. Danach meldest du dich bei GitHub an, damit Squad Issues und Pull Requests nutzen kann.
Code:
          

gh auth login
copilot --agent squad

Im Copilot Chat beschreibst du dein Projekt. Squad schlägt ein Team vor, du bestätigst, und die Agenten legen los. In VS Code wählst du dafür im Copilot Chat den Squad Agenten aus.
Achtung beim Quickstart: Die Doku empfiehlt den Start mit --yolo, damit Copilot nicht jeden Tool Aufruf einzeln bestätigen lässt. Das spart Klicks, nimmt dir aber die Kontrolle über jeden Schritt. Mehr dazu weiter unten.

Die wichtigsten Squad Befehle

Befehl Was er tut Wann du ihn brauchst
squad init Legt Squad im aktuellen Projekt an Einmal pro Repository zum Start
squad upgrade Aktualisiert Squad Dateien, lässt Team Wissen unangetastet Nach einem neuen Release
squad doctor Prüft das Setup und findet Fehler Wenn Agenten nicht starten
squad watch Ralph sortiert neue Issues automatisch Bei vielen offenen Issues
squad nap Komprimiert und archiviert alten Kontext Wenn das Team Gedächtnis zu groß wird
squad export Speichert das Team als JSON Snapshot Zum Sichern oder Umziehen

Squad läuft auch in OpenCode und anderen Agenten

Squad ist nicht fest an Copilot gebunden. Mit dem Schalter --client spielt Squad dasselbe Team auch in andere Coding Agenten ein. Unterstützt werden unter anderem Claude Code, Kiro, OpenCode, Cursor, Codex und Google Antigravity.
Code:
          

squad init --client claude,opencode
squad upgrade --client codex

Jeder Host bekommt eine eigene Koordinator Datei und die MCP Anbindung. Deine eigenen Einstellungen in Dateien wie opencode.json bleiben laut Projekt erhalten.
Für Teams mit OpenCode ist das interessant. Du kannst das Rollen Konzept von Squad nutzen und trotzdem bei Open Weight Modellen bleiben. Wichtig: Teste vorher, welche Funktionen im jeweiligen Host wirklich laufen. Laut Doku klappt die Modellwahl pro Agent zum Beispiel in der Copilot CLI, in VS Code nutzen alle Agenten dasselbe Modell.

Yolo Modus und Ralph brauchen klare Grenzen

Squad macht in einer Session viele Tool Aufrufe. Deshalb empfiehlt die Doku den Start mit --yolo. Dann führt der Agent Befehle aus, ohne dich jedes Mal zu fragen. Für ein Spielprojekt ist das bequem. In einem Repo mit Kundendaten oder Zugangsdaten ist es ein Risiko.
Dazu kommt Ralph, der Watch Modus. Ralph prüft regelmäßig neue Issues, sortiert sie und kann mit --execute selbst Agenten starten. Bei Fehlern eskaliert er stufenweise bis zur Pause für den Menschen. Das ist durchdacht, ersetzt aber keine festen Leitplanken.
Bevor ein Agenten Team frei arbeiten darf, gehören diese Dinge ins Projekt:
  • Statische Analyse wie PHPStan oder Ruff in der CI
  • Unit und Functional Tests, die jeder Pull Request bestehen muss
  • E2E Tests mit Cypress für die wichtigsten Abläufe
  • Anonymisierte Testdaten mit Faker statt echter Kundendaten
  • Branch Schutz, damit nur Menschen in den Hauptzweig mergen
Wie das im Alltag aussieht, zeigt unser Beitrag zum Cypress Cloud MCP. Die Agenten bekommen dort Testergebnisse direkt in den Kontext.

GitHub Squad im Vergleich zu anderen Agenten Teams

Tool Basis Gut geeignet für
GitHub Squad GitHub Copilot, Team als Dateien im Repo Coding Teams mit GitHub Workflow und Review
Ruflo Claude Code und Codex mit Swarm Orchestrierung Große Agenten Schwärme mit vielen Spezialisten
Claude Agent Teams Eingebaut in Claude Code Parallele Aufgaben in einer Claude Code Session
CrewAI Python Framework mit Rollen Eigene Agenten Anwendungen außerhalb der IDE
AutoGen Framework von Microsoft Forschung und komplexe Multi Agent Systeme

Was Squad von anderen Multi Agent Tools trennt

Die meisten Multi Agent Tools setzen auf eine eigene Laufzeit. CrewAI und AutoGen sind Frameworks, mit denen du eigene Agenten Anwendungen baust. Claude Agent Teams steckt direkt in Claude Code. Paperclip orchestriert Agenten Teams über eine eigene Oberfläche.
Squad geht einen anderen Weg. Das Team ist Teil des Repositorys und reist mit dem Code. Jede Entscheidung steht als Text im Pull Request. Für Teams, die ohnehin über GitHub Issues und Reviews arbeiten, ist das ein kleiner Schritt.
Die Grenze liegt im Fundament. Squad ist ein Coding Werkzeug für Repositories. Wer Agenten für Fachabteilungen, Dokumente oder Workflows außerhalb von Code braucht, landet eher bei Frameworks oder Tools wie n8n.

It is collaborative orchestration, not autonomous execution.

Brady Gaster, Entwickler von Squad, Principal PM Architect bei Microsoft – The GitHub Blog

Für wen GitHub Squad passt und was vorher stehen muss

Squad passt gut zu Teams, die schon mit GitHub Issues, Pull Requests und Reviews arbeiten. Die Rollen spiegeln einen echten Entwicklungsprozess. Wer bisher nur einzelne Prompts schreibt, lernt mit Squad, Arbeit sauber zu verteilen.
Weniger gut passt Squad, wenn ein Projekt keine Tests hat. Dann prüft der Tester Agent gegen nichts, und das Review wird zur Formsache. Auch Teams mit strengen Vorgaben zu US Anbietern sollten genau hinsehen, weil der Standard Weg über GitHub Copilot läuft.
Unsere Erfahrung aus Workshops: Agenten Teams zahlen sich erst aus, wenn das Fundament steht. Erst Quality Gates, dann KI. Wer dazu noch den Überblick über Modelle sucht, findet ihn bei den Ansätzen für LLM Routing und in unserer Einordnung von Agentic Engineering.
CYPRESS.IO Ambassador und IT Consultant für QA Engenieering und Qualität in PHP Projekten.
NCA Vibe Coding Consulting

Roland Golla ist Entwickler aus Leidenschaft – seit über 20 Jahren. Er hat hunderte Projekte begleitet, von Legacy-Refactoring bis KI-Integration. Bei Vibe Coding verbindet er das Beste aus beiden Welten: Die Geschwindigkeit von KI-generiertem Code mit der Qualität professioneller Softwareentwicklung. Kein Bullshit, keine Agentur-Floskeln – direkte Hilfe von jemandem, der selbst täglich im Code steckt.

Häufige Fragen zu GitHub Squad

Hier beantworten wir die Fragen, die Teams zu GitHub Squad am häufigsten stellen.
Was ist GitHub Squad 2026?

GitHub Squad ist ein Open Source Tool, das ein Team aus KI Agenten in dein Repository legt. Lead, Frontend, Backend und Tester arbeiten parallel über GitHub Copilot. Ihr Wissen speichern sie als Markdown Dateien im Ordner .squad. So bleibt das Team über Sessions erhalten und reist mit dem Code, wenn jemand das Repo klont.

Ist GitHub Squad 2026 kostenlos?

Squad selbst ist kostenlos und steht unter MIT Lizenz. Du kannst es frei nutzen, ändern und weitergeben. Für den Standard Weg brauchst du aber Zugang zu GitHub Copilot, dessen Konditionen GitHub festlegt. Läuft Squad in einem anderen Host wie OpenCode, hängen die Kosten vom gewählten Modell und Anbieter ab.

Funktioniert GitHub Squad 2026 ohne GitHub Copilot?

Ja, eingeschränkt. Mit dem Schalter client spielt Squad sein Team auch in Claude Code, OpenCode, Cursor, Codex, Kiro oder Google Antigravity ein. Jeder Host bekommt eine eigene Koordinator Datei und MCP Anbindung. Nicht jede Funktion läuft überall gleich, deshalb solltest du den gewünschten Host vorher in einem Testprojekt ausprobieren.

Wie installiere ich GitHub Squad 2026?

Du installierst die CLI mit npm, Homebrew oder WinGet. Danach führst du squad init im Projektordner aus und meldest dich mit der GitHub CLI an. Anschließend startest du Copilot mit dem Squad Agenten. Voraussetzungen sind Node.js ab Version 22.5, Git und die GitHub CLI für Issues und Pull Requests.

Für welche Teams lohnt sich GitHub Squad 2026?

Squad lohnt sich für Teams, die schon mit GitHub Issues, Pull Requests und Code Reviews arbeiten. Die Rollen im Squad spiegeln diesen Prozess. Wichtig ist eine solide Testbasis, sonst prüft der Tester Agent gegen nichts. Für Projekte ohne Tests empfehlen wir zuerst Quality Gates, dann den Einstieg in Agenten Teams.

Wo speichert Squad das Wissen der Agenten?

Squad speichert alles im Ordner .squad im Repository. Die Datei decisions.md hält gemeinsame Entscheidungen fest, jede history.md das Wissen eines einzelnen Agenten. Dazu kommen Rollenbeschreibungen, Routing Regeln, Skills und Logs. Weil alles aus Textdateien besteht, kannst du das Gedächtnis mit Git versionieren und im Review prüfen.

Was ist Ralph in GitHub Squad?

Ralph ist der Watch Modus von Squad. Er prüft in festen Abständen neue Issues, sortiert sie und verteilt sie an das Team. Mit dem Schalter execute startet er sogar selbst Agenten. Bei Fehlern eskaliert Ralph in vier Stufen bis zu einer Pause, damit ein Mensch eingreifen kann.

Ist der Yolo Modus in Squad gefährlich?

Er kann es sein. Mit yolo führt der Agent Befehle aus, ohne jede Aktion einzeln bestätigen zu lassen. Das spart Zeit, nimmt dir aber die Kontrolle. Nutze ihn nur in Projekten mit Tests, Branch Schutz und anonymisierten Daten. Zugangsdaten und echte Kundendaten gehören nicht in ein Repo, in dem Agenten frei arbeiten.

Prüfen sich die Squad Agenten gegenseitig?

Ja, das ist ein Kernprinzip. Fallen die Tests durch, lehnt der Tester Agent den Code ab. Der ursprüngliche Agent darf ihn dann nicht selbst nachbessern, ein anderer Agent übernimmt mit frischem Kontext. Am Ende landet trotzdem ein Pull Request bei dir, den du als Mensch prüfst und mergst.

Was unterscheidet Squad von Claude Agent Teams?

Claude Agent Teams ist fest in Claude Code eingebaut und startet parallele Agenten innerhalb einer Session. Squad legt das Team dagegen als Dateien ins Repository und arbeitet über GitHub Copilot oder andere Hosts. Dadurch bleibt das Gedächtnis von Squad versioniert und wandert mit dem Code zu jedem, der das Repo klont.

Nutzt Never Code Alone GitHub Squad produktiv?

Nein, wir nutzen Squad nicht produktiv. Unser Coding Alltag läuft mit OpenCode und Open Weight Modellen über europäische Inferenz Anbieter. Squad haben wir uns angesehen, weil das Konzept aus Rollen, Gedächtnis und Review gut zu unseren Workshops passt. Wir helfen Teams, Squad einzuordnen und mit Quality Gates abzusichern.

Brauche ich Tests, bevor ich Squad einsetze?

Ja, unbedingt. Squad verlässt sich auf Tests, damit der Tester Agent Fehler erkennen kann. Ohne statische Analyse, Unit Tests und E2E Tests bleibt das Review oberflächlich. Wir empfehlen PHPStan oder Ruff, PHPUnit oder pytest und Cypress für die wichtigsten Abläufe. Erst wenn diese Gates in der CI laufen, lohnt sich ein Agenten Team.