Communitygithub.com

AgentSpeak(L) y Arquitectura BDI

Lenguaje de programación de agentes basado en lógica que implementa la arquitectura BDI para el desarrollo práctico de agentes autónomos.

¿Qué es AgentSpeak(L) y Arquitectura BDI?

Este skill presenta AgentSpeak(L) y la arquitectura BDI (Creencias-Deseos-Intenciones) como un enfoque robusto para construir agentes autónomos que deben percibir, deliberar y actuar en entornos dinámicos mientras manejan metas en competencia y responden a eventos sin abandonar el trabajo en curso. A diferencia de los sistemas reactivos simples o los planificadores clásicos, BDI combina reactividad con persistencia de metas, permitiendo que los agentes manejen interrupciones y planes fallidos. El documento detalla las funciones de selección (SE, SO, SI) que gobiernan el comportamiento del agente, modos de fallo comunes como el thrashing de planes o la parálisis por creencias obsoletas, y proporciona ejemplos trabajados de coordinación multi-agente y manejo de interrupciones. Es especialmente útil para desarrolladores que construyen sistemas multi-agente, robótica autónoma o simulaciones donde los agentes necesitan adaptarse a cambios imprevistos sin intervención humana.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

SKILL.md — AgentSpeak(L) y Arquitectura BDI

Cuando las entidades autónomas deben percibir, deliberar y actuar mientras gestionan metas en competencia y responden a eventos sin abandonar el trabajo en curso.


Puntos de Decisión

Selección de Arquitectura Principal

SI el sistema solo necesita reacción a eventos sin metas persistentes
  → Usar sistema reactivo/de reglas (BDI es excesivo)
SINO SI el sistema necesita planificación en entorno estático sin interrupciones
  → Usar planificador clásico
SINO SI el sistema necesita tanto reactividad COMO persistencia de metas en entorno dinámico
  → Usar arquitectura BDI

Tabla de Invocación de Funciones de Selección

SituaciónFunción UsadaCriterios de Decisión
Nuevo evento llegaSE (Selección de Eventos)Prioridad, urgencia, restricciones de recursos
Evento necesita planSO (Selección de Opciones)Guardas de contexto, historial de éxito del plan, tolerancia al riesgo
Múltiples intenciones activasSI (Selección de Intenciones)Plazos, asignación de recursos, política de equidad
Fallo de plan ocurreSO luego SIEncontrar plan de manejo de fallo, luego reprogramar intenciones

Árbol de Decisión para Recuperación de Fallos de Plan

El plan P falla al ejecutar la acción A:
SI existe un plan de manejo de fallo para este tipo de fallo
  → Publicar evento de fallo, dejar que SO seleccione el plan de recuperación
  → Continuar con la pila de intenciones modificada
SINO SI existen planes alternativos para el mismo evento desencadenante
  → Retroceder al evento, dejar que SO intente el siguiente plan aplicable
  → Eliminar el plan fallido de la consideración
SINO no hay alternativas disponibles
  → Propagar el fallo hacia arriba en la pila de intenciones
  → SI existe un plan padre → desencadenar evento de fallo a nivel del padre
  → SINO abandonar la intención por completo

Evaluación del Impacto de Actualización de Creencias

Llega una nueva creencia B:
SI B contradice creencias existentes
  → Ejecutar protocolo de revisión de creencias
  → Verificar todas las intenciones activas por violaciones de guardas de contexto
  → SI el contexto ya no se cumple → suspender la intención (no abandonar)
SINO SI B habilita nuevos planes aplicables
  → Verificar la cola de eventos en busca de eventos inactivos que ahora tengan planes aplicables
  → Repriorizar usando SE
SINO SI B satisface condiciones de meta pendientes
  → Marcar logro, limpiar intenciones relacionadas
  → Publicar evento de logro para limpieza de planes

Modos de Fallo

1. Thrashing de Planes

Síntomas: El agente cicla rápidamente entre planes sin progresar; el mismo evento desencadena diferentes planes repetidamente. Regla de Detección: Si el mismo evento se procesa >3 veces en N ciclos de ejecución con diferentes selecciones de plan cada vez, tienes thrashing de planes. Causa Raíz: La función SO (selección de opciones) es no determinista o las guardas de contexto son demasiado débiles/superpuestas. Solución: Hacer que SO esté explícitamente ordenado por prioridad; fortalecer las guardas de contexto para que sean mutuamente excluyentes; agregar historial de éxito/fallo de planes a los criterios de selección.

2. Parálisis por Creencias Obsoletas

