Communitygithub.com

AgentSpeak(L) & BDI-Agentenarchitektur

Logikbasierte Agenten-Programmiersprache, die die BDI-Architektur (Belief-Desire-Intention) für die praktische Entwicklung autonomer Agenten implementiert.

Was ist AgentSpeak(L) & BDI-Agentenarchitektur?

Diese Fertigkeit (Skill) beschreibt die AgentSpeak(L)-Programmiersprache, die auf der BDI-Architektur (Belief-Desire-Intention) basiert. Sie ermöglicht die Entwicklung autonomer Agenten, die in dynamischen Umgebungen sowohl reaktiv als auch zielorientiert handeln können. Das Skill enthält detaillierte Entscheidungsbäume für die Planauswahl, Fehlerbehandlung und Aktualisierung von Überzeugungen sowie die Beschreibung der zentralen Selektionsfunktionen SE (Ereignisauswahl), SO (Optionsauswahl) und SI (Intentionsauswahl). Es werden typische Fehlermodi wie Plan-Thrashing, Stale-Belief-Paralyse, unendliche Intentionsschleifen und der Anti-Pattern „Policy-in-Plans“ behandelt. Anhand von konkreten Beispielen (Multi-Agenten-Koordination und Interrupt-Behandlung) wird die praktische Anwendung veranschaulicht. Die Fertigkeit ist plattformunabhängig und richtet sich an Entwickler, die komplexe, autonome Systeme mit expliziten Entscheidungsfunktionen und intelligentem Fehlermanagement bauen möchten. Sie eignet sich nicht für einfache reaktive Systeme, statische Planung, Echtzeitanwendungen oder reine Datenverarbeitungspipelines.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/agentspeak-bdi

In Ihrer bevorzugten KI fragen

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

Dokumentation

SKILL.md — AgentSpeak(L) & BDI-Agentenarchitektur

Wenn autonome Entitäten wahrnehmen, deliberieren und handeln müssen, während sie konkurrierende Ziele managen und auf Ereignisse reagieren, ohne laufende Arbeiten abzubrechen.


Entscheidungspunkte

Primäre Architekturauswahl

WENN System nur Ereignisreaktion ohne persistente Ziele benötigt
  → Verwende reaktives/Regelsystem (BDI ist übertrieben)
SONST WENN System Planung in statischer Umgebung ohne Unterbrechungen benötigt  
  → Verwende klassischen Planer
SONST WENN System sowohl Reaktivität ALS AUCH Zielpersistenz in dynamischer Umgebung benötigt
  → Verwende BDI-Architektur

Aufruftabelle für Selektionsfunktionen

SituationFunktionEntscheidungskriterien
Neues Ereignis trifft einSE (Ereignisauswahl)Priorität, Dringlichkeit, Ressourcenbeschränkungen
Ereignis benötigt PlanSO (Optionsauswahl)Kontextbedingungen, Planerfolgshistorie, Risikotoleranz
Mehrere aktive IntentionenSI (Intentionsauswahl)Fristen, Ressourcenzuteilung, Fairness-Policy
Planfehler tritt aufSO dann SIFehlerbehandlungsplan finden, dann Intentionen neu planen

Entscheidungsbaum zur Planfehlerbehandlung

Plan P schlägt bei Ausführung von Aktion A fehl:
WENN Fehlerbehandlungsplan für diesen Fehlertyp existiert
  → Fehlerereignis posten, SO wählt Wiederherstellungsplan aus
  → Mit modifiziertem Intentionsstack fortfahren
SONST WENN alternative Pläne für dasselbe auslösende Ereignis existieren
  → Zum Ereignis zurückkehren, SO den nächsten anwendbaren Plan ausprobieren lassen  
  → Fehlgeschlagenen Plan von der Auswahl ausschließen
SONST WENN keine Alternativen verfügbar
  → Fehler im Intentionsstack nach oben weiterreichen
  → WENN Elternplan existiert → Fehlerereignis auf Elternebene auslösen
  → SONST Intention vollständig verwerfen

