skills/decision-models-some-lessons-from-the-fi/SKILL.md
Apply recognition-primed decision making to agents operating under time pressure, uncertainty, and ambiguous cues. Use for situation assessment, RPD-style action selection, and decision-support design in operational settings. NOT for batch optimization, static planning with full information, or tasks where exhaustive search is cheap and harmless.
npx skillsauth add curiositech/windags-skills decision-models-some-lessons-from-the-fiInstall 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 key question is how an agent should decide under operational pressure, not how to optimize a fully specified problem on paper.
This skill is not the primary tool for:
The hard problem is usually understanding what is happening, not ranking options. Once the situation is diagnosed correctly, the first workable action is often obvious.
Experts recognize a situation, generate one plausible action, mentally simulate it, and execute or modify it. They do not usually compare a menu of options in parallel.
In time-pressured environments, the first workable action can dominate the best late action. Seeking optimality when delay is costly creates its own failure mode.
The expertise is not mainly in knowing the consequent of a rule. It is in recognizing that the antecedent actually applies in the live situation.
Good support improves cues, anomaly detection, and expectancy tracking. Bad support forces experts into slower analytical rituals that strip context and degrade performance.
flowchart TD
A[Operational decision] --> B{Time pressure or ambiguity high?}
B -->|No| C[Conventional analysis may be fine]
B -->|Yes| D{Situation pattern recognized?}
D -->|No| E[Gather discriminating cues and reframe]
D -->|Yes| F[Generate first plausible action]
F --> G{Quick mental simulation workable?}
G -->|Yes| H[Execute with monitoring]
G -->|No| I[Modify action or surface next candidate]
I --> G
The architecture demands alternative generation and ranking before movement. Valuable time is spent on comparison instead of action or better diagnosis.
The team tunes action selection after a bad outcome, but the real problem was a wrong or incomplete reading of the situation.
The support tool asks experts to fill in rankings, probabilities, or exhaustive option sets when their natural advantage was rapid recognition plus simulation.
The system spends scarce time searching for the best action when the real requirement was a good-enough action now.
Teams keep refining action catalogs while leaving antecedent recognition weak. The system then fails in exactly the live contexts where expertise was supposed to help.
A responder agent sees a service outage, partial telemetry, and a rising customer impact signal. Instead of generating five recovery options and scoring each one, it classifies the event as a likely cascading dependency failure, simulates an isolation action, sees no obvious contradiction, and executes with a short checkpoint window. Speed comes from situation recognition, not from skipping thought.
A planner agent wants rollback while an infra agent wants scale-out. The right diagnostic is not "which action is better?" but "why are they reading different situations?" Once both agents align on the causal frame, the action disagreement collapses into a single workable next step.
| File | Load when... |
| --- | --- |
| references/rpd-recognition-primed-decisions-for-agents.md | You need the full recognition → simulation → modification loop for agent design. |
| references/situation-assessment-primacy.md | A failure analysis suggests the situation model, not the action policy, was wrong. |
| references/when-analytical-decision-tools-fail.md | You need to explain why formal analysis degrades performance in operational settings. |
| references/expertise-as-pattern-recognition-not-rules.md | You are deciding whether to improve rule catalogs or recognition mechanisms. |
| references/satisficing-over-optimizing-in-complex-domains.md | You need to defend workability over optimality as the correct decision standard. |
| references/decision-support-for-recognition-not-analysis.md | You are designing or critiquing decision-support tooling. |
You have internalized this skill if you naturally ask:
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.