Síntomas: El agente selecciona planes basados en un modelo del mundo desactualizado; los planes fallan inmediatamente debido a suposiciones falsas sobre el entorno. Regla de Detección: Si la tasa de fallo de planes >50% y los fallos se deben a violaciones de guardas de contexto en tiempo de ejecución (no en tiempo de planificación), tienes creencias obsoletas. Causa Raíz: La frecuencia de actualización de creencias es demasiado baja en relación con la tasa de cambio del entorno; la revisión de creencias no se propaga a las comprobaciones de contexto de las intenciones. Solución: Aumentar la frecuencia de percepción; agregar marcas de tiempo de obsolescencia de creencias; suspender intenciones cuando sus guardas de contexto se vuelvan inválidas.

3. Bucles Infinitos de Intenciones

Síntomas: El agente crea intenciones que publican eventos que crean más intenciones para la misma meta; la pila de intenciones crece sin límite. Regla de Detección: Si la profundidad de la pila de intenciones aumenta monótonamente con el tiempo sin logros de meta correspondientes, tienes bucles de intenciones. Causa Raíz: Los planes crean submetas que eventualmente llevan de vuelta a la meta original sin condiciones de terminación. Solución: Agregar detección de logros en las guardas de contexto; implementar subsumción de intenciones (fusionar intenciones duplicadas); agregar límites máximos de profundidad de recursión.

4. Antipatrón de Política en Planes

Síntomas: Mismos eventos desencadenan diferentes comportamientos basados en condicionales dentro de los cuerpos de los planes; la política del agente está dispersa y es difícil de cambiar. Regla de Detección: Si los cuerpos de los planes contienen condicionales de prioridad/urgencia (if alta_prioridad then X else Y), la política está en el lugar equivocado. Causa Raíz: La racionalidad del agente está codificada en la lógica del plan en lugar de en las funciones de selección. Solución: Mover toda la lógica de prioridad/política a las funciones SE/SO/SI; hacer que los planes sean neutrales en cuanto a política y solo sensibles al contexto.

5. Cuello de Botella de Intención Única

Síntomas: El agente no puede manejar interrupciones; los eventos urgentes esperan mientras el agente completa tareas de larga duración; no hay concurrencia. Regla de Detección: Si el agente tiene como máximo una intención activa en cualquier momento, tienes cuello de botella de intención única. Causa Raíz: La función SI (programación de intenciones) no implementa verdadera concurrencia; trata las intenciones como exclusivas en lugar de concurrentes. Solución: Permitir múltiples intenciones activas; implementar programación preventiva en SI; diseñar planes como secuencias interrumpibles.


Ejemplos Trabajados

Ejemplo 1: Asignación de Tareas Multi-Agente con Conflictos de Planes

Escenario: Dos agentes (A1, A2) coordinan para lograr entregar(paquete, destino). Ambos tienen planes pero diferentes capacidades.

Estado Inicial:

  • Creencias de A1: ubicacion(A1, almacen), puede_cargar(A1, objetos_pequenos), ubicacion(paquete, almacen)
  • Creencias de A2: ubicacion(A2, deposito), puede_cargar(A2, cualquier), tiene_vehiculo(A2)
  • Creencia compartida: tamano(paquete, grande), destino(sitio_cliente)

Evento: +!entregar(paquete, sitio_cliente) publicado para ambos agentes

Proceso de Decisión:

  1. Selección de Plan de A1 (SO):

    • Plan P1: +!entregar(X,Y) : puede_cargar(A1,objetos_pequenos) & tamano(X,pequeno) <- recoger(X); transportar(X,Y)
    • Guarda de contexto falla: tamano(paquete, grande) contradice tamano(X, pequeno)
    • No hay planes aplicables → publica fallo_plan(entregar, sin_capacidad)
  2. Selección de Plan de A2 (SO):

    • Plan P2: +!entregar(X,Y) : puede_cargar(A2,cualquier) & tiene_vehiculo(A2) <- recoger(X); conducir(X,Y); dejar(X)
    • Guarda de contexto tiene éxito → P2 seleccionado
    • Crea intención I1: [recoger(paquete), conducir(paquete,sitio_cliente), dejar(paquete)]
  3. Actualización de Creencias de A1:

    • Recibe mensaje: intentando(A2, entregar, paquete)
    • Actualiza creencias: +delegado(entregar, paquete, A2)
    • Abandona la intención fallida

Error de Novato: Ambos agentes intentarían la entrega, creando conflictos de recursos. Perspectiva Experta: La coordinación ocurre a través del intercambio de creencias y las guardas de contexto de los planes, no mediante conocimiento del agente codificado.