Auswirkungsbewertung von Überzeugungsaktualisierungen

Neue Überzeugung B trifft ein:
WENN B bestehenden Überzeugungen widerspricht
  → Überzeugungsrevisionsprotokoll ausführen
  → Alle aktiven Intentionen auf Verletzungen von Kontextbedingungen prüfen
  → WENN Kontext nicht mehr gilt → Intention aussetzen (nicht verwerfen)
SONST WENN B neue anwendbare Pläne ermöglicht
  → Ereigniswarteschlange auf ruhende Ereignisse prüfen, für die jetzt Pläne anwendbar sind
  → Mit SE neu priorisieren
SONST WENN B ausstehende Zielbedingungen erfüllt  
  → Erfüllung markieren, zugehörige Intentionen bereinigen
  → Erfüllungsereignis für Planbereinigung posten

Fehlermodi

1. Plan-Thrashing

Symptome: Der Agent wechselt schnell zwischen Plänen, ohne Fortschritte zu machen; dasselbe Ereignis löst wiederholt verschiedene Pläne aus. Erkennungsregel: Wenn dasselbe Ereignis >3 Mal in N Ausführungszyklen mit jeweils unterschiedlichen Planauswahlen verarbeitet wird, liegt Plan-Thrashing vor. Ursache: Die SO-Funktion (Optionsauswahl) ist nicht-deterministisch oder die Kontextbedingungen sind zu schwach/überlappend. Behebung: SO explizit nach Priorität ordnen; Kontextbedingungen stärken, sodass sie sich gegenseitig ausschließen; Planerfolgs-/Fehlerhistorie zu den Auswahlkriterien hinzufügen.

2. Stale-Belief-Paralyse

Symptome: Der Agent wählt Pläne basierend auf einem veralteten Weltmodell aus; Pläne schlagen sofort aufgrund falscher Annahmen über die Umgebung fehl. Erkennungsregel: Wenn die Planfehlerrate >50% beträgt und die Fehler auf Kontextbedingungsverletzungen zur Ausführungszeit (nicht zur Planungszeit) zurückzuführen sind, liegen veraltete Überzeugungen vor. Ursache: Die Aktualisierungsfrequenz der Überzeugungen ist im Verhältnis zur Änderungsrate der Umgebung zu niedrig; die Überzeugungsrevision wird nicht an die Kontextprüfungen der Intentionen weitergegeben. Behebung: Wahrnehmungsfrequenz erhöhen; Zeitstempel für Überzeugungsveralterung hinzufügen; Intentionen aussetzen, wenn ihre Kontextbedingungen ungültig werden.

3. Unendliche Intentionsschleifen

Symptome: Der Agent erstellt Intentionen, die Ereignisse posten, die wiederum weitere Intentionen für dasselbe Ziel erzeugen; der Intentionsstack wächst unbegrenzt. Erkennungsregel: Wenn die Tiefe des Intentionsstacks monoton über die Zeit zunimmt, ohne dass entsprechende Zielerreichungen erfolgen, liegen Intentionsschleifen vor. Ursache: Pläne erzeugen Unterziele, die letztendlich zum ursprünglichen Ziel zurückführen, ohne Abbruchbedingungen. Behebung: Erkennung von Zielerreichung in Kontextbedingungen hinzufügen; Intentionssubsumtion implementieren (doppelte Intentionen zusammenführen); maximale Rekursionstiefe begrenzen.

4. Anti-Pattern „Policy-in-Plans“

Symptome: Dieselben Ereignisse lösen basierend auf Bedingungen innerhalb von Plankörpern unterschiedliches Verhalten aus; die Agenten-Policy ist verstreut und schwer zu ändern. Erkennungsregel: Wenn Plankörper Prioritäts-/Dringlichkeitsbedingungen enthalten (if high_priority then X else Y), ist die Policy am falschen Ort. Ursache: Die Rationalität des Agenten ist in der Planlogik anstatt in den Selektionsfunktionen kodiert. Behebung: Die gesamte Prioritäts-/Policy-Logik in die SE/SO/SI-Funktionen verschieben; Pläne policy-neutral und nur kontextsensitiv machen.

