CommunitySchreiben & Editierengithub.com

Jamie-BitFlight/parallel-work

Formen zur gleichzeitigen Ausführung mehrerer Sub-Agenten – Fan-Out mit Barriere, Maker/Checker, Generate-and-Filter, Turniere zum Ranking, Hypothesen-Fan-Out für Root-Cause und Schleifen mit Stoppbedingung und Begrenzung.

Was ist parallel-work?

Diese Fähigkeit definiert wiederverwendbare Parallelisierungsmuster für KI-Agenten (Claude Code, Cursor, Codex), die unabhängige Arbeitseinheiten gleichzeitig ausführen. Sie umfasst sechs Hauptformen: Fan-Out/Fan-In mit Synchronisationsbarriere, mechanisches Fan-Out (einmal entscheiden, mehrfach anwenden), Maker/Checker (Trennung von Produktion und Prüfung), Generate-and-Filter (Kandidaten erzeugen, bewerten, auswählen), Turniere (paarweise Vergleiche für Ranglisten), Hypothesen-Fan-Out (Root-Cause-Analyse durch parallele Hypothesen und Widerlegung) sowie Schleifen mit Stoppbedingung (wiederholen, bis ein Signal eintritt, mit konfigurierbarem Maximum). Voraussetzung ist echte Unabhängigkeit der Einheiten: keine gegenseitigen Abhängigkeiten, isolierte Schreibvorgänge (eigene Arbeitsverzeichnisse oder Dateien). Die Muster vermeiden persistente Agententeams, da diese nicht portabel sind und inkonsistent befolgt werden. Die Formatierung folgt einer Checklisten-Logik: Jedes unerledigte `- [ ]`-Element wird als eigener Dispatch behandelt, die Schleife läuft, bis keine ungeprüften Einträge mehr vorhanden sind. Caps verhindern Endlosschleifen und erzwingen explizite Fehlerberichte (`PARTIAL` oder `BLOCKED`).

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jamie-BitFlight/claude_skills/tree/main/plugins/agent-orchestration/skills/parallel-work

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Parallele Arbeit

Parallelität bringt frische Kontexte pro Einheit und Geschwindigkeit. Sie kostet Koordination: ein Fan-In, das warten muss, eine Zusammenführung, die nicht kollidieren darf, ein Richter, der nicht der Hersteller sein darf. Nutzen Sie sie dort, wo die Einheiten wirklich unabhängig sind, und bezahlen Sie die Koordinationskosten explizit.

Vorbedingungen

  • Die Einheiten sind unabhängig: Keine benötigt das Ergebnis einer anderen, um zu starten.
  • Sie wissen, was die Einheiten sind. Unbekannte Ursache → zuerst einen Untersuchungs-Dispatch senden.
  • Schreibvorgänge sind isoliert: Jede Einheit schreibt in andere Dateien, oder jede Einheit läuft in einem eigenen Arbeitsverzeichnis und committet nur die Dateien, die sie bearbeitet hat (Mechanik: delegate/references/harness-notes/claude-code.md, Abschnitt Isolation).

Fehlt eine dieser Voraussetzungen → serialisieren oder zuerst untersuchen.

Formen

Fan-Out, Fan-In. N Dispatches der gleichen Phase, einer pro Einheit, gemeinsam gesendet. Ein einzelner konsolidierender Dispatch wartet auf alle – dieses Warten ist die Barriere – und führt ihre Ergebnisdateien zu einer zusammen. Halten Sie die Ausgabe jeder Einheit in einer Datei; der Konsolidator liest Pfade, nicht Ihren Kontext.

Mechanisches Fan-Out. Ein process-Dispatch entscheidet die genaue Änderung einmal. N generische Dispatches wenden sie wortwörtlich an, jeder auf seine eigenen Ziele. Ein review-Dispatch prüft die gesamte Menge. Der Orchestrator wendet die Änderung nie selbst an, so klein die Menge auch sein mag.

Maker/Checker. Wer ein Ergebnis produziert hat, beurteilt es nie. Leiten Sie review an einen anderen Agenten weiter – einen Agenten vom Typ Reviewer für die Domäne, falls vorhanden, sonst einen Spezialisten in einer anderen Rolle – mit den Erfolgskriterien und dem Pfad zum Artefakt, und nichts aus der Argumentation des Herstellers.

