skills/bdi-agents-a-soft-model-for-organisation/SKILL.md
Model organizations as BDI systems with filtered perception, discourse-shaped desires, accommodations, and abstraction-level hierarchy. Use for socio-technical coordination and organizational modeling. NOT for mechanistic workflows, individual psychology, or non-social domains.
npx skillsauth add curiositech/windags-skills bdi-agents-a-soft-model-for-organisationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use this skill when the challenge is to model how messy organizations actually decide, coordinate, and resist change without pretending they are either fully rational machines or unknowable social fog.
You can model individuals, a recurring process, or the organization itself as the agent. The right level depends on what you need to explain, not on which level feels most intuitive.
Intentions are commitments that reduce future reconsideration. In organizations, that explains both useful focus and costly inertia.
Different roles, expertise, and incentives produce different organizational realities. Do not assume a shared objective world state just because everyone sees the same dashboard.
Organizational goals often come out of negotiation, rhetoric, and power, not from simple aggregation of individual preferences.
Coordination frequently happens through workable accommodations while disagreement persists. Designs that demand full agreement before action often misread how organizations function.
flowchart TD
A[Need organizational model] --> B{What must be explained?}
B -->|Specific actor choices| C[Model individuals or teams]
B -->|Recurring coordination pattern| D[Model the process as an agent]
B -->|Culture, identity, or strategic drift| E[Model the organization as an agent]
C --> F{Main coordination issue}
D --> F
E --> F
F -->|Different perceptions| G[Model filtered beliefs]
F -->|Conflicting priorities| H[Model discourse-driven desire formation]
F -->|Action despite disagreement| I[Design for accommodation, not consensus]
F -->|Hierarchy friction| J[Model abstraction-level boundaries]
Cue: the model treats disagreement as a temporary obstacle that must disappear before action can happen.
Fix: model accommodations and partial alignment explicitly.
Cue: the design assumes all participants observe the same facts and only differ in preferences.
Fix: give roles their own filtered belief models.
Cue: goals are treated as pre-existing values rather than outputs of negotiation and discourse.
Fix: include the goal-formation process in the model.
Cue: a process problem is analyzed only at the individual level, or a person-level conflict is forced into organization-level abstractions.
Fix: shift levels intentionally and compare what each view reveals.
Cue: a new platform is designed as if installing it will replace human cognition rather than support it.
Fix: treat technical systems as cognitive prosthetics that must fit existing organizational reasoning.
Marketing, legal, and engineering disagree on launch timing. The wrong move is to demand consensus on all facts. The right move is to map filtered perceptions, surface which desires emerge through stakeholder negotiation, and design an accommodation that permits action under persistent disagreement.
A company wants to automate incident routing. Model the process at the meso level to understand recurring coordination patterns, but drop to the team level where filtered perceptions and abstraction-level mismatch explain handoff failures.
references/soft-systems-cognitive-gap-formal-modeling.md: load when you need the high-level bridge between soft systems and BDI.references/intention-as-commitment-bounds-deliberation.md: load when inertia, commitment, or reconsideration are central.references/discourse-to-action-emergence-of-organizational-desires.md: load when organizational goals seem to be socially produced.references/accommodations-over-consensus-coordination-without-agreement.md: load when action happens despite unresolved conflict.references/hierarchies-abstraction-levels-expertise-coordination.md: load when hierarchy and abstraction mismatch are central to the failure.data-ai
license: Apache-2.0 NOT for unrelated tasks outside this domain.
development
Use when designing caching strategies (cache-aside, write-through, write-behind), implementing distributed locks, building rate limiters, leaderboards, real-time streams (XADD/consumer groups), pub/sub, or tuning eviction policies. Triggers: thundering-herd on cache miss, dogpile on key expiry, Redlock vs SET-NX-PX choice, sliding-window rate limiter, hot-key on a single cluster slot, big-key blowup, MULTI/EXEC across slots, KEYS in production. NOT for Redis Cluster operations/admin (different domain), embedded KV (SQLite, leveldb), in-process LRU caches, or Memcached.
tools
Drawing the `'use client'` boundary correctly in React Server Components apps (Next.js App Router, RSC frameworks) — leaf-pushing, slot composition, serialization rules, and environment poisoning prevention. Grounded in react.dev and Next.js 16 docs.
development
Use when designing rate limiting for an API, choosing between token bucket / sliding window / leaky bucket / fixed window, implementing it in Redis, deciding edge (Cloudflare/Upstash) vs origin enforcement, sizing per-user vs per-IP vs per-endpoint quotas, returning the right 429 response with Retry-After, or fixing the boundary-burst bug in fixed-window limiters. Triggers: 429 too many requests, INCR + EXPIRE, ZADD + ZREMRANGEBYSCORE + ZCARD, X-RateLimit-Remaining header, Cloudflare WAF rate limiting rules, Upstash @upstash/ratelimit, leaky bucket shaping vs policing, distributed rate limiter consistency. NOT for DDoS mitigation specifically (different scale), CAPTCHA / bot management, full WAF design, or per-user quota billing.