5. Einzel-Intentions-Engpass

Symptome: Der Agent kann keine Unterbrechungen verarbeiten; dringende Ereignisse warten, während der Agent langlaufende Aufgaben abschließt; keine Parallelität. Erkennungsregel: Wenn der Agent zu jeder Zeit höchstens eine aktive Intention hat, liegt ein Einzel-Intentions-Engpass vor. Ursache: Die SI-Funktion (Intentionsplanung) implementiert keine echte Parallelität; sie behandelt Intentionen als exklusiv statt parallel. Behebung: Mehrere aktive Intentionen zulassen; präemptive Planung in SI implementieren; Pläne als unterbrechbare Sequenzen entwerfen.


Durchgearbeitete Beispiele

Beispiel 1: Multi-Agenten-Aufgabenzuteilung mit Plankonflikten

Szenario: Zwei Agenten (A1, A2) koordinieren sich, um deliver(package, destination) zu erreichen. Beide haben Pläne, aber unterschiedliche Fähigkeiten.

Ausgangszustand:

  • A1 Überzeugungen: location(A1, warehouse), can_carry(A1, small_items), location(package, warehouse)
  • A2 Überzeugungen: location(A2, depot), can_carry(A2, any), has_vehicle(A2)
  • Gemeinsame Überzeugung: size(package, large), destination(customer_site)

Ereignis: +!deliver(package, customer_site) an beide Agenten gepostet

Entscheidungsprozess:

  1. A1 Planauswahl (SO):

    • Plan P1: +!deliver(X,Y) : can_carry(A1,small_items) & size(X,small) <- pickup(X); transport(X,Y)
    • Kontextbedingung schlägt fehl: size(package,large) widerspricht size(X,small)
    • Keine anwendbaren Pläne → postet plan_failure(deliver, no_capability)
  2. A2 Planauswahl (SO):

    • Plan P2: +!deliver(X,Y) : can_carry(A2,any) & has_vehicle(A2) <- pickup(X); drive(X,Y); dropoff(X)
    • Kontextbedingung erfüllt → P2 ausgewählt
    • Erstellt Intention I1: [pickup(package), drive(package,customer_site), dropoff(package)]
  3. A1 Überzeugungsaktualisierung:

    • Erhält Nachricht: attempting(A2, deliver, package)
    • Aktualisiert Überzeugungen: +delegated(deliver, package, A2)
    • Verwirft fehlgeschlagene Intention

Anfängerfehler: Beide Agenten würden versuchen, die Lieferung durchzuführen, was zu Ressourcenkonflikten führt. Experteneinblick: Koordination erfolgt durch gemeinsame Überzeugungen und Kontextbedingungen von Plänen, nicht durch fest kodiertes Agentenwissen.

Beispiel 2: Interrupt-Behandlung mit Intentionsüberprüfung

Szenario: Agent führt eine langlaufende Datenverarbeitungsaufgabe aus und erhält einen dringenden Sicherheitsalarm.

Ausgangszustand:

  • Aktive Intention I1: [process_batch(data1), process_batch(data2), generate_report()]
  • Aktuelle Ausführung: mitten in process_batch(data1) (dauert noch 10 Minuten)

Ereignis: +security_alert(intrusion_detected, server_3)

Entscheidungsprozess:

  1. Ereignisauswahl (SE):

    • SE Prioritäten: security_events > routine_processing
    • security_alert wird gegenüber Fortsetzung von I1 ausgewählt
  2. Planauswahl (SO):

    • Plan P3: +security_alert(Type,Location) : has_admin_access <- isolate_system(Location); notify_team(Type)
    • Kontextbedingung erfüllt → P3 ausgewählt
    • Erstellt Intention I2: [isolate_system(server_3), notify_team(intrusion_detected)]
  3. Intentionsplanung (SI):

    • Aktuelle Intentionen: I1 (ausgesetzt bei process_batch(data1)), I2 (neu, dringend)
    • SI-Policy: Sicherheitsintentionen verdrängen Verarbeitungsintentionen
    • Wählt I2 zur Ausführung aus
  4. Ausführung:

    • Führt isolate_system(server_3) sofort aus
    • Führt notify_team(intrusion_detected) aus
    • I2 abgeschlossen, wird aus der Intentionsmenge entfernt
  5. Wiederaufnahme:

    • Nur I1 bleibt: [process_batch(data1), process_batch(data2), generate_report()]
    • Nimmt process_batch(data1) ab dem Aussetzungspunkt wieder auf

