agent-teams

Überblick über den agent-teams Skill

Wofür agent-teams gedacht ist

agent-teams ist ein Claude Code Workflow-Skill für Projekte, die Multi-Agent-Entwicklung mit einer strikten TDD-Pipeline wollen. Verwende den agent-teams skill, wenn du koordinierte Feature-Auslieferung brauchst und nicht nur einen einmaligen Prompt: Ein Spec-Autor, ein Quality Gate, ein Implementierungs-Agent, Review, Security-Scan sowie PR-/Branch-Orchestrierung arbeiten dabei als Team zusammen.

Wer den Skill installieren sollte

Dieser Skill passt für Teams, die alinaqi/claude-bootstrap nutzen und wiederholbare Agentenrollen mit erzwungenen Übergaben wollen. Besonders nützlich ist er, wenn dir test-first Ausführung, Blocker-Prüfungen bei Qualitätsproblemen und weniger „Agent Drift“ über einen Feature-Branch hinweg wichtig sind.

Was ihn unterscheidet

Der wichtigste Unterschied ist die unveränderliche Feature-Pipeline: Spec, Review, fehlgeschlagene Tests, rote Verifikation, Implementierung, grüne Verifikation, Code-Review, Security-Scan und PR-Erstellung. Das Muster agent-teams for Multi-Agent Systems ist bewusst meinungsstark und prozesslastig, was hilfreich ist, wenn du Konsistenz und Nachvollziehbarkeit wichtiger findest als Flexibilität.

Wie man den agent-teams Skill verwendet

Skill-Dateien installieren und finden

Nutze den agent-teams install-Ablauf in deinem Claude Code Skill-Manager und prüfe zuerst skills/agent-teams/SKILL.md. Dieses Repository kommt ohne zusätzliche Helfer für rules/, resources/ oder scripts/ aus; deshalb sind die Agentendefinitionen unter skills/agent-teams/agents/ die wichtigsten Begleitdateien.

Was du zuerst lesen solltest

Beginne mit SKILL.md und sieh dir dann diese Dateien an:

• agents/feature.md
• agents/quality.md
• agents/code-review.md
• agents/security.md
• agents/merger.md
• agents/team-lead.md

Diese Dateien zeigen, wie sich das Team verhalten soll, welche Tools jede Rolle nutzen darf und wo die blockierenden Prüfungen stattfinden. Das ist wichtiger als ein schnelles Überfliegen, weil agent-teams usage von klaren Rollengrenzen abhängt und nicht nur von der Formulierung des Prompts.

So promptest du den Skill gut

Die beste Eingabe ist ein Feature-Ziel mit Umfang, Repo-Kontext und Einschränkungen. Statt also nur „füge Auth hinzu“ zu schreiben, gib lieber an:

• Ziel-Dateien oder Subsystem
• Akzeptanzkriterien
• Test-Framework
• Performance-/Security-Einschränkungen
• alles, was der Agent nicht ändern darf

Ein starker agent-teams guide-Prompt sollte dem Team sagen, was „fertig“ bedeutet. Wenn du das Verhalten nicht präzise vorgibst, setzt der Quality-Agent den Ablauf zwar trotzdem zurück, aber der Feature-Agent könnte zu enge Tests schreiben oder Edge Cases übersehen.

Wann es am besten funktioniert

Nutze den Skill für Features, die von paralleler Planung, testfirst Umsetzung, Review und Security-Checks profitieren. Weniger sinnvoll ist er für Mini-Fixes, explorative Prototypen oder stark unklare Aufgaben, bei denen der Overhead eines vollständigen Teams dich eher ausbremst.

FAQ zum agent-teams Skill

Ist das anfängerfreundlich?

Ja, wenn du Agentendateien und Testausgaben lesen kannst. Der Workflow ist strikt, also bekommen Anfänger Struktur, müssen aber trotzdem ein klares Ziel formulieren und verstehen, dass Fehler Teil des Prozesses sind.

Worin unterscheidet es sich von einem normalen Prompt?

Ein normaler Prompt bittet ein Modell, alles allein zu erledigen. agent-teams trennt die Zuständigkeiten auf mehrere Agents und blockiert den Fortschritt, bis jede Phase bestanden ist. Das erhöht bei mehrstufigen Aufgaben oft die Zuverlässigkeit, bringt aber auch mehr Zeremonie mit sich.

Funktioniert das außerhalb von claude-bootstrap?

Nicht als Drop-in-Garantie. Der Skill ist auf das Agentenlayout von claude-bootstrap, das Frontmatter unter .claude/agents/ und die in SKILL.md beschriebene Task-Kette ausgelegt. Außerhalb dieses Ökosystems musst du möglicherweise Dateipfade und Orchestrierungs-Konventionen anpassen.

Wann sollte ich agent-teams nicht verwenden?

Lass es bei Ein-Datei-Änderungen, dringenden Hotfixes oder Aufgaben ohne brauchbare Testsuite weg. Wenn du TDD, Review und Security-Gates nicht sinnvoll unterstützen kannst, wirkt der Ablauf schwerer als ein einfacher Prompt.

So verbesserst du den agent-teams Skill

Gib dem Team bessere Eingaben

Der größte Qualitätssprung kommt von präziseren Akzeptanzkriterien. Nenne erwartete Eingaben, Ausgaben, Edge Cases und alle bestehenden Konventionen, die das Feature einhalten muss. So kann der Feature-Agent Tests schreiben, die deiner echten Absicht entsprechen, statt zu raten.

Reduziere Fehlerquellen in der Pipeline

Typische Probleme sind vage Specs, fehlende Testbefehle und unklare Zuständigkeiten für Dateien. Wenn du den Test-Runner, den Lint-Befehl und den Package-Manager des Projekts kennst, nenne sie direkt am Anfang. Wenn ein Feature geteilten Code berührt, sag das ausdrücklich, um Konflikte zwischen Agents zu vermeiden.

Nach dem ersten Lauf iterieren

Nutze den ersten Durchgang, um Lücken sichtbar zu machen, und schärfe dann Spec oder Constraints, bevor du einen zweiten Durchlauf anforderst. Bei agent-teams bedeutet Verbesserung meist: klarere Task-Grenzen, stärkere Negative Cases und eindeutigere Definitionen dafür, woran die Quality- und Security-Agents etwas blockieren sollen.

Auf dein Repo zuschneiden

Wenn dein Repository eine ungewöhnliche Architektur oder nicht standardisierte Testmuster hat, sag das im Prompt und in den verknüpften Agentendateien klar an. Je stärker deine Eingaben die realen Repo-Constraints abbilden, desto weniger driftet das Team in generisches TDD-Verhalten ab und desto besser funktioniert der agent-teams-Install in der Praxis.