Generieren und Filtern. Fan-Out zur Erzeugung von Kandidaten; ein Dispatch dedupliziert und bewertet sie anhand eines schriftlichen Bewertungsrasters; nur die Überlebenden machen weiter. Schreiben Sie das Bewertungsraster vor dem Generieren.

Turnier. Zur Rangfolge einer Menge, die zu groß ist, um in einem Fenster beurteilt zu werden: Paarweise Vergleichsdispatches, jeder mit zwei Elementen, mit einer in einer Datei gehaltenen Turnierstruktur. Vergleichende Urteile sind zuverlässiger als absolute Bewertungen.

Hypothesen-Fan-Out. Für die Ursachenanalyse: Ein Dispatch pro disjunkter Beweisquelle (Logs, Code, Daten) erstellt eine Hypothese allein aus seiner Quelle. Dann versucht ein Dispatch pro Hypothese, sie zu widerlegen. Was die Widerlegung überlebt, ist der Befund.

Schleife bis zum Stopp. Für Arbeiten unbekannter Größe: Wiederholen Sie einen Dispatch, bis eine beobachtbare Bedingung eintritt – keine neuen Erkenntnisse, null Fehler in der Gate-Ausgabe, die Checklistendatei hat keine ungeprüften Einträge. Setzen Sie die Obergrenze vor der ersten Iteration (Standard 5). Bei Erreichen der Obergrenze melden Sie PARTIAL mit dem, was noch übrig ist.

Checklisten-Fan-Out

Eine Markdown-Datei mit - [ ]-Einträgen ist eine gebrauchsfertige Einheitenliste: ein Dispatch pro ungeprüftem Eintrag, jeder angewiesen, seine eigene Zeile bei DONE abzuhaken, dann Schleife bis zum Stopp bei „es sind keine ungeprüften Einträge mehr vorhanden“. Serialisieren Sie Einträge, die dieselbe Datei benennen.

Obergrenzen und Stoppbedingungen

Jede Schleife und jedes Fan-In hat eine vor dem Start schriftlich festgelegte Zahl: Iterationen, Wiederholungen oder Einheiten. Das Erreichen der Obergrenze ist ein PARTIAL- oder BLOCKED-Bericht an den Benutzer, niemals ein stiller Wiederholungsversuch.

Persistente Teams

Manche Harness-Systeme bieten langlebige Agententeams mit gemeinsamen Aufgabenlisten und Nachrichtenaustausch. Sie fügen Anweisungs- und Kommunikationsaufwand hinzu, dem Agenten inkonsistent folgen, und sie sind nicht zwischen verschiedenen Harnesses portierbar. Die obigen Formen benötigen nichts davon. Greifen Sie nur dann zu einem Team, wenn Agenten während einer Aufgabe Nachrichten austauschen müssen, und konsultieren Sie in diesem Fall die Harness-Notizen.

Verweise

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

Jamie-BitFlight/agentskill-kaizen-meta-docs

Agentskill kaizen plugin documentation index. Load when needing to read about cross-platform notes, improvement plans, or DuckDB integration.

Jamie-BitFlight/bash-51-features

Bash 5.1 release features and improvements with practical examples. Use when working with Bash 5.1 features, epoch time variables, redirection enhancements, or when user asks about Bash 5.1 changes, new features, or version-specific capabilities.

Jamie-BitFlight/bash-52-features

Bash 5.2 release features and improvements with practical examples. Use when working with Bash 5.2 features, variable handling enhancements, readline improvements, or when user asks about Bash 5.2 changes, new features, or version-specific capabilities.

Jamie-BitFlight/bash-53-features

Bash 5.3 release features and improvements with practical examples. Use when working with Bash 5.3 features, new command substitution, GLOBSORT, loadable builtins, or when user asks about Bash 5.3 changes, new features, or version-specific capabilities.

Jamie-BitFlight/bash-development

This skill should be used when the user asks to "write a bash script", "create a shell script", "implement bash function", "parse arguments in bash", "handle errors in bash", or mentions bash development, shell scripting, script templates, or modern bash patterns.

Jamie-BitFlight/bash-lint