Anfängerfehler: Würde entweder den Sicherheitsalarm ignorieren oder die Verarbeitungsaufgabe vollständig abbrechen. Experteneinblick: Die Intentionsaussetzung bewahrt Fortschritte und ermöglicht gleichzeitig reaktionsfähiges Verhalten. Die SI-Scheduling-Policy ist explizit und konfigurierbar.


Qualitätsprüfungen

  • Die Agentenarchitektur verfügt über explizite SE-, SO- und SI-Selektionsfunktionen mit dokumentierten Policys
  • Jeder Plan hat ein genau definiertes auslösendes Ereignis und eine Kontextbedingung, die anhand der aktuellen Überzeugungen ausgewertet werden kann
  • Die Planbibliothek enthält Fehlerbehandlungspläne für jeden Hauptplantyp (nicht nur Erfolgspfade)
  • Der Überzeugungsaktualisierungsmechanismus kann widersprüchliche Informationen verarbeiten und Änderungen an aktive Intentionen weitergeben
  • Mehrere Intentionen können gleichzeitig aktiv sein, mit klaren Regeln für Planung/Verdrängung
  • Die Ereigniswarteschlangenverarbeitung ist priorisiert (nicht FIFO) mit expliziter Prioritätszuweisung
  • Planfehler lösen Ereignisse aus, keine Systemabstürze oder stillen Fehlschläge
  • Kontextbedingungen schließen sich gegenseitig aus ODER die Planauswahl ist explizit geordnet, um Nichtdeterminismus zu vermeiden
  • Der Agent kann seine Aktionen erklären, indem er den Intentionsstack und die auslösenden Ereignisse offenlegt
  • Die Systemleistung verschlechtert sich unter hoher Ereignislast allmählich (keine Endlosschleifen oder Stapelüberläufe)

NICHT-FÜR-Grenzen

NICHT FÜR: Einfache regelbasierte Systeme, bei denen alles Verhalten reaktiv ist (keine persistenten Ziele) → STATTDESSEN VERWENDEN: Einfache Regelmaschine oder Ereignis-Aktions-System

NICHT FÜR: Statische Planungsprobleme, bei denen sich die Umgebung während der Ausführung nicht ändert
→ STATTDESSEN VERWENDEN: Klassische Planer (A*, STRIPS, HTN)

NICHT FÜR: Echtzeitsysteme, die garantierte Antwortzeiten oder harte Fristen erfordern → STATTDESSEN VERWENDEN: Echtzeit-Planungssysteme mit Zeitanalyse

NICHT FÜR: Systeme, bei denen die gesamte Koordination von einem zentralen Controller übernommen werden kann → STATTDESSEN VERWENDEN: Workflow-Orchestrierung oder zentrale Aufgabenwarteschlange

NICHT FÜR: Reine Datentransformationspipelines ohne autonome Entscheidungsfindung → STATTDESSEN VERWENDEN: ETL-Tools, Stream-Processing-Frameworks

NICHT FÜR: Anwendungen, die maschinelles Lernen oder statistische Inferenz als primäre Fähigkeit erfordern → STATTDESSEN VERWENDEN: ML-Frameworks mit BDI als Koordinationsschicht, falls erforderlich

Individual skills in this repo

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

curiositech/windags-skills

Expert in 2000s-era music visualization (Milkdrop, AVS, Geiss) and modern WebGL implementations. Specializes in Butterchurn integration, Web Audio API AnalyserNode FFT data, GLSL shaders for audio-reactive visuals, and psychedelic generative art. Activate on "Milkdrop", "music visualization", "WebGL visualizer", "Butterchurn", "audio reactive", "FFT visualization", "spectrum analyzer". NOT for simple bar charts/waveforms (use basic canvas), video editing, or non-audio visuals.

