Communitygithub.com

curiositech/windags-skills

BDI 아키텍처를 구현한 논리 기반 에이전트 프로그래밍 언어로, 실용적인 자율 에이전트 개발을 지원합니다.

windags-skills란 무엇인가요?

이 스킬은 AgentSpeak(L) 및 BDI (Belief-Desire-Intention) 에이전트 아키텍처를 설명합니다. BDI는 동적 환경에서 반응성과 목표 지속성을 동시에 요구하는 자율 에이전트를 구축하기 위한 아키텍처 패턴입니다. 단순 이벤트-반응 시스템, 고전적 플래너 또는 중앙 집중형 워크플로우와 달리, BDI는 에이전트가 복수의 의도를 동시에 유지하고, 이벤트 우선순위에 따라 스케줄링하며, 오류 발생 시 복구 계획을 실행할 수 있도록 설계되었습니다. 이 스킬의 핵심은 세 가지 선택 함수(SE: 이벤트 선택, SO: 옵션 선택, SI: 의도 선택)를 명시적으로 정의하여 에이전트의 합리성을 인코딩하는 것입니다. 또한, 계획 쓰래싱, 오래된 믿음으로 인한 마비, 무한 의도 루프 등 일반적인 BDI 구현 오류와 해결 방법을 제시합니다. 실제 예제로는 다중 에이전트 협업(작업 할당)과 인터럽트 처리(긴급 알림 중 장기 실행 작업 일시 중단)를 다룹니다. 이 스킬은 Claude Code, Cursor, Codex 등 markdown 기반 스킬 파일을 지원하는 모든 AI 에이전트 플랫폼에서 사용할 수 있습니다. 주요 용도는 문서를 통한 BDI 아키텍처 튜토리얼 제공이며, 개발자가 자율 에이전트 시스템을 설계할 때 참조 패턴을 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/agentspeak-bdi

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

SKILL.md — AgentSpeak(L) 및 BDI 에이전트 아키텍처

자율 개체가 진행 중인 작업을 포기하지 않고 경쟁 목표를 관리하며 이벤트에 대응하면서 인식, 숙고, 행동해야 할 때.


의사 결정 포인트

기본 아키텍처 선택

IF 시스템이 지속적인 목표 없이 이벤트-반응만 필요한 경우
  → 반응형/규칙 시스템 사용 (BDI는 과잉)
ELIF 정적 환경에서 인터럽트 없이 계획만 필요한 경우  
  → 고전적 플래너 사용
ELIF 동적 환경에서 반응성과 목표 지속성 모두 필요한 경우
  → BDI 아키텍처 사용

선택 함수 호출 테이블

상황사용 함수결정 기준
새 이벤트 도착SE (이벤트 선택)우선순위, 긴급성, 리소스 제약
이벤트에 계획 필요SO (옵션 선택)컨텍스트 가드, 계획 성공 이력, 위험 허용 수준
여러 활성 의도SI (의도 선택)마감 시간, 리소스 할당, 공정성 정책
계획 실패 발생SO then SI실패 처리 계획 찾기, 의도 재스케줄링

계획 실패 복구 결정 트리

계획 P가 액션 A 실행 중 실패:
IF 이 실패 유형에 대한 실패 처리 계획이 존재하는 경우
  → 실패 이벤트 게시, SO가 복구 계획 선택하도록 함
  → 수정된 의도 스택으로 계속 진행
ELIF 동일한 트리거 이벤트에 대한 대체 계획이 존재하는 경우
  → 이벤트로 롤백, SO가 다음 적용 가능한 계획 시도하도록 함  
  → 실패한 계획은 고려 대상에서 제외
ELIF 대체 계획이 없는 경우
  → 의도 스택 위로 실패 전파
  → IF 상위 계획이 존재하는 경우 → 상위 수준에서 실패 이벤트 트리거
  → ELSE 의도 완전히 드롭

믿음 업데이트 영향 평가

새 믿음 B 도착:
IF B가 기존 믿음과 모순되는 경우
  → 믿음 수정 프로토콜 실행
  → 모든 활성 의도의 컨텍스트 가드 위반 여부 확인
  → IF 컨텍스트가 더 이상 유효하지 않은 경우 → 의도 일시 중단 (드롭하지 않음)
ELIF B가 새로운 적용 가능 계획을 활성화하는 경우
  → 이제 적용 가능한 계획이 있는 대기 이벤트를 이벤트 큐에서 확인
  → SE를 사용하여 재우선순위화
ELIF B가 보류 중인 목표 조건을 충족시키는 경우  
  → 달성 표시, 관련 의도 정리
  → 계획 정리를 위한 달성 이벤트 게시

실패 모드

1. 계획 쓰래싱

