Communitygithub.com

Architecture BDI AgentSpeak(L)

Concevez des agents BDI de style AgentSpeak(L) avec des plans protégés par contexte, des fonctions de sélection et des piles d'intentions. Utilisez-le pour l'autonomie interruptible, la politique d'agent et l'orchestration multi-agents dans des environnements dynamiques. PAS pour les moteurs de règles simples, les planificateurs statiques ou les flux de travail centralisés.

Qu'est-ce que Architecture BDI AgentSpeak(L) ?

Cette compétence fournit une architecture complète pour concevoir des agents BDI (Belief-Desire-Intention) basés sur le langage formel AgentSpeak(L). Elle est particulièrement utile pour les développeurs et ingénieurs logiciels qui construisent des systèmes autonomes capables de réagir aux événements tout en maintenant des engagements à long terme, comme les agents de codage, les robots de coordination d'entrepôt ou les systèmes multi-agents. La compétence couvre les modèles mentaux clés (croyances, désirs, intentions), les fonctions de sélection pour la politique, la gestion des interruptions et la modélisation des échecs. Elle s'applique à tout framework d'agent autonome (par exemple, Claude Code, Cursor, Codex) qui nécessite une architecture d'agent réactive et inspectable. La compétence fonctionne en décomposant les problèmes en plans contextuels, en séparant la politique des connaissances du domaine et en représentant explicitement l'état mental de l'agent. Elle inclut des diagrammes de décision, des exemples concrets, des modes d'échec et des références pour une plongée plus approfondie.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/agentspeak-l-bdi-agents-speak-out-in-a-logical-computable

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Architecture BDI AgentSpeak(L) ?

Utilisez cette compétence lorsque la difficulté ne réside pas dans l'écriture d'un autre flux de travail, mais dans la décision de la manière dont un agent autonome doit réagir, s'engager, suspendre son travail et expliquer ses choix dans des conditions changeantes.

Quand l'utiliser

  • Un système doit réagir à de nouveaux événements sans abandonner des engagements de plus longue durée.
  • Vous avez besoin d'une bibliothèque de plans avec des comportements réutilisables sélectionnés par le contexte actuel plutôt que par un seul contrôleur monolithique.
  • La politique de l'agent doit rester séparée des connaissances du domaine afin que l'urgence, l'équité ou la tolérance au risque puissent changer sans réécrire les plans.
  • Les échecs doivent déclencher des comportements de récupération et une replanification au lieu de faire s'effondrer tout l'agent.
  • Vous avez besoin d'un modèle mental inspectable expliquant pourquoi un agent a choisi une tâche ou un plan plutôt qu'un autre.

PAS pour

  • Les moteurs de règles simples où aucun engagement persistant ou pile d'intentions n'est nécessaire.
  • Les problèmes de planification statique où l'environnement n'interrompt pas l'exécution.
  • Les systèmes de flux de travail centralisés où un seul ordonnanceur dicte déjà chaque étape.
  • Les boucles d'agent basées uniquement sur des invites qui ne représentent jamais les croyances, les plans ou la politique séparément.

Modèles mentaux fondamentaux

Les croyances, les désirs et les intentions sont des objets différents

Les croyances modélisent le monde actuel, les désirs définissent les résultats candidats, et les intentions sont les piles de plans spécifiques engagés qui consomment actuellement le budget d'exécution. Si ceux-ci s'effondrent en un seul blob, l'agent cesse d'être interprétable.

Les plans sont des connaissances situées

Les plans AgentSpeak ne sont pas des procédures génériques. Ce sont des recettes déclenchées par des événements avec des gardes de contexte, de sorte que le même objectif peut invoquer des comportements différents selon ce que l'agent croit actuellement.

Les fonctions de sélection contiennent la politique

Le sélecteur d'événements, le sélecteur d'options et le sélecteur d'intentions sont les endroits où résident l'urgence, l'équité et la tolérance au risque. Les plans doivent encoder le savoir-faire ; les fonctions de sélection doivent encoder la stratégie.

L'interruptibilité est une fonctionnalité, pas un bug

Les intentions sont des piles partiellement exécutées qui peuvent être entrelacées, suspendues et reprises. C'est ce qui permet aux agents réactifs de gérer les interruptions sans transformer chaque longue tâche en un redémarrage.

Formalisez vers le haut à partir du système en cours d'exécution

La leçon pratique d'AgentSpeak(L) est de partir d'un cycle d'agent opérationnel et de formaliser ce qu'il fait réellement. N'écrivez pas une théorie abstraite élégante qui devra être approximée dans le comportement d'exécution plus tard.

Points de décision

