Back to Skills

unleash-the-agents

pjt222
Updated 2 days ago
8 views
17
2
17
View on GitHub
Metaai

About

This skill launches multiple AI agents in parallel waves to generate diverse hypotheses for complex, cross-domain problems with no clear starting point. It's ideal when single-agent approaches stall or when broad perspective exploration is needed over deep specialization. The output is a ranked set of hypotheses that includes convergence analysis and has undergone adversarial refinement.

Quick Install

Claude Code

Recommended
Primary
npx skills add pjt222/agent-almanac -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternative
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/unleash-the-agents

Copy and paste this command in Claude Code to install this skill

Documentation

Die Agents entfesseln

Alle verfuegbaren Agents in parallelen Wellen konsultieren um diverse Hypothesen fuer offene Probleme zu generieren. Jeder Agent denkt durch seine einzigartige Domaenen-Linse — ein Kabbalist findet Muster via Gematria, ein Martial-Artist schlaegt bedingte Verzweigung vor, ein Contemplative bemerkt Struktur indem er bei den Daten sitzt. Konvergenz ueber unabhaengige Perspektiven ist das primaere Signal dass eine Hypothese Wert hat.

Wann verwenden

  • Konfrontiert mit einem domaeneuebergreifenden Problem wo der korrekte Ansatz unbekannt ist
  • Ein Single-Agent- oder Single-Domaenen-Ansatz hat gestockt oder kein Signal produziert
  • Das Problem profitiert von genuein diversen Perspektiven (nicht nur mehr Compute)
  • Hypothesen-Generierung noetig, keine Ausfuehrung (Teams fuer Ausfuehrung nutzen)
  • Hochriskante Entscheidungen wo das Verfehlen eines nicht-offensichtlichen Winkels echte Kosten traegt

Eingaben

  • Erforderlich: Problem-Brief — eine klare Beschreibung des Problems, 5+ konkrete Beispiele und was als Loesung zaehlt
  • Erforderlich: Verifikations-Methode — wie zu testen ist ob eine Hypothese korrekt ist (programmatischer Test, Experten-Review oder Null-Modell-Vergleich)
  • Optional: Agent-Subset — spezifische Agents zum Einbeziehen oder Ausschliessen (Standard: alle registrierten Agents)
  • Optional: Wellen-Groesse — Anzahl Agents pro Welle (Standard: 10)
  • Optional: Ausgabe-Format — strukturiertes Template fuer Agent-Antworten (Standard: Hypothese + Reasoning + Konfidenz + testbare Vorhersage)

Vorgehensweise

Schritt 1: Den Brief vorbereiten

Einen Problem-Brief schreiben den jeder Agent verstehen kann unabhaengig von Domaenen-Expertise. Einbeziehen:

  1. Problem-Aussage: Was du zu entdecken oder entscheiden versuchst (1-2 Saetze)
  2. Beispiele: Mindestens 5 konkrete Eingabe-/Ausgabe-Beispiele oder Datenpunkte (mehr ist besser — 3 sind zu wenige fuer die meisten Agents um Muster zu finden)
  3. Bekannte Beschraenkungen: Was du bereits weisst, was bereits versucht wurde
  4. Erfolgskriterien: Wie eine korrekte Hypothese zu erkennen ist
  5. Ausgabe-Template: Das exakte Format in dem Antworten gewuenscht sind
## Brief: [Problem Title]

**Problem**: [1-2 sentence statement]