Ejemplo 2: Manejo de Interrupciones con Reconsideración de Intenciones

Escenario: Agente que ejecuta una tarea de procesamiento de datos de larga duración recibe una alerta de seguridad urgente.

Estado Inicial:

  • Intención activa I1: [procesar_lote(datos1), procesar_lote(datos2), generar_reporte()]
  • Ejecución actual: en medio de procesar_lote(datos1) (tomará 10 minutos más)

Evento: +alerta_seguridad(intrusion_detectada, servidor_3)

Proceso de Decisión:

  1. Selección de Eventos (SE):

    • Prioridades de SE: eventos_de_seguridad > procesamiento_rutinario
    • alerta_seguridad seleccionada sobre continuar con I1
  2. Selección de Plan (SO):

    • Plan P3: +alerta_seguridad(Tipo,Ubicacion) : tiene_acceso_admin <- aislar_sistema(Ubicacion); notificar_equipo(Tipo)
    • Guarda de contexto satisfecha → P3 seleccionado
    • Crea intención I2: [aislar_sistema(servidor_3), notificar_equipo(intrusion_detectada)]
  3. Programación de Intenciones (SI):

    • Intenciones actuales: I1 (suspendida en procesar_lote(datos1)), I2 (nueva, urgente)
    • Política de SI: las intenciones de seguridad se adelantan a las intenciones de procesamiento
    • Selecciona I2 para ejecución
  4. Ejecución:

    • Ejecuta aislar_sistema(servidor_3) inmediatamente
    • Ejecuta notificar_equipo(intrusion_detectada)
    • I2 completa, se elimina del conjunto de intenciones
  5. Reanudación:

    • Solo queda I1: [procesar_lote(datos1), procesar_lote(datos2), generar_reporte()]
    • Reanuda procesar_lote(datos1) desde el punto de suspensión

Error de Novato: Ignoraría la alerta de seguridad o abandonaría la tarea de procesamiento por completo. Perspectiva Experta: La suspensión de intenciones preserva el progreso mientras permite un comportamiento receptivo. La política de programación SI es explícita y configurable.


Puertas de Calidad

  • La arquitectura del agente tiene funciones de selección SE, SO, SI explícitas con políticas documentadas
  • Cada plan tiene un evento desencadenante y una guarda de contexto bien definidos que pueden evaluarse frente a las creencias actuales
  • La biblioteca de planes incluye planes de manejo de fallos para cada tipo de plan principal (no solo caminos de éxito)
  • El mecanismo de actualización de creencias puede manejar información contradictoria y propagar cambios a las intenciones activas
  • Múltiples intenciones pueden estar activas concurrentemente con reglas claras de programación/prelación
  • El procesamiento de la cola de eventos está priorizado (no FIFO) con asignación explícita de prioridad
  • El fallo de un plan desencadena eventos en lugar de fallos del sistema o fallos silenciosos
  • Las guardas de contexto son mutuamente excluyentes O la selección de planes está explícitamente ordenada para evitar no determinismo
  • El agente puede explicar sus acciones exponiendo la pila de intenciones y los eventos desencadenantes
  • El rendimiento del sistema se degrada correctamente bajo alta carga de eventos (sin bucles infinitos ni desbordamiento de pila)

Límites NO-APROPIADO

NO APROPIADO PARA: Sistemas simples basados en reglas donde todo el comportamiento es reactivo (sin metas persistentes) → USAR EN SU LUGAR: Motor de reglas básico o sistema evento-acción

NO APROPIADO PARA: Problemas de planificación estática donde el entorno no cambia durante la ejecución → USAR EN SU LUGAR: Planificadores clásicos (A*, STRIPS, HTN)

NO APROPIADO PARA: Sistemas en tiempo real que requieren tiempos de respuesta garantizados o plazos estrictos → USAR EN SU LUGAR: Sistemas de programación en tiempo real con análisis de temporización

NO APROPIADO PARA: Sistemas donde toda la coordinación puede ser manejada por un controlador central → USAR EN SU LUGAR: Orquestación de flujos de trabajo o cola de tareas centralizada

NO APROPIADO PARA: Tuberías de transformación de datos puras sin toma de decisiones autónoma → USAR EN SU LUGAR: Herramientas ETL, marcos de procesamiento de flujos

NO APROPIADO PARA: Aplicaciones que requieren aprendizaje automático o inferencia estadística como capacidad principal → USAR EN SU LUGAR: Marcos de ML con BDI como capa de coordinación si es necesario

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.

Skills relacionados