Analyse fehlgeschlagener Hive-Mind Agent-Initialisierung (architect/optimizer/documenter nicht gefunden)

## Beschreibung
Beim Versuch, einen Hive-Mind Schwarm (`claude-flow@alpha`) zur Behebung der fehlschlagenden Unit-Tests im Repository zu initialisieren, treten Fehler bei der Agent-Erstellung für bestimmte spezifizierte Agent-Typen auf:

- `architect` (Fehler: Agent type 'architect' not found)
- `optimizer` (Fehler: Agent type 'optimizer' not found)
- `documenter` (Fehler: Agent type 'documenter' not found)

Dies verhindert die vollständige Ausführung der geplanten koordinierten Test-Fix-Pipeline.

## Ziel
Funktionsfähigen Schwarm mit passenden Agent-Typen zur Testreparatur starten – ohne neue NuGet-Pakete hinzuzufügen und ohne Zeitverlust durch nicht verfügbare Rollen.

## Schritte zur Reproduktion
1. Im Repository-Verzeichnis ausführen:
```bash
npx claude-flow@alpha init --force
```
2. Hive-Mind Wizard starten:
```bash
npx claude-flow@alpha hive-mind wizard
```
3. Swarm konfigurieren mit Objective:
```
fix die unit test. füg keine neuen pakete hinzu. entferne tests die sich nicht fixen lasssen
```
4. Versuch, folgende Agents zu starten:
- researcher
- coder
- analyst
- tester
- architect
- reviewer
- optimizer
- documenter
5. Beobachtung: Mehrere Agent-Typen schlagen fehl (siehe Logauszug).

## Aktuelles Verhalten (Fehlermeldungen)
```
Error: Agent type 'architect' not found. Available agents: general-purpose, statusline-setup, output-style-setup, base-template-generator, specification, refinement, pseudocode, architecture, tester, reviewer, researcher, planner, coder, analyst, ...
Error: Agent type 'optimizer' not found. Available agents: ... perf-analyzer, performance-benchmarker, Benchmark Suite, Resource Allocator, Topology Optimizer, ...
Error: Agent type 'documenter' not found. Available agents: ... specification, refinement, api-docs, code-review-swarm, ...
```

## Erwartetes Verhalten
Alle konfigurierten Agent-Rollen werden erfolgreich gespawnt oder durch geeignete Alternativen ersetzt:
- architect → `architecture` oder `system-architect` oder `repo-architect`
- optimizer → `perf-analyzer` oder `performance-benchmarker`
- documenter → `specification` oder `api-docs`

## Analyse / Vermutete Ursache
- Wizard schlägt Rollen vor, die im installierten `claude-flow@alpha` Paket nicht direkt verfügbar sind.
- Kein automatisches Fallback-Mapping bei unbekannten Rollen.
- Mögliche Diskrepanz zwischen Alpha-Version und Dokumentation / Presets.

## Auswirkungen
- Verzögerung beim Fixen der Unit-Tests.
- Unvollständige automatische Kategorisierung (fehlende spezialisierte Rollen).
- Erhöhte manuelle Koordinationskosten beim Swarm-Setup.

## Vorschlag zur Behebung
1. Rollen-Mapping definieren und ins Projekt dokumentieren:
- architect → architecture (Primär) / system-architect / repo-architect
- optimizer → perf-analyzer (Primär) / performance-benchmarker
- documenter → specification (Primär) / api-docs
2. Falls vorhanden: Wizard-/Preset-Konfiguration anpassen (Mapping-Datei oder Skript).
3. Validierungsskript erstellen (z. B. `tools/claude-flow/validate-agents.js`), das gewünschte Rollen gegen verfügbare Agents matched und Warnungen ausgibt.
4. README Abschnitt "Hive Mind / claude-flow Nutzung" ergänzen.
5. Nach Anpassung Swarm erneut starten, Start-Log ohne Fehler anhängen.
6. Fallback-Policy definieren: Unbekannte Rolle → `general-purpose` mit Tagging.

## Acceptance Criteria
- Swarm startet ohne Agent-Initialisierungsfehler.
- Dokumentiertes Mapping liegt vor (Datei + README-Verweis).
- Bestätigter Start-Log ohne Fehler als Kommentar / Follow-Up.
- Test-Fix-Phase kann (in separatem Issue) beginnen.
- Keine neuen NuGet-Pakete hinzugefügt.

## Umgebung
- OS: Windows (WSL)
- Shell: PowerShell + WSL bash
- Node: v22.12.0
- Paket: `claude-flow@alpha`
- Datum: 13.10.2025

Start by running the documented `npx claude-flow@alpha init --force` and `hive-mind wizard` commands, then inspect the wizard's agent-resolution entry point and available-agent output. The proposed `tools/claude-flow/validate-agents.js` and README Hive Mind section identify the intended documentation locations. Done means the configured roles resolve to valid alternatives or a documented fallback, the swarm starts without initialization errors, and a clean start log is recorded.

Written by the indexing model from the issue text.