Team Builder

Was macht Team Builder?

Interaktives Menü zum Durchsuchen und Zusammenstellen von Agententeams auf Anfrage. Funktioniert mit flachen oder domänenunterverzeichnis-basierten Agentensammlungen.

Wann verwenden

• Du hast mehrere Agenten-Personas (Markdown-Dateien) und möchtest auswählen, welche du für eine Aufgabe verwenden möchtest
• Du möchtest ein Ad-hoc-Team aus verschiedenen Domänen zusammenstellen (z. B. Sicherheit + SEO + Architektur)
• Du möchtest durchstöbern, welche Agenten verfügbar sind, bevor du dich entscheidest

Voraussetzungen

Agentendateien müssen Markdown-Dateien sein, die einen Persona-Prompt enthalten (Identität, Regeln, Arbeitsablauf, Ergebnisse). Die erste # Überschrift wird als Agentenname und der erste Absatz als Beschreibung verwendet.

Sowohl flache als auch Unterverzeichnis-Layouts werden unterstützt:

Unterverzeichnis-Layout – die Domäne wird aus dem Ordnernamen abgeleitet:

agents/
├── engineering/
│   ├── security-engineer.md
│   └── software-architect.md
├── marketing/
│   └── seo-specialist.md
└── sales/
    └── discovery-coach.md

Flaches Layout – die Domäne wird aus gemeinsamen Dateinamenspräfixen abgeleitet. Ein Präfix zählt als Domäne, wenn es von 2+ Dateien geteilt wird. Dateien mit eindeutigen Präfixen werden unter "Allgemein" gruppiert. Hinweis: Der Algorithmus teilt beim ersten -, daher sollten mehrwortige Domänen (z. B. produktmanagement) stattdessen das Unterverzeichnis-Layout verwenden:

agents/
├── engineering-security-engineer.md
├── engineering-software-architect.md
├── marketing-seo-specialist.md
├── marketing-content-strategist.md
├── sales-discovery-coach.md
└── sales-outbound-strategist.md

Konfiguration

Agenten werden über zwei Methoden entdeckt, zusammengeführt und nach Agentennamen dedupliziert:

