team-composition-patterns
von wshobsonteam-composition-patterns ist eine Entscheidungs-Skill für die Gestaltung von Multi-Agent-Teams in Claude Code Agent Teams – mit Heuristiken zur Teamgröße, Auswahl von subagent_type und Hinweisen zu Anzeigemodi. Nutzen Sie diesen team-composition-patterns Guide, um vordefinierte Review-/Debug-Teams einzusetzen, Rollen auszuwählen und die Team-Setups über Aufgaben hinweg zu standardisieren.
Diese Skill erreicht 78/100, also ein solides Listing mit guter operativer Anleitung; Verzeichnisnutzer können sich für die Installation entscheiden, sollten aber mit manueller Umsetzung statt automatischer Einrichtung rechnen.
- Klare Auslösekriterien mit expliziten "When to Use This Skill"-Szenarien und Heuristiken zur Teamzusammensetzung.
- Praktische Entscheidungshilfe durch die Agent-Typ-Auswahlmatrix und die Fähigkeitstabelle zur Auswahl von subagent_type.
- Konkrete vordefinierte Teamkonfigurationen und Aufgaben-Templates (z. B. Review-/Debug-Teams), die den Aufwand für Standard-Workflows reduzieren.
- Kein Installations- oder Quick-Start-Befehl in SKILL.md, daher erfordert die Einführung eine manuelle Interpretation der Anleitung.
- Einige operative Details wirken in Auszügen abgeschnitten; für vollständige Anweisungen müssen Nutzer die vollständigen Dateien lesen.
Überblick über die team-composition-patterns‑Skill
team-composition-patterns ist eine Entscheidungsskill zur Gestaltung von Multi‑Agent‑Teams in Claude Code Agent Teams. Sie deckt Heuristiken zur Teamgröße, die Auswahl von subagent_type und die Wahl des Display‑Modus ab. Ideal ist sie für Builder, die wiederholbare Team‑Setups für Review, Debugging oder Feature‑Delivery brauchen – statt ad‑hoc „ein paar Agents spawnen“.
Was die team-composition-patterns‑Skill Ihnen hilft zu entscheiden
Sie löst drei typische Adoptions‑Blocker: wie viele Agents sinnvoll sind, welcher subagent_type zu welcher Rolle passt und welcher Display‑Modus in Ihrer Umgebung funktioniert (tmux, iTerm2, in‑process).
Best‑fit‑Szenarien und Outcomes
Nutzen Sie die Skill, wenn Sie eine konsistente Teamzusammensetzung für Aufgaben wie Code Review, Bug‑Analyse oder Feature‑Implementierung brauchen – und wenn Sie wiederverwendbare Teams bevorzugen, statt Rollen jedes Mal neu zu definieren.
Abgrenzung gegenüber generischen Prompts
Im Unterschied zu generischen „create a team“-Prompts kodifiziert die Skill Größenheuristiken, Preset‑Konfigurationen und eine Entscheidungsmatrix für subagent_type‑Auswahl, die an Agent‑Capabilities gekoppelt ist.
Wann es nicht passt
Wenn Sie keine Claude Code Agent Teams verwenden oder grundsätzlich nur einen einzelnen Assistenten für einfache Aufgaben brauchen, erzeugt diese Skill Overhead ohne klaren Nutzen.
So nutzen Sie die team-composition-patterns‑Skill
team-composition-patterns‑Installation und Einstiegspunkt
Installieren Sie die Skill mit: npx skills add https://github.com/wshobson/agents --skill team-composition-patterns. Die Kernanleitung steht in plugins/agent-teams/skills/team-composition-patterns/SKILL.md.
Diese Dateien zuerst lesen für Adoptions‑Entscheidungen
Starten Sie mit SKILL.md, lesen Sie dann references/agent-type-selection.md für die subagent_type‑Entscheidungsmatrix und references/preset-teams.md für fertige Team‑Setups und Task‑Templates.
Inputs, die die Skill von Ihnen erwartet
Geben Sie Task‑Typ (review/debug/feature/migration), Komplexitätsgrad, Constraints (CI vs local) und ob Agents Schreibzugriff brauchen an. Diese Angaben steuern Teamgröße und subagent_type‑Auswahl direkt.
Aus einem groben Ziel einen starken Prompt machen
Schwach: „spawn a team to review this PR.“
Stark: „Review 6-file diff touching auth and caching; prioritize security and performance; local dev; need file:line findings and fixes.“ Damit kann die Skill ein Review‑Team‑Preset und Reviewer‑Dimensionen wählen.
Teamgrößen‑Heuristiken nutzen, um Over/Under‑Spawning zu vermeiden
Ordnen Sie die Komplexität der Teamgröße zu: simple (1–2), moderate (2–3), complex (3–4+). Größere Teams helfen, wenn mehrere Dimensionen zählen (security + performance + architecture), nicht nur bei viel Code.
Die Agent‑Type‑Decision‑Matrix verwenden
Nutzen Sie references/agent-type-selection.md, um subagent_type zu wählen. Beispiel: code review → agent-teams:team-reviewer; bug investigation → agent-teams:team-debugger; Architektur‑Exploration ohne Edits → Plan oder Explore.
Preset‑Teamzusammensetzungen zuerst einsetzen
Die Preset‑Teamdefinitionen (review/debug) bringen am schnellsten Wert. Sie enthalten Rollen, Fokusbereiche und strukturierte Task‑Templates, sodass jeder Agent eine klare Dimension und ein Output‑Format hat.
Display‑Modus nach Umgebung wählen
Wenn Sie mehrere parallele Outputs brauchen und Terminal‑Panes handhaben können, ist tmux empfohlen. Für leichtere Setups reduzieren iTerm2 oder in‑process Output die Reibung.
Empfohlener Workflow für team-composition-patterns‑Einsatz
- Task und Komplexität klassifizieren.
- Preset‑Team oder Custom‑Team nach Dimensionen auswählen.
- subagent_type pro Rolle zuweisen.
- Display‑Modus für Ihre Umgebung wählen.
- Jeder Teamperson ein strukturiertes Task‑Template geben.
team-composition-patterns‑Skill FAQ
Ist die team-composition-patterns‑Skill nur für Claude Code Agent Teams?
Ja. Sie ist um Agent‑Teams‑Konzepte wie subagent_type und Display‑Modi herum gebaut. Ohne diese Umgebung ist die Guidance weniger umsetzbar.
Worin unterscheidet sie sich von einem normalen „create a team“-Prompt?
Sie liefert Entscheidungsregeln für Teamgröße, eine Matrix zur Agent‑Type‑Auswahl und konkrete Preset‑Teams mit Task‑Templates – Dinge, die generische Prompts meist nicht enthalten.
Ist das anfängerfreundlich?
Ja, wenn Sie den Preset‑Teams folgen. Die Entscheidungsmatrix kann dicht wirken, verhindert aber typische Fehler wie Schreibrechte für einen Exploration‑Agent.
Wann sollte ich es vermeiden?
Meiden Sie es bei einmaligen, risikoarmen Aufgaben, für die ein einzelner General‑Purpose‑Agent reicht. Der Koordinations‑Overhead kann den Nutzen übersteigen.
Unterstützt es Custom‑Workflows wie Migrations oder Audits?
Ja. Die Skill deckt explizit nicht‑standardisierte Workflows ab; Sie bauen eine Custom‑Teamkomposition, indem Sie Dimensionen kombinieren und passende subagent_type‑Rollen wählen.
So verbessern Sie die team-composition-patterns‑Skill
Klarere Task‑Dimensionen für besseres Teamdesign angeben
Spezifizieren Sie Review‑Dimensionen (security, performance, architecture, testing). Klare Dimensionen lassen die Skill Preset‑Reviewer‑Rollen zuordnen und reduzieren Überschneidungen.
Häufige Failure‑Modes vermeiden
Failure‑Mode: falschen subagent_type wählen (z. B. Plan für eine Aufgabe, die Edits erfordert). Beheben Sie das, indem Sie angeben, ob der Agent Dateien schreiben muss, und die Decision‑Matrix verwenden.
Stärkeren Input‑Kontext für bessere Outputs liefern
Fügen Sie Scope‑Indikatoren hinzu wie „multi-file change“, „cross-cutting concern“ oder „CI-only environment“. Diese verändern empfohlene Teamgröße und Display‑Modus.
Nach dem ersten Team‑Vorschlag iterieren
Wenn Ergebnisse flach wirken, ergänzen Sie eine fehlende Dimension (z. B. accessibility) oder erhöhen Sie die Teamgröße um eins. Wenn Antworten redundant sind, Teamgröße reduzieren oder Scope enger fassen.
Wiederverwendbares Template für Ihr Unternehmen erstellen
Passen Sie die Preset‑Task‑Templates in references/preset-teams.md an Ihre Repo‑Konventionen an (file paths, output format, severity levels). So wird die team-composition-patterns‑Guidance zu einem verlässlichen internen Workflow.
team-composition-patterns für Agent‑Orchestration‑Entscheidungen nutzen
Wenn Sie mehrere parallele Aufgaben koordinieren, hilft die Skill, Rollen und Capabilities zu standardisieren – mit dem richtigen Mix aus Reviewer‑, Debugger‑, Implementer‑ und Lead‑Agents pro Stream.