claude-subagents/README.md

# Kuratierte Subagenten-Sammlung

Zusammengestellt aus drei öffentlichen GitHub-Repos mit Claude-Code-Subagenten-Definitionen:

- `0xfurai/claude-code-subagents`
- `VoltAgent/awesome-claude-code-subagents`
- `wshobson/agents`

## Umfang

- **340 Agenten** final, einsortiert in 13 Kategorie-Unterordnern (je eine Markdown-Datei, Dateiname = `name`-Feld)
- Ausgangsmaterial: 498 rohe Agenten-Dateien aus den drei Repos
- 154 Duplikate/Redundanzen verworfen (siehe `SOURCES.md` für Details je Agent):
  - 65 wegen identischer Agenten, die in `wshobson/agents` über mehrere Plugin-Ordner mehrfach vorkommen (gleicher Dateiname, minimal unterschiedliche Werkzeugliste je Plugin)
  - 47 wegen exakt gleichem Agentennamen in zwei Repos (jeweils die kürzere/weniger detaillierte Version verworfen)
  - 42 wegen funktional identischer Rolle unter anderem Namenssuffix (z.B. `react-expert` vs. `react-specialist`, `kubernetes-expert` vs. `kubernetes-architect` vs. `kubernetes-specialist`) — jeweils die ausführlichste Version behalten

Das bereits im Projekt unter `.claude/agents/` geladene Set (react, tailwind, css, html, ui-designer, accessibility, ui-visual-validator) wurde gegen die frisch geladenen Versionen abgeglichen; wo eine Variante aus den drei Quellrepos inhaltlich detaillierter war, wurde diese übernommen (z.B. `ui-designer`), ansonsten blieb die bereits vorhandene Version erhalten (z.B. `react-expert`, `css-expert`, `html-expert`, `tailwind-expert` — diese stammen unverändert aus `0xfurai/claude-code-subagents`).

## Vereinheitlichung

Bei jeder behaltenen Datei wurde ausschließlich das Frontmatter-Feld `model:` überschrieben auf:

```
model: claude-sonnet-5
```

— unabhängig vom Originalwert (`sonnet`, `opus`, `inherit`, `claude-sonnet-4-...` etc.). Alle anderen Felder (`name`, `description`, `tools`, ggf. `color`) sowie der gesamte Systemprompt-Inhalt blieben unverändert aus der jeweiligen Quelle.

Zusätzlich wurde ein `## Communication Protocol`-Abschnitt (JSON-Kontextanfrage an einen `context-manager`-Agenten) auf die gesamte Sammlung vereinheitlicht: 109 Agenten aus `wshobson/agents` hatten ihn bereits, 243 weitere haben ihn nachträglich bekommen (Domain und Anfrage-Text individuell aus der jeweiligen `description` abgeleitet). Ausnahme: `orchestrierung/agent-organizer.md` - dieser Agent erklärt selbst explizit, keinen context-manager-Dienst abfragen zu können, ein Protokoll-Block wäre dort widersprüchlich. Dieses Protokoll ist für Frameworks gedacht, die einen echten context-manager-Agenten betreiben; in reinem Claude-Code-Einsatz ohne so einen Agenten bleibt der Abschnitt wirkungslos, aber unschädlich.

## Nutzung

Einen Agenten aus dieser Sammlung in einem Projekt mit Claude Code verfügbar machen:

```bash
cp <kategorie>/<agent-name>.md /pfad/zum/projekt/.claude/agents/
```

Beispiel:

```bash
cp frontend-ui/react-specialist.md ~/mein-projekt/.claude/agents/
```

Claude Code liest Subagenten-Definitionen ausschließlich aus `.claude/agents/` im jeweiligen Projekt (oder global unter `~/.claude/agents/`). Ein einfaches Kopieren reicht, keine weitere Registrierung nötig. Mehrere Agenten auf einmal: `cp <kategorie>/*.md .claude/agents/`.

## Lizenz

Alle drei Quell-Repos stehen unter der MIT-Lizenz:

- [`0xfurai/claude-code-subagents`](https://github.com/0xfurai/claude-code-subagents) - MIT
- [`VoltAgent/awesome-claude-code-subagents`](https://github.com/VoltAgent/awesome-claude-code-subagents) - MIT
- [`wshobson/agents`](https://github.com/wshobson/agents) - MIT

Die Systemprompt-Inhalte in `agents/` (bzw. den 13 Kategorie-Ordnern) sind größtenteils unverändert aus diesen Quellen übernommen (siehe `SOURCES.md` für die Zuordnung je Datei). Diese Sammlung selbst wird ebenfalls unter MIT-Bedingungen weitergegeben - Original-Urheberschaft liegt bei den jeweiligen Quell-Repo-Autoren.

## Kategorien

Jede Datei liegt in genau einem Kategorie-Ordner (Einordnung anhand des `description`-Felds, bei Bedarf des Systemprompt-Anfangs). Keine Mehrfachzuordnung, keine Datei doppelt abgelegt.

| Ordner | Anzahl | Was reingehört |
|---|---|---|
| `backend-apis/` | 37 | Backend-Frameworks & API-Design: REST/GraphQL/gRPC, Web-Frameworks (Express, Django, Rails, Spring Boot, .NET, Laravel, ...), Message-Queues (Kafka, RabbitMQ, BullMQ) |
| `sprachen/` | 32 | Programmiersprachen-Spezialisten ohne Framework-Fokus: Python, Go, Rust, Java, C/C++, TypeScript, PowerShell, Bash, etc. |
| `frontend-ui/` | 19 | Frontend-Frameworks (React, Vue, Angular, Svelte, Next.js), CSS/HTML, UI/UX-Design |
| `datenbanken/` | 23 | Relationale & NoSQL-Datenbanken, ORMs, Migrations-Tools (Postgres, MySQL, MongoDB, Redis, Prisma, Flyway, ...) |
| `devops-infrastruktur/` | 42 | Cloud (AWS/Azure/GCP), Kubernetes, CI/CD, IaC (Terraform), Monitoring/Observability, Incident-Response, Netzwerk |
| `security-compliance/` | 23 | Security-Audits, Pentesting, Threat Modeling, Auth (OAuth/JWT), Compliance (GDPR, HIPAA), Malware-/Reverse-Engineering |
| `testing-qualitaet/` | 22 | Test-Frameworks (Jest, Cypress, Playwright, Selenium), Code-Review, Debugging, QA-Strategie |
| `orchestrierung/` | 23 | Meta-Agenten, Multi-Agent-Workflows, Architektur-Planung, Team-/Task-Koordination |
| `marketing-content/` | 19 | Content-Marketing, SEO (alle seo-*-Agenten), Copywriting, Social Publishing |
| `data-ki-ml/` | 25 | Data Science, ML/MLOps, LLM-Engineering, NLP, Vektordatenbanken, wissenschaftliches Rechnen (NumPy, PyTorch, TensorFlow) |
| `business-produkt/` | 27 | Produktmanagement, Business-Analyse, Analytics (A/B-Tests, Cohort-Analyse), Legal/HR, Sales |
| `mobile/` | 10 | iOS/Android/React Native/Flutter/Expo/SwiftUI |
| `sonstiges/` | 38 | Nischen-Frameworks, Spiele-Entwicklung, Blockchain, Desktop-Apps (Electron/Tauri), Build-Tools (Webpack/Rollup), Dokumentation, spezielle Cloud-Dienste |

### Verzeichnisbaum

```
.
├── backend-apis/            (37 Dateien)
├── business-produkt/        (27 Dateien)
├── data-ki-ml/              (25 Dateien)
├── datenbanken/             (23 Dateien)
├── devops-infrastruktur/    (42 Dateien)
├── frontend-ui/             (19 Dateien)
├── marketing-content/       (19 Dateien)
├── mobile/                  (10 Dateien)
├── orchestrierung/          (23 Dateien)
├── security-compliance/     (23 Dateien)
├── sonstiges/               (38 Dateien)
├── sprachen/                (32 Dateien)
├── testing-qualitaet/       (22 Dateien)
├── README.md
├── SOURCES.md
└── DEVLOG.md
```

Details zu Herkunft und verworfenen Alternativen je Agent stehen in `SOURCES.md` (Pfade dort beziehen sich auf die drei Quell-Repos, nicht auf die Ordnerstruktur hier).