This skill should be used when the user asks to "lint bash script", "run shellcheck", "format shell script", "use shfmt", "fix shellcheck errors", or mentions shell script linting, formatting, code quality, or pre-commit hooks for bash.

Jamie-BitFlight/bash-logging

This skill should be used when the user asks to "add logging to bash script", "colorize output", "implement log levels", "CI/CD sections", "terminal colors in bash", or mentions logging functions, emoji output, collapsible CI sections, or shlocksmith.

Jamie-BitFlight/bash-portability

This skill should be used when the user asks about "POSIX compatibility", "portable shell scripts", "cross-shell compatibility", "bashisms", "shebang selection", or mentions writing scripts that work on different shells (bash, sh, dash, zsh) or different systems.

Jamie-BitFlight/bash-testing

This skill should be used when the user asks to "test bash script", "write shell tests", "use shunit2", "use shellspec", "create test suite for bash", or mentions unit testing, test frameworks, mocking, or test-driven development for shell scripts.

Jamie-BitFlight/brainstorming-skill

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or when users request help with ideation, marketing, and strategic planning. Explores user intent, requirements, and design before implementation using research-validated prompt patterns.

Jamie-BitFlight/clang-format

Configure clang-format code formatting. Use when: user mentions clang-format or .clang-format, analyzing code style/patterns, creating/modifying formatting config, troubleshooting formatting, brace styles/indentation/spacing/alignment/pointer alignment, or codifying conventions.

Jamie-BitFlight/commitlint

When setting up commit message validation for a project. When project has commitlint.config.js or .commitlintrc files. When configuring CI/CD to enforce commit format. When extracting commit rules for LLM prompt generation. When debugging commit message rejection errors.

Jamie-BitFlight/conventional-commits

When writing a git commit message. When task completes and changes need committing. When project uses semantic-release, commitizen, git-cliff. When choosing between feat/fix/chore/docs types. When indicating breaking changes. When generating changelogs from commit history.

Jamie-BitFlight/dasel-reference

Use when querying, modifying, or converting JSON, YAML, TOML, XML, CSV, HCL, or INI with dasel v3. Complete reference for selectors, functions, conditionals, variables, spread operator, type casting, and format-specific patterns.

Jamie-BitFlight/data-exploration

Use when exploring unknown structured data files with dasel v3 — discover schema, list keys, find nested values, sample arrays, identify data types across JSON, YAML, TOML, XML, CSV, HCL, INI formats

Jamie-BitFlight/data-transformation

Use when modifying, converting, or transforming structured data with dasel v3 — in-place mutations, format conversion, batch operations, array manipulation, object construction, and merge patterns across JSON, YAML, TOML, XML, CSV, HCL, INI

Jamie-BitFlight/delegate

Decompose substantive work into phases, dispatch each phase to a sub-agent, and adjudicate what comes back. Use whenever a request asks for implementation, investigation, a fix, a review, or any change to files — including small ones — and whenever you are about to read source or run a diagnostic yourself instead of handing it off. Also use when a report from a sub-agent needs judging, when a phase needs re-dispatching, or when a user names one instance of a pattern. Does not apply when your own prompt begins "Your ROLE_TYPE is sub-agent." — then follow references/sub-agent-contract.md instead.

Jamie-BitFlight/enterprise-hibernate-hbm

Dasel v3 query patterns for Hibernate .hbm.xml mapping files — entity-table binding, Java property-to-column extraction, one-to-many set/list/bag relationship tracing, many-to-one foreign key discovery, batch scanning across 60+ HBM files. Use when querying Hibernate ORM class mappings, extracting schema metadata from Java persistence layer, or auditing entity-column relationships in enterprise legacy codebases.

Jamie-BitFlight/enterprise-installanywhere

Dasel v3 query patterns for InstallAnywhere .iap_xml installer definitions — use when querying action sequences, discovering variables, resolving platform conditions, navigating panels, or comparing installer variants. Files are 2.5+ MB, 65,000+ lines — too large for context reads, requires structural dasel queries.

Jamie-BitFlight/enterprise-maven-pom

Dasel v3 selector patterns for Maven POM XML files — use when querying dependency versions, filtering by groupId or scope, extracting module hierarchy from parent POMs, or detecting version conflicts across enterprise multi-module Java projects. Load this skill when working with pom.xml files using dasel.

Verwandte Skills