**Examples**:
1. [Input] → [Output]  (explain what's known)
2. [Input] → [Output]
3. [Input] → [Output]
4. [Input] → [Output]
5. [Input] → [Output]

**Already tried**: [List failed approaches to avoid rediscovery]

**Success looks like**: [Testable criterion]

**Respond with**:
- Hypothesis: [Your proposed mechanism in one sentence]
- Reasoning: [Why your domain expertise suggests this]
- Confidence: [low/medium/high]
- Testable prediction: [If my hypothesis is correct, then X should be true]

Erwartet: Ein Brief der selbsterklaerend ist — ein Agent der nur diesen Text empfaengt hat alles noetige um ueber das Problem zu reasoning.

Bei Fehler: Wenn 5 Beispiele oder eine Verifikations-Methode nicht artikuliert werden koennen, ist das Problem nicht bereit fuer Multi-Agent-Konsultation. Den Scope zuerst verengen.

Schritt 2: Die Wellen planen

Alle verfuegbaren Agents auflisten und sie in Wellen von ~10 aufteilen. Reihenfolge ist fuer die ersten 2 Wellen unwichtig; fuer nachfolgende Wellen verbessert Inter-Wellen-Wissens-Injektion Ergebnisse.

# List all agents from registry
grep '  - id: ' agents/_registry.yml | sed 's/.*- id: //' | shuf

Agents zu Wellen zuweisen. Anfangs fuer 4 Wellen planen — moeglicherweise sind nicht alle noetig (siehe Early-Stopping in Schritt 4).

WelleAgentsBrief-Variante
1-220 AgentsStandard-Brief
310 Agents + advocatus-diaboliBrief + entstehender Konsens + adversariale Herausforderung
4+10 Agents jeBrief + "X ist bestaetigt. Auf Grenzfaelle und Versagen fokussieren."

Erwartet: Eine Wellen-Zuordnungs-Tabelle mit allen Agents alloziert. advocatus-diaboli in Welle 3 (nicht spaeter) einbeziehen damit der adversariale Pass nachfolgende Wellen informiert.

Bei Fehler: Wenn weniger als 20 Agents verfuegbar sind, auf 2-3 Wellen reduzieren. Das Muster funktioniert immer noch mit so wenigen wie 10 Agents, obwohl Konvergenz-Signale schwaecher sind.

Schritt 3: Wellen starten

Jede Welle als parallele Agents starten. sonnet-Modell fuer Kosteneffizienz nutzen (der Wert kommt von Perspektivenvielfalt, nicht individueller Tiefe).

Option A: TeamCreate (empfohlen fuer volle Entfesselung)

Claude Codes TeamCreate-Tool nutzen um ein koordiniertes Team mit Aufgaben-Tracking aufzusetzen. TeamCreate ist ein deferred Tool — zuerst via ToolSearch("select:TeamCreate") abrufen.

  1. Das Team erstellen:
    TeamCreate({ team_name: "unleash-wave-1", description: "Wave 1: open-ended hypothesis generation" })
    
  2. Eine Aufgabe pro Agent mit TaskCreate erstellen mit dem Brief und domaenen-spezifischer Rahmung
  3. Jeden Agent als Teammate spawnen mit dem Agent-Tool mit team_name: "unleash-wave-1" und subagent_type auf den Agent-Typ gesetzt (z.B. kabalist, geometrist)
  4. Aufgaben den Teammates via TaskUpdate mit owner zuweisen
  5. Fortschritt via TaskList ueberwachen — Teammates markieren Aufgaben als abgeschlossen wenn sie fertig sind
  6. Zwischen Wellen das aktuelle Team via SendMessage({ type: "shutdown_request" }) herunterfahren und das naechste Team mit dem aktualisierten Brief erstellen (Schritt 4)

Das gibt eingebaute Koordination: eine geteilte Aufgabenliste verfolgt welche Agents geantwortet haben, Teammates koennen fuer Follow-ups bemessagt werden und der Lead verwaltet Wellen-Uebergaenge durch Aufgaben-Zuweisung.

Option B: Rohes Agent-Spawning (einfacher, fuer kleinere Laeufe)

Fuer jeden Agent in der Welle ihn mit dem Brief und einer domaenen-spezifischen Rahmung spawnen:

Use the [agent-name] agent to analyze this problem through your domain expertise.
[Paste the brief]
Think about this from your specific perspective as a [agent-description].
[For non-technical agents: add a domain-specific framing, e.g., "What patterns
does your tradition recognize in systems that exhibit this kind of threshold behavior?"]
Respond exactly in the requested format.

Alle Agents in einer Welle gleichzeitig mit dem Agent-Tool mit run_in_background: true starten. Auf die Welle zum Abschluss warten bevor die naechste Welle gestartet wird (um Inter-Wellen-Wissens-Injektion in Schritt 4 zu ermoeglichen).

Zwischen Optionen waehlen

TeamCreateRohes Agent
Am besten fuerTier 3 volle Entfesselung (40+ Agents)Tier 2 Panel (5-10 Agents)
KoordinationAufgabenliste, Messaging, EigentumFire-and-Forget, manuelle Sammlung
Inter-Wellen-HandoffAufgaben-Status uebertraegt sichMuss manuell verfolgt werden
OverheadHoeher (Team-Setup pro Welle)Niedriger (einzelner Tool-Call pro Agent)

Erwartet: Jede Welle gibt ~10 strukturierte Antworten innerhalb 2-5 Minuten zurueck. Agents die nicht antworten oder off-format-Ausgabe zurueckgeben werden vermerkt aber blockieren die Pipeline nicht.

Bei Fehler: Wenn mehr als 50% einer Welle scheitern, die Brief-Klarheit pruefen. Haeufige Ursache: das Ausgabe-Template ist mehrdeutig oder die Beispiele sind unzureichend fuer Nicht-Domaenen-Agents zum Reasoning.

Schritt 4: Inter-Wellen-Wissen injizieren (und Early-Stopping evaluieren)

Nach Wellen 1-2 das entstehende Signal vor Start der naechsten Welle extrahieren.

  1. Antworten von abgeschlossenen Wellen nach wiederkehrenden Themen scannen
  2. Die haeufigste Hypothesen-Familie identifizieren (das Konvergenz-Signal)
  3. Den Early-Stopping-Schwellwert pruefen: wenn die Top-Familie bereits 3x die Null-Modell-Erwartung nach 20 Agents ueberschreitet, hast du starkes Signal. Welle 3 als adversariale + Verfeinerungs-Welle planen und in Erwaegung ziehen danach zu stoppen
  4. Den Brief fuer die naechste Welle aktualisieren:
**Update from prior waves**: [N] agents independently proposed [hypothesis family].
Build on this — what explains the remaining cases where this hypothesis fails?
Do NOT simply restate this finding. Extend, challenge, or refine it.

Early-Stopping-Anleitung: Nicht jede Entfesselung braucht alle Agents. Fuer wohldefinierte Problem-Domaenen (z.B. Codebasis-Analyse) stabilisiert sich Konvergenz oft bei 30-40 Agents. Fuer abstrakte oder offene Probleme (z.B. unbekannte mathematische Transformationen) fuegt das volle Roster Wert hinzu weil die korrekte Domaene genuein unvorhersagbar ist. Konvergenz nach jeder Welle pruefen — wenn die Anzahl der Top-Familie und das Null-Modell-Verhaeltnis plateauiert haben, geben zusaetzliche Wellen abnehmende Renditen.

Dies verhindert Wiederentdeckung (wo spaetere Wellen unabhaengig wieder ableiten was fruehere Wellen bereits gefunden haben) und richtet spaetere Agents zu den Raendern des Problems.

Erwartet: Spaetere Wellen produzieren nuanciertere, gezieltere Hypothesen die Luecken im entstehenden Konsens adressieren.

Bei Fehler: Wenn nach 2 Wellen keine Konvergenz erscheint, kann das Problem zu unbeschraenkt sein. Den Scope verengen oder mehr Beispiele bereitstellen.

Schritt 5: Sammeln und deduplizieren

Nachdem alle Wellen abgeschlossen sind, alle Antworten in ein einzelnes Dokument sammeln. Deduplizieren indem Hypothesen in Familien gruppiert werden:

  1. Alle Hypothesen-Aussagen extrahieren
  2. Nach Mechanismus clustern (nicht nach Wortwahl — "modulare Arithmetik mod 94" und "zyklische Gruppe ueber Z_94" sind dieselbe Familie)
  3. Unabhaengige Entdeckungen pro Familie zaehlen
  4. Nach Konvergenz rangieren: Familien die von mehr Agents unabhaengig entdeckt wurden rangieren hoeher

Erwartet: Eine rangierte Liste von Hypothesen-Familien mit Konvergenz-Anzahlen, beitragenden Agents und repraesentativen testbaren Vorhersagen.

Bei Fehler: Wenn jede Hypothese einzigartig ist (keine Konvergenz), ist das Signal-Rausch-Verhaeltnis zu niedrig. Entweder braucht das Problem mehr Beispiele oder die Agents brauchen ein engeres Ausgabe-Format.

Schritt 6: Gegen Null-Modell verifizieren

Die Top-Hypothese gegen ein Null-Modell testen um sicherzustellen dass die Konvergenz bedeutungsvoll ist, kein Artefakt geteilter Trainingsdaten.

  • Programmatische Verifikation: Wenn die Hypothese eine testbare Formel oder einen Algorithmus produziert, sie gegen ausgehaltene Beispiele ausfuehren
  • Null-Modell: Die Wahrscheinlichkeit schaetzen dass N Agents auf dieselbe Hypothesen-Familie zufaellig konvergieren wuerden (z.B. wenn es K vernuenftige Hypothesen-Familien gibt, ist zufaellige Konvergenz-Wahrscheinlichkeit ~N/K)
  • Schwellwert: Signal ist bedeutungsvoll wenn Konvergenz 3x die Null-Modell-Erwartung ueberschreitet

Erwartet: Die Top-Hypothesen-Familie ueberschreitet signifikant Zufallsniveau-Konvergenz und/oder besteht programmatische Verifikation.

Bei Fehler: Wenn die Top-Hypothese Verifikation scheitert, die zweitplatzierte Familie pruefen. Wenn keine Familie besteht, kann das Problem einen anderen Ansatz erfordern (tiefere Single-Experten-Analyse, mehr Daten oder neu formulierte Beispiele).

Schritt 7: Adversariale Verfeinerung

Bevorzugtes Timing: Welle 3, nicht Post-Synthese. advocatus-diaboli in Welle 3 einzubeziehen (neben der Inter-Wellen-Wissens-Injektion) ist effektiver als ein eigenstaendiger adversarialer Pass nach Abschluss aller Wellen. Frueher Herausforderung erlaubt Wellen 4+ gegen die Kritik zu verfeinern statt auf einen unherausgeforderten Konsens zu haeufen.

Wenn der adversariale Pass bereits Teil von Welle 3 war, wird dieser Schritt zu einer finalen Pruefung. Falls nicht (z.B. alle Wellen ohne ihn gelaufen), advocatus-diaboli (oder senior-researcher) jetzt spawnen. Fuer einen strukturierten Pass TeamCreate nutzen um ein Review-Team aufzustellen mit beiden Agents parallel gegen den Konsens arbeitend:

Here is the consensus hypothesis from [N] independent agents:
[Hypothesis]
[Supporting evidence and convergence stats]

Your job: find the strongest counterarguments. Where does this fail?
What alternative explanations are equally consistent with the evidence?
What experiment would definitively falsify this hypothesis?

Erwartet: Ein Satz Gegenargumente, Grenzfaelle und ein Falsifikations-Experiment. Wenn die Hypothese adversariale Pruefung ueberlebt, ist sie bereit fuer Integration. Ein guter adversarialer Pass verteidigt manchmal teilweise den Konsens — findet dass das Design besser als Alternativen ist auch wenn unvollkommen.

Bei Fehler: Wenn der adversariale Agent einen fatalen Fehler findet, die Kritik in eine gezielte Follow-up-Welle zurueckspeisen (Tier 3+ iterativer Modus — 5-10 Agents auswaehlen die am besten positioniert sind die spezifische Kritik zu adressieren).

Schritt 8: An Teams uebergeben

Entfesselung findet Probleme; Teams loesen sie. Verifizierte Hypothesen-Familien in umsetzbare Issues konvertieren, dann fokussierte Teams zusammenstellen um jedes zu loesen.

  1. Ein GitHub-Issue pro verifizierter Hypothesen-Familie erstellen (den create-github-issues-Skill nutzen)
  2. Issues nach Konvergenz-Staerke und Impact priorisieren
  3. Fuer jedes Issue ein kleines Team via TeamCreate zusammenstellen:
    • Wenn eine vordefinierte Team-Definition in teams/ zur Problem-Domaene passt, sie nutzen
    • Wenn kein passendes Team existiert, auf opaque-team defaulten (N Shapeshifters mit adaptiver Rollen-Zuweisung) — es behandelt unbekannte Problem-Formen ohne eine custom Komposition zu erfordern
    • Mindestens einen nicht-technischen Agent einbeziehen (z.B. advocatus-diaboli, contemplative) — sie fangen Implementations-Risiken die technische Agents verfehlen
    • REST-Checkpoints zwischen Phasen nutzen um Hetzen zu verhindern
  4. Die Pipeline ist: Entfesseln → Triagieren → Team-pro-Issue → Loesen

Erwartet: Jede Hypothesen-Familie mappt zu einem getrackten Issue mit zugewiesenem Team. Die Entfesselung produzierte die Diagnose; die Teams produzieren den Fix.

Bei Fehler: Wenn die Team-Komposition nicht zum Problem passt, neu zuweisen. Shapeshifter-Agents koennen recherchieren und entwerfen aber haben keine Schreib-Tools — der Team-Lead muss ihre Code-Vorschlaege anwenden.

Validierung

  • Alle verfuegbaren Agents wurden konsultiert (oder ein absichtliches Subset wurde mit Begruendung gewaehlt)
  • Antworten wurden in einem strukturierten, parsebaren Format gesammelt
  • Hypothesen wurden dedupliziert und nach unabhaengiger Konvergenz rangiert
  • Die Top-Hypothese wurde gegen ein Null-Modell oder programmatischen Test verifiziert
  • Ein adversarialer Pass forderte den Konsens heraus
  • Die finale Hypothese enthaelt testbare Vorhersagen und bekannte Beschraenkungen

Haeufige Stolperfallen

  • Zu wenige Beispiele im Brief: Agents brauchen 5+ Beispiele um Muster zu finden. Mit 3 Beispielen greifen die meisten Agents auf Oberflaechen-Muster-Matching oder Template-Echo zurueck (den Brief in unterschiedlichen Worten zurueckwiederholen).
  • Kein Verifikations-Pfad: Ohne einen Weg Hypothesen zu testen kann man Signal nicht von Rauschen unterscheiden. Konvergenz allein ist notwendig aber nicht ausreichend.
  • Metaphorische Antworten: Domaenen-Spezialisten-Agents (mystic, shaman, kabalist) koennen mit reichem metaphorischem Reasoning antworten das schwer programmatisch zu parsen ist. "Druecke deine Hypothese als testbare Formel oder Algorithmus aus" im Ausgabe-Template einbeziehen.
  • Wiederentdeckung ueber Wellen: Ohne Inter-Wellen-Wissens-Injektion entdecken Wellen 3-7 unabhaengig wieder was Wellen 1-2 bereits gefunden haben. Den Brief immer zwischen Wellen aktualisieren.
  • Konvergenz ueberinterpretieren: 43% Konvergenz auf eine Mechanismus-Familie klingt beeindruckend, aber die Basis-Rate pruefen. Wenn es nur 3 plausible Mechanismus-Familien gibt, waere zufaellige Konvergenz ~33%.
  • Single-Familien-Dominanz erwarten: Abstrakte Probleme (Mustererkennung, Kryptografie) tendieren dazu eine dominante Hypothesen-Familie zu produzieren. Multi-dimensionale Probleme (Codebasis-Analyse, System-Design) produzieren breitere Konvergenz ueber mehrere gueltige Familien — das ist erwartet und gesund, kein Versagen des Musters.
  • Generische Rahmung fuer nicht-technische Agents: Die Qualitaet des Beitrags eines nicht-technischen Agents haengt davon ab wie der Brief das Problem in seiner Domaenen-Sprache rahmt. "Was sagt deine Tradition ueber Systeme an dieser Schwelle?" produziert strukturelle Erkenntnis; ein generischer Brief produziert nichts. In domaenen-spezifische Rahmung fuer Agents ausserhalb der natuerlichen Domaene des Problems investieren.
  • Dies fuer Ausfuehrung nutzen: Dieses Muster generiert Hypothesen, keine Implementationen. Sobald verifizierte Hypothesen vorliegen, sie zu Issues konvertieren und an Teams uebergeben (Schritt 8). Die Pipeline ist Entfesseln → Triagieren → Team-pro-Issue.

Verwandte Skills

  • forage-solutions — Ameisenkolonie-Optimierung zum Erkunden von Loesungsraeumen (komplementaer: engerer Scope, tiefere Erkundung)
  • build-coherence — Bienen-Demokratie zur Auswahl unter konkurrierenden Ansaetzen (nach diesem Skill nutzen um zwischen Top-Hypothesen zu waehlen)
  • coordinate-reasoning — stigmergische Koordination zum Verwalten von Informationsfluss zwischen Agents
  • coordinate-swarm — breitere Schwarm-Koordinations-Muster fuer verteilte Systeme
  • expand-awareness — offene Wahrnehmung vor Verengung (komplementaer: als individuelle Agent-Vorbereitung nutzen)
  • meditate — Kontext-Rauschen vor Start klaeren (empfohlen vor Schritt 1)

GitHub Repository

pjt222/agent-almanac
Path: i18n/de/skills/unleash-the-agents
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Related Skills

content-collections

Meta

This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.

View skill

polymarket

Meta

This skill enables developers to build applications with the Polymarket prediction markets platform, including API integration for trading and market data. It also provides real-time data streaming via WebSocket to monitor live trades and market activity. Use it for implementing trading strategies or creating tools that process live market updates.

View skill

creating-opencode-plugins

Meta

This skill helps developers create OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It provides the plugin structure, event API specifications, and implementation patterns for JavaScript/TypeScript modules. Use it when you need to intercept, monitor, or extend the OpenCode AI assistant's lifecycle with custom event-driven logic.

View skill

sglang

Meta

SGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.

View skill