curiositech/windags-skills

Expert legal research agent for finding and scraping expungement data state by state. Knows authoritative sources, URL patterns, Firecrawl configuration, and 2026 legal landscape.

curiositech/windags-skills

Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).

curiositech/windags-skills

Implement WCAG 2.2 AA/AAA compliance with automated testing, keyboard navigation, screen reader support, and focus management. Activate on: accessibility audit, WCAG compliance, keyboard navigation, screen reader, aria attributes, axe-core, focus trap. NOT for: design-level accessibility review (use design-accessibility-auditor), color contrast only (use css-in-js-architect).

curiositech/windags-skills

Time-blind friendly planning, executive function support, and daily structure for ADHD brains. Specializes in realistic time estimation, dopamine-aware task design, and building systems that actually work for neurodivergent minds.

curiositech/windags-skills

Designs digital experiences for ADHD brains using neuroscience research and UX principles. Expert in reducing cognitive load, time blindness solutions, dopamine-driven engagement, and compassionate design patterns. Activate on 'ADHD design', 'cognitive load', 'accessibility', 'neurodivergent UX', 'time blindness', 'dopamine-driven', 'executive function'. NOT for general accessibility (WCAG only), neurotypical UX design, or simple UI styling without ADHD context.

curiositech/windags-skills

>- Apply crisis decision-making research to agent routing, uncertainty triage, and coordination failure analysis in time-pressured systems. Use when diagnosing handoff failures, analytical paralysis, or expert judgment under incomplete information. NOT for routine coding, simple CRUD design, or static single-agent tasks with complete information.

curiositech/windags-skills

Extend and modify the admin dashboard, developer portal, and operations console. Use when adding new admin tabs, metrics, monitoring features, or internal tools. Activates for dashboard development, analytics, user management, and internal tooling.

curiositech/windags-skills

Conversation patterns and interaction protocols for multi-agent systems. Covers request/response, pub/sub, blackboard, delegation chains, debate, critique, consensus, fan-out/fan-in, supervisor-worker, and peer negotiation. Deep analysis of AutoGen conversation patterns, CrewAI delegation, LangGraph state passing, and FIPA-ACL performatives. Teaches how to design what agents say to each other and in what order. Activate on: "agent conversation", "agent protocol", "multi-agent debate", "agent delegation", "supervisor worker pattern", "agent voting", "consensus protocol", "fan-out fan-in", "agent negotiation", "blackboard pattern", "agent dialogue", "conversation topology", "agent handoff". NOT for: wire format or serialization (use agent-interchange-formats), orchestration infrastructure (use agentic-infrastructure-2026), single agent behavior (use agentic-patterns).

curiositech/windags-skills

Meta-agent for creating new custom agents, skills, and MCP integrations. Expert in agent design, MCP development, skill architecture, and rapid prototyping. Activate on 'create agent', 'new skill', 'MCP server', 'custom tool', 'agent design'. NOT for using existing agents (invoke them directly), general coding (use language-specific skills), or infrastructure setup (use deployment-engineer).

curiositech/windags-skills

AI-powered calendar management and agent-based scheduling coordination. Covers calendar APIs (Google Calendar, CalDAV/iCal), AI scheduling assistants (Reclaim, Clockwise, Motion, Cal.com), building custom calendar agents with MCP, multi-calendar merging, timezone management, focus block protection, meeting fatigue detection, and agent-to-agent meeting negotiation protocols. Activate on: "calendar agent", "AI scheduling", "calendar coordination", "meeting scheduling", "calendar API", "focus time protection", "calendar optimization", "Google Calendar MCP", "Reclaim", "Clockwise", "Motion", "Cal.com", "smart scheduling", "calendar-aware agent", "timezone scheduling", "agent negotiation meetings". NOT for: manual calendar UI component design (use form-validation-architect), project management scheduling or Gantt charts (use project-management-guru-adhd), general time-tracking or pomodoro apps (use adhd-daily-planner for time-awareness), building the agent itself from scratch (use agent-creator).

