Team-Builder

Team Builder

Interaktives Menü zum Durchsuchen und Zusammenstellen von Agententeams bei Bedarf. Funktioniert mit flachen oder domänenbezogenen Unterverzeichnis-Sammlungen von Agenten.

Wann verwenden

• Sie haben mehrere Agenten-Personas (Markdowndateien) und möchten auswählen, welche für eine Aufgabe verwendet werden sollen
• Sie möchten ein Ad-hoc-Team aus verschiedenen Domänen zusammenstellen (z. B. Sicherheit + SEO + Architektur)
• Sie möchten durchstöbern, welche Agenten verfügbar sind, bevor Sie sich entscheiden

Voraussetzungen

Agentendateien müssen Markdowndateien mit einem Persona-Prompt (Identität, Regeln, Arbeitsablauf, Ergebnisse) sein. 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 gilt als Domäne, wenn es von 2+ Dateien geteilt wird. Dateien mit eindeutigen Präfixen werden unter "Allgemein" gruppiert. Hinweis: Der Algorithmus teilt am ersten -, daher sollten mehrteilige Domänen (z. B. produkt-management) 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ühren Sie claude agents aus, um alle dem CLI bekannten Agenten zu erhalten, einschließlich Benutzeragenten, Plugin-Agenten (z. B. ecc:architect) und integrierter Agenten. Dies deckt automatisch ECC-Marktplatzinstallationen ab, ohne dass eine Pfadkonfiguration erforderlich ist.
2. Dateiglob (Fallback, zum Lesen des Agenteninhalts) – Agenten-Markdowndateien 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 > integrierte Agenten. Ein benutzerdefinierter Pfad kann stattdessen verwendet werden, wenn der Benutzer einen angibt.

Funktionsweise

Schritt 1: Verfügbare Agenten entdecken

Führen Sie claude agents aus, um die vollständige Agentenliste zu erhalten. Analysieren Sie jede Zeile:

• Plugin-Agenten haben das Präfix plugin-name: (z. B. ecc:security-reviewer). Verwenden Sie den Teil nach : als Agentennamen und den Plugin-Namen als Domäne.
• Benutzeragenten haben kein Präfix. Lesen Sie die entsprechende Markdowndatei aus ~/.claude/agents/ oder ./agents/, um den Namen und die Beschreibung zu extrahieren.
• Integrierte Agenten (z. B. Explore, Plan) werden übersprungen, es sei denn, der Benutzer bittet explizit darum, sie einzubeziehen.

Für Benutzeragenten, die aus Markdowndateien geladen werden:

• Unterverzeichnis-Layout: Extrahieren Sie die Domäne aus dem Namen des übergeordneten Ordners
• Flaches Layout: Sammeln Sie 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
• Extrahieren Sie den Agentennamen aus der ersten # Überschrift. Wenn keine Überschrift gefunden wird, leiten Sie den Namen aus dem Dateinamen ab (entfernen Sie .md, ersetzen Sie Bindestriche durch Leerzeichen, Title-Case)
• Extrahieren Sie eine einzeilige Zusammenfassung aus dem ersten Absatz nach der Überschrift

Wenn nach dem Ausführen von claude agents und dem Durchsuchen der Dateispeicherorte keine Agenten gefunden werden, informieren Sie den Benutzer: "Keine Agenten gefunden. Führen Sie claude agents aus, um Ihre Einrichtung zu überprüfen." Dann anhalten.

Schritt 2: Domänenmenü präsentieren

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

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

• Überspringen Sie Domänen ohne Agenten (leere Verzeichnisse)
• Zeigen Sie die Anzahl der Agenten pro Domäne an

Schritt 3: Auswahl behandeln

Akzeptieren Sie flexible Eingaben:

• 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, listen Sie sie alphabetisch auf und bitten Sie den Benutzer, einzugrenzen: "Sie haben N Agenten ausgewählt (max. 5). Wählen Sie aus, welche behalten werden sollen, oder sagen Sie 'erste 5', um die ersten fünf alphabetisch zu verwenden."

Bestätigung der Auswahl:

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

Schritt 4: Agenten parallel starten

1. Lesen Sie die Markdowndatei jedes ausgewählten Agenten
2. Fragen Sie nach der Aufgabenbeschreibung, falls noch nicht geschehen
3. Starten Sie alle Agenten parallel mit dem Agent-Tool:
   • subagent_type: "general-purpose"
   • prompt: "{Agentendateiinhalt}\n\nAufgabe: {Aufgabenbeschreibung}"
   • Jeder Agent läuft unabhängig – keine Kommunikation zwischen den Agenten erforderlich
4. Wenn ein Agent fehlschlägt (Fehler, Zeitüberschreitung oder leere Ausgabe), notieren Sie den Fehler inline (z. B. "Security Engineer: fehlgeschlagen – [Grund]") und fahren Sie mit den Ergebnissen der erfolgreichen Agenten fort

Schritt 5: Ergebnisse zusammenführen

Sammeln Sie alle Ausgaben und präsentieren Sie einen einheitlichen Bericht:

• Ergebnisse gruppiert nach Agent
• Syntheseabschnitt, der hervorhebt:
  • Übereinstimmungen zwischen den Agenten
  • Konflikte oder Spannungen zwischen Empfehlungen
  • Empfohlene nächste Schritte

Wenn nur 1 Agent ausgewählt wurde, überspringen Sie die Synthese und präsentieren Sie die Ausgabe direkt.

Regeln

• Nur dynamische Erkennung. Listen Sie Agenten niemals fest codiert auf. Neue Dateien im Verzeichnis erscheinen automatisch im Menü.
• Max. 5 Agenten pro Team. Mehr als 5 führen zu abnehmenden Erträgen und übermäßigem Tokenverbrauch. Erzwingen Sie dies zum Zeitpunkt der Auswahl.
• Paralleler Versand. Alle Agenten laufen gleichzeitig – verwenden Sie das parallele Aufrufmuster des Agent-Tools.
• Parallele Agentenaufrufe, nicht TeamCreate. Dieses 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 antworten 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ählen Sie Domänen oder nennen Sie bestimmte Agenten:

Benutzer: security + seo

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

Benutzer: Überprüfen Sie meine Next.js E-Commerce-Website vor dem Start

[Beide Agenten werden parallel gestartet, jeder wendet sein Fachgebiet auf die Codebasis an]

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

## Ergebnisse SEO Specialist
- [Ergebnisse...]

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