flowchart TD
  A[Besoins de conception de comportement autonome] --> B{Engagements persistants requis ?}
  B -->|Non| C[Utiliser des règles, des machines à états ou un flux de travail simple]
  B -->|Oui| D{L'environnement interrompt le travail actif ?}
  D -->|Non| E[Un planificateur classique peut suffire]
  D -->|Oui| F{La politique doit-elle être séparée des plans ?}
  F -->|Non| G[Boucle d'agent personnalisée, mais attendez-vous à un couplage]
  F -->|Oui| H[Utiliser le BDI de style AgentSpeak]
  H --> I{Problème actuel}
  I -->|Mauvaise tâche choisie| J[Revoir SI ou SE]
  I -->|Mauvais plan choisi| K[Revoir SO ou les gardes de contexte]
  I -->|L'échec tue l'exécution| L[Ajouter des événements d'échec et des plans de récupération]
  I -->|Difficile à auditer| M[Exposer la pile d'intentions et les traces de sélection]
  • Utilisez la modélisation de style AgentSpeak lorsque le système doit équilibrer réactivité et engagement plutôt que de choisir l'un ou l'autre.
  • Mettez les hypothèses sur le monde dans les requêtes de croyance et les gardes de plan, pas comme des conditionnels enfouis profondément dans les actions.
  • Si la stratégie change mais que la connaissance du domaine reste la même, modifiez les fonctions de sélection avant de réécrire les plans.
  • Décomposez les longues tâches en sous-objectifs afin que les piles d'intentions restent inspectables et interruptibles.

Modes d'échec

Effondrement Objectif-Intention

Indice : la conception dit que l'agent "a un objectif" mais ne peut pas montrer s'il a réellement engagé des ressources pour cela.

Correctif : représentez les objectifs candidats séparément des piles d'intentions actives.

Politique cachée dans les plans

Indice : chaque corps de plan contient des branchements de priorité, d'équité ou d'urgence.

Correctif : déplacez ces choix dans les fonctions de sélection d'événements, d'options ou d'intentions.

Plans monolithiques

Indice : les plans sont si longs que toute interruption force mentalement la séquence entière à redémarrer.

Correctif : divisez les comportements longs en plans plus courts avec des limites de sous-objectifs explicites.

Échec en tant que crash, pas en tant qu'événement

Indice : un sous-objectif échoué abandonne tout l'agent ou disparaît silencieusement.

Correctif : modélisez l'échec comme un événement qui peut déclencher des plans de récupération, de nouvelle tentative ou d'abandon.

Gardes de contexte non fondés

Indice : les plans correspondent à des hypothèses vagues sur le monde qui ne sont jamais liées à des croyances ou observations réelles.

Correctif : rendez les chemins de mise à jour des croyances explicites et maintenez les gardes interrogeables par rapport à l'état de croyance actuel.

Exemples concrets

Agent LLM utilisant des outils avec interruptions urgentes

Un agent de codage travaille sur un long refactoring lorsqu'une alerte de production de haute sévérité arrive. Modélisez le refactoring comme une pile d'intentions et l'alerte comme un nouvel événement. Laissez les fonctions de sélection préempter le refactoring, puis le reprendre plus tard sans perdre l'état.

Coordination d'entrepôt sans répartiteur central

Plusieurs agents mobiles partagent une base de croyances sur la congestion des allées et l'état des stocks. Leur connaissance du domaine reste dans les plans, tandis que les fonctions de sélection encodent quels travaux de prélèvement urgents surpassent le travail de réapprovisionnement en cas de congestion.

Portes de qualité

  • Les croyances, les désirs et les intentions sont représentés séparément.
  • Chaque événement déclencheur majeur a au moins un plan avec une garde de contexte explicite.
  • La conception nomme où réside la politique SE, SO et SI.
  • Les chemins d'échec créent des événements ou des plans de récupération au lieu d'un effondrement silencieux.
  • Un réviseur peut inspecter les intentions actives et expliquer pourquoi un plan a été sélectionné plutôt qu'un autre.

Shibboleths

  • Si quelqu'un ne peut pas expliquer la différence entre un objectif que l'agent veut et une intention à laquelle il s'est engagé, il n'a pas intériorisé le modèle.
  • Si la "stratégie" change nécessite de réécrire les corps de plan, la politique et la connaissance n'ont jamais été séparées.
  • Si l'agent ne peut pas dire ce qui l'a interrompu et ce qu'il reprendra ensuite, il n'utilise pas vraiment de piles d'intentions.

Références

  • references/bdi-architecture-for-agent-orchestration.md : chargez pour le cycle complet de l'agent et l'interaction B/D/I.
  • references/context-sensitive-plans-as-agent-knowledge.md : chargez lorsque la structure du plan et la conception des gardes sont le problème principal.
  • references/selection-functions-as-agent-policy.md : chargez lorsque la priorité, l'équité ou la tolérance au risque nécessitent un traitement politique explicite.
  • references/intention-management-and-goal-decomposition.md : chargez lorsque la suspension/reprise, les sous-objectifs ou l'auditabilité des intentions sont centraux.
  • references/failure-modes-in-bdi-systems.md : chargez lorsque la conception actuelle existe déjà et que vous déboguez des pannes.

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

Logic-based agent programming language implementing BDI architecture for practical autonomous agent development

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.

Skills associés