curiositech/windags-skills

Build and adopt production AI agent infrastructure in 2026. Covers framework selection (LangGraph, CrewAI, AutoGen, MCP), orchestration patterns, evaluation, observability, memory systems, and tool use. Also covers the SOCIAL dimension: how to sell agent infrastructure internally, change management, measuring ROI, building trust in autonomous systems, and scaling adoption across teams. Activate on: "agent infrastructure", "agent framework comparison", "which agent framework", "sell AI tools internally", "agent adoption", "agent observability", "agent evaluation", "MCP architecture", "agentic mesh", "enterprise AI agents", "AI change management", "agent ROI". NOT for: building specific agents (use ai-engineer), designing agent behavior patterns (use agentic-patterns), prompt tuning (use prompt-engineer).

curiositech/windags-skills

Fundamental patterns for effective agentic behavior. Teaches decomposition, tool orchestration, error recovery, context management, quality self-assessment, and knowing when to stop. Model-agnostic principles that make any agent more effective regardless of domain. Activate on: "how should I structure this agent", "agentic workflow", "agent patterns", "multi-step task", "tool orchestration", "/agentic-patterns", "decompose this", "agent best practices", "chain of actions", "when should the agent stop", "agent loop design". NOT for: creating agent infrastructure (use agent-creator), building DAGs (use windags-architect), specific tool implementation.

curiositech/windags-skills

Automated discovery and matching of agent skills for dynamic task routing and capability assessment

curiositech/windags-skills

Cryptographic security for agentic systems — zero-trust agent networking, signed message envelopes (JWS/JWE), capability-based security (ocaps), Merkle tree audit trails, WASM sandboxing, and formal verification. Covers CLI dev tool security, mTLS between agents, permission boundaries (least privilege for AI agents), and supply chain security for skills/plugins. Activate on: "agent security", "zero trust agents", "secure agent communication", "capability-based security", "ocap", "signed messages between agents", "agent audit trail", "sandbox agent execution", "agent permissions", "mTLS agents", "cryptographic verification", "agent supply chain", "OWASP agentic", "prove agent did X", "tamper-proof agent logs". NOT for: application-level SAST scanning (use security-auditor), network firewall rules (use infrastructure), SOC2/HIPAA compliance (organizational), or prompt injection defense (use prompt-engineer).

curiositech/windags-skills

Data structures and serialization formats for agent-to-agent communication. Covers message envelopes, structured output schemas, capability declarations, task handoff payloads, error/retry signaling, and context windows as data structures. Deep comparison of A2A protocol, MCP, OpenAI function calling, and LangChain message types. Teaches when to use rigid schemas vs free-form with validation, typed vs untyped, streaming vs batch. Activate on: "agent message format", "agent communication schema", "agent-to-agent protocol", "A2A protocol", "MCP message format", "structured output for agents", "agent interop", "interchange format", "agent serialization", "task handoff format", "capability declaration". NOT for: what agents say to each other (use agent-conversation-protocols), orchestration topology (use multi-agent-coordination), building agent infrastructure (use agentic-infrastructure-2026).

curiositech/windags-skills

>- Design AgentSpeak(L)-style BDI agents with context-guarded plans, selection functions, and intention stacks. Use for interruptible autonomy, agent policy, and multi-agent orchestration in dynamic environments. NOT for simple rule engines, static planners, or centralized workflows.

curiositech/windags-skills

Foundational concurrent computation model where actors communicate exclusively through asynchronous message passing

curiositech/windags-skills

Build production-ready LLM applications, advanced RAG systems, and intelligent agents. Implements vector search, multimodal AI, agent orchestration, and enterprise AI integrations. Use PROACTIVELY for LLM features, chatbots, AI agents, or AI-powered applications.

curiositech/windags-skills

license: Apache-2.0 NOT for unrelated tasks outside this domain.

Verwandte Skills