Communitygithub.com

規範的BDIエージェントアーキテクチャ

自律システムにおいて、義務・禁止・ポリシーが衝突した際に、規範を検出し、どのコミットメントを内面化するかを選択し、結果を比較して衝突を解決する規範的BDI推論を適用します。

規範的BDIエージェントアーキテクチャ とは?

このスキルは、複数の規範(ルール、義務、禁止、ステークホルダーの要求)が同時に満たせない状況で、エージェントが規範を認識し、それを採用するかどうかを選択し、意図的な違反を説明できるようにするためのノーマティブBDIエージェントアーキテクチャを提供します。Claude Code、Cursor、CodexなどのBDIアーキテクチャを採用するAIエージェント向けに設計されており、固定優先順位リストや純粋な制約充足では対応できない複雑な規範的ジレンマを解決します。このアーキテクチャは、規範の認識と採用を分離し、3種類の一貫性状態(強い不一致、弱い整合性、強い整合性)を区別し、最悪の結果に基づいてコミットメントの束を比較することで衝突を解決します。これにより、エージェントは意図的で説明可能な違反を実行できるようになります。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/a-normative-extension-for-the-bdi-agent

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

規範的BDIエージェントアーキテクチャ は何をしますか?

このスキルは、エージェントが複数の規範を認識し、どれを行動に採用するかを決定し、意図的な違反が代替案よりも悪くない理由を説明する必要がある場合に使用します。

使用すべき状況

  • 複数のルール、義務、禁止、またはステークホルダーの要求をすべて同時に満たせない場合。
  • エージェントが、規範が存在することを知っていることと、実際にそれに従うことを選択することとを区別する必要がある場合。
  • システムが、あるルールに違反してでも、より重要度の高い別のコミットメントを満たした理由を正当化する必要がある場合。
  • 脆弱なハードコードされた優先順位リストに代わる、結果ベースの代替手段が必要な場合。
  • BDIアーキテクチャが、規範を絶対的なオーバーライドにせずに、規範的推論を統合するための原則的な方法を必要とする場合。

対象外の境界

このスキルは、以下のための主要なツールではありません:

  • コンテキストに応じて正しい優先順位が変わることがない、固定された優先順位階層。
  • 満足する解があれば十分であり、規範違反は対象外である純粋な制約充足。
  • 結果に関わらず、文字通りの非違反を要求する規制または倫理環境。
  • 信念、コミットメント、または意図的な違反の説明を維持しないおもちゃのルールエンジン。

中核となるメンタルモデル

認識は内面化ではない

抽象規範ベースを規範インスタンスベースから分離してください。エージェントは規範を採用せずに検出できます。この分離により、意図的で説明可能な非準拠が可能になり、偶発的な無知を防ぐことができます。

3つの一貫性状態

  • 強い不一致: 両方のコミットメントを満たす計画が全くない。
  • 弱い整合性: 一部の計画は機能するが、将来の柔軟性が低下する。
  • 強い整合性: 関連するすべての計画が互換性を維持する。

ほとんどの実際の設計判断は、弱い整合性のケースで行われます。

結果ランキング

規範が競合する場合は、コミットメントの首尾一貫した束を、最も悪い下流結果によって比較します。平均的な良さを最大化することではなく、互換性のない未来の中で最も悪くない最悪のケースを選択することです。

規範を仮説的欲求として

採用された義務と禁止は、別のオーバーライドシステムではなく、BDI機構内の反論可能な圧力になります。これにより、規範的推論が通常の目標追求と同じ熟議ループ内に維持されます。

決定ポイント

採用と競合のフローについては、diagrams/01_flowchart_decision-points.mdを参照してください。

flowchart TD
  A[Norm detected] --> B{Groundable in current beliefs?}
  B -->|No| C[Keep abstract and monitor]
  B -->|Yes| D[Check consistency]
  D -->|Strongly inconsistent| E[Compare conflict bundles by worst consequence]
  D -->|Weakly consistent| F[Evaluate flexibility cost]
  D -->|Strongly consistent| G[Adopt norm]
  E --> H[Choose least-bad worst case]
  F --> I{Adoption still worth it?}
  I -->|Yes| G
  I -->|No| J[Reject or defer]
  H --> G

1. 規範を採用するかどうかの決定

  • 新しい規範が現在のコミットメントと強い不一致がある場合、採用には何か他のものを放棄するか修正する必要があります。
  • 弱い整合性の場合は、採用する前に柔軟性のコストを明示的にしてください。
  • 強い整合性の場合は、採用は低リスクであり、通常は自動的に行うべきです。