증상: 에이전트가 진전 없이 계획을 빠르게 순환함; 동일한 이벤트가 반복적으로 다른 계획을 트리거함. 감지 규칙: 동일한 이벤트가 N 실행 주기 내에 3회 이상 처리되고 매번 다른 계획이 선택되면 계획 쓰래싱입니다. 근본 원인: SO(옵션 선택) 함수가 비결정적이거나 컨텍스트 가드가 너무 약하거나 중복됨. 해결책: SO를 명시적으로 우선순위 순서로 정렬; 컨텍스트 가드를 상호 배타적으로 강화; 선택 기준에 계획 성공/실패 이력 추가.

2. 오래된 믿음으로 인한 마비

증상: 에이전트가 오래된 세계 모델을 기반으로 계획을 선택함; 환경에 대한 잘못된 가정으로 인해 계획이 즉시 실패함. 감지 규칙: 계획 실패율이 50%를 초과하고 실패가 (계획 시간이 아닌) 실행 시간의 컨텍스트 가드 위반으로 인한 경우, 오래된 믿음이 있습니다. 근본 원인: 환경 변화율에 비해 믿음 업데이트 빈도가 너무 낮음; 믿음 수정이 의도 컨텍스트 검사로 전파되지 않음. 해결책: 인식 주기 증가; 믿음 오래됨 타임스탬프 추가; 컨텍스트 가드가 유효하지 않게 될 때 의도 일시 중단.

3. 무한 의도 루프

증상: 에이전트가 동일한 목표에 대해 더 많은 의도를 생성하는 이벤트를 게시하는 의도를 생성함; 의도 스택이 제한 없이 증가함. 감지 규칙: 의도 스택 깊이가 시간이 지남에 따라 단조롭게 증가하고 해당 목표 달성이 없으면 의도 루프입니다. 근본 원인: 계획이 종료 조건 없이 결국 원래 목표로 되돌아오는 하위 목표를 생성함. 해결책: 컨텍스트 가드에 달성 감지 추가; 의도 포함(중복 의도 병합) 구현; 최대 재귀 깊이 제한 추가.

4. 계획 내 정책 안티패턴

증상: 동일한 이벤트가 계획 본문 내 조건문에 따라 다른 동작을 트리거함; 에이전트 정책이 분산되어 변경하기 어려움. 감지 규칙: 계획 본문에 우선순위/긴급성 조건문(if high_priority then X else Y)이 포함되어 있으면 정책이 잘못된 위치에 있습니다. 근본 원인: 에이전트 합리성이 선택 함수 대신 계획 로직에 인코딩됨. 해결책: 모든 우선순위/정책 로직을 SE/SO/SI 함수로 이동; 계획을 정책 중립적이고 컨텍스트에만 민감하게 만듦.

5. 단일 의도 병목

증상: 에이전트가 인터럽트를 처리할 수 없음; 긴급 이벤트가 장기 실행 작업이 완료될 때까지 대기함; 동시성 없음. 감지 규칙: 에이전트가 항상 최대 하나의 활성 의도를 가지면 단일 의도 병목입니다. 근본 원인: SI(의도 스케줄링) 함수가 진정한 동시성을 구현하지 않음; 의도를 동시적이 아닌 배타적으로 취급. 해결책: 여러 활성 의도 허용; SI에서 선점형 스케줄링 구현; 계획을 인터럽트 가능한 시퀀스로 설계.


실제 예제

예제 1: 계획 충돌이 있는 다중 에이전트 작업 할당

시나리오: 두 에이전트(A1, A2)가 deliver(package, destination)을 달성하기 위해 협력합니다. 둘 다 계획을 가지고 있지만 능력이 다릅니다.

초기 상태:

  • A1 믿음: location(A1, warehouse), can_carry(A1, small_items), location(package, warehouse)
  • A2 믿음: location(A2, depot), can_carry(A2, any), has_vehicle(A2)
  • 공유 믿음: size(package, large), destination(customer_site)

이벤트: +!deliver(package, customer_site)가 두 에이전트에 게시됨

결정 과정:

  1. A1 계획 선택 (SO):

    • 계획 P1: +!deliver(X,Y) : can_carry(A1,small_items) & size(X,small) <- pickup(X); transport(X,Y)
    • 컨텍스트 가드 실패: size(package,large)가 size(X,small)와 모순됨
    • 적용 가능한 계획 없음 → plan_failure(deliver, no_capability) 게시
  2. A2 계획 선택 (SO):

    • 계획 P2: +!deliver(X,Y) : can_carry(A2,any) & has_vehicle(A2) <- pickup(X); drive(X,Y); dropoff(X)
    • 컨텍스트 가드 성공 → P2 선택
    • 의도 I1 생성: [pickup(package), drive(package,customer_site), dropoff(package)]
  3. A1 믿음 업데이트:

    • 메시지 수신: attempting(A2, deliver, package)
    • 믿음 업데이트: +delegated(deliver, package, A2)
    • 실패한 의도 드롭

