devil-advocate-swarms

Devil's Advocate Swarms

Adversarielle Agent-Teams fuer Claude Code — bessere Ergebnisse durch strukturierte Debatte.

Idee

Statt einen Agenten linear arbeiten zu lassen, spawnt ein "Team Lead" mehrere Sub-Agenten mit unterschiedlichen Rollen. Zwei "Devil's Advocate"-Agenten debattieren die Ergebnisse — erst bei Konsens wird gehandelt.

┌──────────────────────────────────────────────────────┐
│  Team Lead (Orchestrator)                            │
│    │                                                 │
│    ├── Scanner 1 ──┐                                 │
│    ├── Scanner 2 ──┤                                 │
│    ├── Scanner N ──┤                                 │
│    │               ▼                                 │
│    │         ┌─────────────┐                         │
│    │         │ Scratch Pad │ (geteilte Ergebnisse)   │
│    │         └──────┬──────┘                         │
│    │                ▼                                 │
│    │    ┌───────────────────────┐                     │
│    │    │  Devil's Advocate 1   │◄──► Debatte         │
│    │    │  Devil's Advocate 2   │                     │
│    │    └───────────┬───────────┘                     │
│    │                ▼                                 │
│    │          Konsens erreicht?                       │
│    │           ja │    │ nein                         │
│    │              ▼    └──► weitere Runde             │
│    │         Fixer-Agent                              │
│    │              │                                   │
│    │              ▼                                   │
│    │         Code-Aenderung                           │
└──────────────────────────────────────────────────────┘

Projektstruktur

devil-advocate-swarms/
├── CLAUDE.md                # Projekt-Instruktionen
├── README.md                # Diese Datei
├── .claude-plugin/
│   └── plugin.json          # Plugin-Manifest
├── agents/                  # Single Source of Truth fuer Agent-Prompts
│   ├── swarm-team-lead.md   # Team Lead — Adversarial Swarm Orchestrator
│   ├── swarm-scanner.md     # Scanner Agent — Parallele Funde-Erfassung
│   ├── swarm-advocate.md    # Devil's Advocate (prosecutor/defender)
│   └── swarm-fixer.md       # Fixer Agent — Konsens-Fix-Anwendung
├── commands/
│   └── swarm.md             # /swarm Slash-Command
├── scripts/
│   └── orchestrator.sh      # Cross-Provider Bash-Pipeline (Codex+Sonnet+Opus)
├── examples/
│   ├── security-audit.md    # Beispiel: Security-Audit Workflow
│   └── design-review.md     # Beispiel: Architektur-Review Workflow
├── skills/
│   ├── swarm-orchestrator/
│   │   └── SKILL.md         # /swarm Skill (Agent-Tool-Modus)
│   └── research-pipeline/
│       └── SKILL.md         # Redirect-Alias auf agentic-os:research-pipeline
└── .agent-memory/           # erst beim Lauf gefuellt
    ├── scratch/             # Geteiltes Scratch Pad
    ├── consensus/           # Konsens-Ergebnisse
    └── debates/             # Debatte-Logs

Hinweis zur Architektur: Bis 2026-04-30 existierte zusaetzlich ein prompts/-Verzeichnis mit denselben Rollen-Texten in einer aelteren Format-Variante. Es wurde aufgegeben, weil der scripts/orchestrator.sh die Prompts inline im Bash haelt (siehe DECOMPOSE_PROMPT=, SCANNER_PROMPT=, etc.) und prompts/ damit faktisch toter Code war. Single Source of Truth fuer Agent-Bodies ist heute agents/.

Aktivierung

// .claude/settings.json
{
  "experimental_agent_teams": 1
}

Use Cases

Use Case	Scanner	Advocate-Thema	Fixer
Security Audit	5-10 Vulnerability Scanner	"Ist das ein echtes Risiko?"	Patch-Agent
Architektur Review	2-3 Design Analyzer	"Microservice vs. Monolith?"	Refactor-Agent
Copywriting	2 Stil-Varianten	"Minimalistisch vs. Warm?"	Final-Writer
Code Quality	3 Linter/Reviewer	"False Positive oder Bug?"	Bugfix-Agent

Kosten

Jeder Subagent = eigenes Kontextfenster. Ein Schwarm von 10 Scannern + 2 Advocates verbraucht ca. 12x so viele Tokens wie ein Einzelagent. Start klein (2-3), dann skalieren.

Status

Phase: Planung — Projektstruktur angelegt, Use Cases definiert. Naechster Schritt: Prompt-Templates fuer Scanner und Advocate Rollen.

Quellen

• Nick Saraev: "CLAUDE CODE FULL COURSE 4 HOURS" (Security Issues + paralleles Design)
• NotebookLM Research: "Agentic AI & Self-Improving Workflows"
• NotebookLM Notiz: "Architektur und Steuerung von Adversarial Agent Swarms"