2. 競合を解決する方法の決定

  • 規範を個別に比較するのではなく、最大の非競合サブセットを生成します。
  • 各サブセットの計画を構築し、各未来における最悪の結果を特定します。
  • 最悪のケースが最も悪くないサブセットを選択し、選択した違反の理由を記録します。

3. 抽象規範をインスタンス化するタイミングの決定

  • 現在の信念が変数をバインドし、アクティベーション条件を満たすことができる場合にのみインスタンス化します。
  • 知識が不完全な場合、未解決の規範を適用されないふりをするのではなく、可視化したままにしておきます。
  • 意味のある信念の更新後、保留中の抽象規範を再評価します。

障害モード

1. 過剰採用によるデッドロック

症状: エージェントが規範を内面化し続け、実行可能なアクションがなくなる。
検出ルール: 競合が解決されるよりも早くアクティブなアクションスペースが縮小する。
回復: 規範インスタンスベースに新しい規範が追加される前に、一貫性レビューを強制します。

2. 隠れた違反

症状: エージェントが規範に違反しているが、そうすることを選択したと述べることができない。
検出ルール: 事後的な説明で、拒否された規範が省略されるか、違反が存在しなかったかのように扱われる。
回復: 拒否されたが認識された規範を永続化し、勝利した結果比較をログに記録します。

3. バイナリ一貫性の崩壊

症状: 採用ロジックがすべての規範を完全に互換性があるか不可能かのいずれかとして扱う。
検出ルール: 弱い整合性がアーキテクチャまたはログにまったく現れない。
回復: 明示的な弱い整合性ブランチを追加し、柔軟性の損失を直接モデル化します。

4. 固定優先順位の脆弱性

症状: 同じグローバル優先順位スタックが、エッジケースで明らかに間違った選択を生み出す。
検出ルール: 競合の結果は、優先順位テーブルが変更された場合にのみ変化し、結果が変化した場合には変化しない。
回復: 固定された優先順位から、サブセット生成と結果ランキングに移行します。

5. 規範のサイドチャネルアーキテクチャ

症状: 規範処理は、実行後半でBDIの熟議をオーバーライドする別の強制モジュールに存在する。
検出ルール: 規範ロジックを信念、欲求、意図を使用して説明できない。
回復: 採用された規範を内部の熟議的圧力に変換し、メインアーキテクチャを経由させます。

実例

例1: プライバシー vs. パーソナライゼーション

サービスエージェントは、顧客レベルのデータを直接使用することを禁止する規範と、ユーザーエクスペリエンスを向上させる義務を認識しています。システムは弱い整合性を見つけ出します。集約された行動サマリーは、プライバシーの害を制限しながらほとんどのパーソナライゼーションを維持します。スキルは両方の規範を可視化し、集約安全な義務のみをインスタンス化し、直接データ使用がなぜ拒否されたかを記録します。

例2: ロボットと赤ちゃん

介護ロボットは、赤ちゃんを生かしておく義務と、人間に対する愛情を育むことへの禁止に直面します。両方を満たす計画はありません。スキルは2つの首尾一貫したサブセットを生成し、最悪の結果を比較し、設計上の禁止事項を意図的に違反します。なぜなら、死は禁じられた愛着よりも悪い結果だからです。違反は明示的であり、報告可能です。

品質ゲート

  • アーキテクチャは検出された規範と採用された規範を区別している。
  • 一貫性チェックには、強い不一致、弱い整合性、強い整合性が含まれている。
  • 競合解決は、孤立した規範のみではなく、首尾一貫したサブセットを比較している。
  • 選択された違反は、明示的な結果比較とともにログに記録されている。
  • 信念のグラウンディングが不完全な場合、抽象規範は保留状態を維持できる。

参照ファイル

ファイルロードするタイミング
references/separation-of-norm-recognition-and-norm-internalization.mdANBとNIBの境界を設計するとき
references/three-types-of-consistency-for-norm-adoption.md採用チェックと柔軟性コストロジックを実装するとき
references/normative-conflict-resolution-through-consequence-ranking.md結果ベースの競合解決を構築またはレビューするとき
references/norm-instantiation-through-belief-grounding.md抽象規範をコンテキスト固有のインスタンスにグラウンディングするとき
references/maximal-non-conflicting-subsets-for-action-selection.md競合下で首尾一貫したオプションの束を計算するとき
references/desire-internalization-as-norm-adoption-mechanism.md規範をBDIの欲求と意図の処理に統合するとき

アンチパターン

  • 単一の優先順位をハードコードして「倫理」と呼ぶこと。
  • 検出されたすべての規範を自動採用し、実行時にのみ矛盾を発見すること。
  • 弱い整合性を強い整合性と同じものとして扱うこと。
  • 壊滅的な最悪ケースを無視しながら、平均的な効用で違反を比較すること。

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

>- 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

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

関連スキル