1. claude agents Befehl (primär) – führe claude agents aus, um alle dem CLI bekannten Agenten zu erhalten, einschließlich Benutzeragenten, Plugin-Agenten (z. B. ecc:architect) und eingebauten Agenten. Dies deckt automatisch ECC-Marktplatzinstallationen ab, ohne dass eine Pfadkonfiguration erforderlich ist.
2. Datei-Glob (Fallback, zum Lesen des Agenteninhalts) – Agenten-Markdown-Dateien werden gelesen von:
   • ./agents/**/*.md + ./agents/*.md – projektlokale Agenten
   • ~/.claude/agents/**/*.md + ~/.claude/agents/*.md – globale Benutzeragenten

Frühere Quellen haben Vorrang bei Namenskollisionen: Benutzeragenten > Plugin-Agenten > eingebaute Agenten. Ein benutzerdefinierter Pfad kann stattdessen verwendet werden, wenn der Benutzer einen angibt.

Wie es funktioniert

Schritt 1: Verfügbare Agenten entdecken

Führe claude agents aus, um die vollständige Agentenliste zu erhalten. Analysiere jede Zeile:

• Plugin-Agenten sind mit plugin-name: vorangestellt (z. B. ecc:security-reviewer). Verwende den Teil nach : als Agentennamen und den Plugin-Namen als Domäne.
• Benutzeragenten haben kein Präfix. Lese die entsprechende Markdown-Datei aus ~/.claude/agents/ oder ./agents/, um Namen und Beschreibung zu extrahieren.
• Eingebaute Agenten (z. B. Explore, Plan) werden übersprungen, es sei denn, der Benutzer bittet explizit darum, sie einzuschließen.

Für Benutzeragenten, die aus Markdown-Dateien geladen werden:

• Unterverzeichnis-Layout: Extrahiere die Domäne aus dem Namen des übergeordneten Ordners
• Flaches Layout: Sammle alle Dateinamenspräfixe (Text vor dem ersten -). Ein Präfix qualifiziert sich nur dann als Domäne, wenn es in 2 oder mehr Dateinamen vorkommt (z. B. beginnen engineering-security-engineer.md und engineering-software-architect.md beide mit engineering → Domäne Engineering). Dateien mit eindeutigen Präfixen (z. B. code-reviewer.md, tdd-guide.md) werden unter "Allgemein" gruppiert
• Extrahiere den Agentennamen aus der ersten # Überschrift. Wenn keine Überschrift gefunden wird, leite den Namen aus dem Dateinamen ab (entferne .md, ersetze Bindestriche durch Leerzeichen, Titel-Fall)
• Extrahiere eine einzeilige Zusammenfassung aus dem ersten Absatz nach der Überschrift

Wenn nach der Ausführung von claude agents und dem Durchsuchen der Dateispeicherorte keine Agenten gefunden werden, informiere den Benutzer: "Keine Agenten gefunden. Führe claude agents aus, um deine Einrichtung zu überprüfen." Dann stoppe.

Schritt 2: Domänen-Menü anzeigen

Verfügbare Agentendomänen:
1. Engineering — Software Architect, Security Engineer
2. Marketing — SEO Specialist
3. Sales — Discovery Coach, Outbound Strategist

Wähle Domänen oder nenne bestimmte Agenten (z. B. "1,3" oder "security + seo"):

• Überspringe Domänen mit null Agenten (leere Verzeichnisse)
• Zeige die Agentenanzahl pro Domäne an

Schritt 3: Auswahl verarbeiten

Akzeptiere flexible Eingabe:

• Zahlen: "1,3" wählt alle Agenten aus Engineering und Sales aus
• Namen: "security + seo" führt eine unscharfe Suche gegen die entdeckten Agenten durch
• "alle aus engineering" wählt jeden Agenten in dieser Domäne aus

Wenn mehr als 5 Agenten ausgewählt werden, liste sie alphabetisch auf und bitte den Benutzer einzugrenzen: "Du hast N Agenten ausgewählt (max. 5). Wähle aus, welche behalten werden sollen, oder sage 'erste 5', um die ersten fünf alphabetisch zu verwenden."

Auswahl bestätigen:

Ausgewählt: Security Engineer + SEO Specialist
Woran sollen sie arbeiten? (Aufgabe beschreiben):

Schritt 4: Agenten parallel starten

1. Lese die Markdown-Datei jedes ausgewählten Agenten
2. Fordere zur Aufgabenbeschreibung auf, falls noch nicht vorhanden
3. Starte alle Agenten parallel mit dem Agent-Tool:
   • subagent_type: "general-purpose"
   • prompt: "{Agentendatei-Inhalt}\n\nAufgabe: {Aufgabenbeschreibung}"
   • Jeder Agent läuft unabhängig – keine agentenübergreifende Kommunikation erforderlich
4. Wenn ein Agent fehlschlägt (Fehler, Zeitüberschreitung oder leere Ausgabe), notiere den Fehler inline (z. B. "Security Engineer: fehlgeschlagen – [Grund]") und fahre mit den Ergebnissen der erfolgreichen Agenten fort

Schritt 5: Ergebnisse synthetisieren

Sammle alle Ausgaben und präsentiere einen einheitlichen Bericht:

• Ergebnisse gruppiert nach Agent
• Syntheseabschnitt mit Hervorhebung:
  • Übereinstimmungen zwischen Agenten
  • Konflikte oder Spannungen zwischen Empfehlungen
  • Empfohlene nächste Schritte

Wenn nur 1 Agent ausgewählt wurde, überspringe die Synthese und präsentiere die Ausgabe direkt.

Regeln

• Nur dynamische Entdeckung. Hartcodierte Agentenlisten niemals verwenden. Neue Dateien im Verzeichnis erscheinen automatisch im Menü.
• Max. 5 Agenten pro Team. Mehr als 5 bringen abnehmende Erträge und übermäßigen Token-Verbrauch. Zum Zeitpunkt der Auswahl durchsetzen.
• Paralleler Versand. Alle Agenten laufen gleichzeitig – verwende das parallele Aufrufmuster des Agent-Tools.
• Parallele Agentenaufrufe, nicht TeamCreate. Dieser Skill verwendet parallele Agent-Tool-Aufrufe für unabhängige Arbeit. TeamCreate (ein Claude Code-Tool für Multi-Agenten-Dialog) wird nur benötigt, wenn Agenten debattieren oder aufeinander reagieren müssen.

Beispiele

Benutzer: team builder

Claude:
Verfügbare Agentendomänen:
1. Engineering (2) — Software Architect, Security Engineer
2. Marketing (1) — SEO Specialist
3. Sales (4) — Discovery Coach, Outbound Strategist, Proposal Strategist, Sales Engineer
4. Support (1) — Executive Summary

Wähle Domänen oder nenne bestimmte Agenten:

Benutzer: security + seo

Claude:
Ausgewählt: Security Engineer + SEO Specialist
Woran sollen sie arbeiten?

Benutzer: Überprüfe meinen Next.js E-Commerce-Shop vor dem Start

[Beide Agenten starten parallel, jeder wendet sein Spezialgebiet auf die Codebasis an]

Claude:
## Security Engineer Erkenntnisse
- [Erkenntnisse...]

## SEO Specialist Erkenntnisse
- [Erkenntnisse...]

## Synthese
Beide Agenten stimmen überein bei: [...]
Spannung: Security empfiehlt CSP, das Inline-Styles blockiert, SEO benötigt Inline-Schema-Markup. Lösung: [...]
Nächste Schritte: [...]