초보자 오류: 두 에이전트가 모두 배달을 시도하여 리소스 충돌이 발생했을 것입니다. 전문가 통찰: 조정은 하드코딩된 에이전트 지식이 아닌 믿음 공유와 계획 컨텍스트 가드를 통해 이루어집니다.

예제 2: 의도 재고를 통한 인터럽트 처리

시나리오: 장기 실행 데이터 처리 작업을 실행 중인 에이전트가 긴급 보안 경보를 수신합니다.

초기 상태:

  • 활성 의도 I1: [process_batch(data1), process_batch(data2), generate_report()]
  • 현재 실행: process_batch(data1) 중간 (앞으로 10분 더 소요)

이벤트: +security_alert(intrusion_detected, server_3)

결정 과정:

  1. 이벤트 선택 (SE):

    • SE 우선순위: security_events > routine_processing
    • security_alert이 I1 계속 실행보다 선택됨
  2. 계획 선택 (SO):

    • 계획 P3: +security_alert(Type,Location) : has_admin_access <- isolate_system(Location); notify_team(Type)
    • 컨텍스트 가드 충족 → P3 선택
    • 의도 I2 생성: [isolate_system(server_3), notify_team(intrusion_detected)]
  3. 의도 스케줄링 (SI):

    • 현재 의도: I1 (process_batch(data1)에서 일시 중단됨), I2 (새롭고 긴급)
    • SI 정책: 보안 의도가 처리 의도를 선점함
    • 실행을 위해 I2 선택
  4. 실행:

    • isolate_system(server_3) 즉시 실행
    • notify_team(intrusion_detected) 실행
    • I2 완료, 의도 집합에서 드롭
  5. 재개:

    • I1만 남음: [process_batch(data1), process_batch(data2), generate_report()]
    • 일시 중단 지점에서 process_batch(data1) 재개

초보자 오류: 보안 경보를 무시하거나 처리 작업을 완전히 포기했을 것입니다. 전문가 통찰: 의도 일시 중단은 반응형 동작을 가능하게 하면서 진행 상황을 보존합니다. SI 스케줄링 정책은 명시적이고 구성 가능합니다.


품질 관문

  • 에이전트 아키텍처에 문서화된 정책이 있는 명시적인 SE, SO, SI 선택 함수가 있음
  • 각 계획에 현재 믿음에 대해 평가할 수 있는 명확한 트리거 이벤트와 컨텍스트 가드가 정의되어 있음
  • 계획 라이브러리에 각 주요 계획 유형에 대한 실패 처리 계획이 포함되어 있음 (성공 경로만이 아님)
  • 믿음 업데이트 메커니즘이 모순된 정보를 처리하고 변경 사항을 활성 의도에 전파할 수 있음
  • 여러 의도가 명확한 스케줄링/선점 규칙으로 동시에 활성화될 수 있음
  • 이벤트 큐 처리가 명시적인 우선순위 할당으로 우선순위가 지정됨 (FIFO 아님)
  • 계획 실패가 시스템 충돌이나 조용한 실패가 아닌 이벤트를 트리거함
  • 컨텍스트 가드가 상호 배타적이거나 계획 선택이 비결정성을 피하기 위해 명시적으로 정렬됨
  • 에이전트가 의도 스택과 트리거 이벤트를 노출하여 자신의 행동을 설명할 수 있음
  • 높은 이벤트 부하에서 시스템 성능이 우아하게 저하됨 (무한 루프나 스택 오버플로 없음)

NOT-FOR 경계

적용 불가: 모든 동작이 반응형인 단순 규칙 기반 시스템 (지속적인 목표 없음) → 대신 사용: 기본 규칙 엔진 또는 이벤트-액션 시스템

적용 불가: 실행 중 환경이 변하지 않는 정적 계획 문제
→ 대신 사용: 고전적 플래너 (A*, STRIPS, HTN)

적용 불가: 보장된 응답 시간이나 엄격한 마감 시간이 필요한 실시간 시스템 → 대신 사용: 타이밍 분석이 포함된 실시간 스케줄링 시스템

적용 불가: 모든 조정을 중앙 컨트롤러로 처리할 수 있는 시스템 → 대신 사용: 워크플로우 오케스트레이션 또는 중앙 집중형 작업 큐잉

적용 불가: 자율적인 의사 결정이 없는 순수 데이터 변환 파이프라인 → 대신 사용: ETL 도구, 스트림 처리 프레임워크

적용 불가: 기본 기능으로 기계 학습이나 통계적 추론이 필요한 애플리케이션 → 대신 사용: 필요한 경우 BDI를 조정 계층으로 사용하는 ML 프레임워크

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.

관련 스킬