skills/resource-bounded-planning/SKILL.md
Frameworks for designing agents that must reason and act under time pressure, limited computational resources, and changing environments — based on Bratman, Israel, and Pollack's foundational BDI architecture
npx skillsauth add curiositech/windags-skills resource-bounded-planningInstall 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.
Design and implement agents that balance deliberation depth against execution urgency — making "good enough" decisions under time pressure while maintaining adaptability to change.
IF: Domain has recurring decisions + Time pressure exists + Information is incomplete
├─ High uncertainty about environment changes
│ └─ Commit to high-level structure only (defer implementation details)
├─ Moderate uncertainty with recurring patterns
│ └─ Commit to partial plan with 2-3 refinement checkpoints
└─ Low uncertainty with established patterns
└─ Commit to detailed plan with monitoring triggers
Cost-Benefit Formula: Commit when (Expected_Deliberation_Savings × Recurrence_Rate) > (Revision_Cost × Uncertainty_Factor)
IF: New incompatible option detected
├─ Expected value > Current plan value + (Override_threshold × Deliberation_cost)
│ └─ TRIGGER: Begin costly reconsideration
├─ Expected value > Current plan value but < Override threshold
│ └─ FILTER: Log opportunity but maintain current commitment
└─ Expected value ≤ Current plan value
└─ FILTER: Ignore option completely
Target Override Frequency: 10-20% of detected options (adjust threshold accordingly)
IF: Planning horizon analysis needed
├─ Execution time < 24 hours
│ └─ Specify to action level (full detail required)
├─ Execution time 1-30 days
│ └─ Specify to task level (keep method flexibility)
├─ Execution time > 30 days
│ └─ Specify to goal level only (maximum adaptability)
Refinement Trigger: When means-end coherence gap blocks next action OR dependency requires specification
IF: Agent coordination required
├─ Shared resource conflicts detected
│ └─ Negotiate commitment revision (cost = deliberation + coordination overhead)
├─ Goal conflicts detected but no resource overlap
│ └─ Maintain separate commitments with monitoring
└─ Complementary goals detected
└─ Establish consistency constraints (shared assumptions + checkpoint synchronization)
Consistency Check Frequency: Every N actions where N = 1/(Coordination_criticality × Change_rate)
Detection Rule: If deliberation time > 2× action time OR override frequency > 30% of options Symptoms: Constantly reconsidering plans, thrashing between options, missing deadlines Diagnosis: Override threshold too low, filter mechanism too weak Fix: Increase override threshold by 20-30%, strengthen filter criteria, set hard deliberation deadlines
Detection Rule: If plan execution fails due to assumption violations > 2× per planning cycle Symptoms: Missing significant opportunities, executing invalid plans, inflexible to change Diagnosis: Override threshold too high, monitoring inadequate Fix: Decrease override threshold by 15-25%, add assumption monitoring, implement adaptation triggers
Detection Rule: If plan details change > 40% before execution OR refinement cost > initial planning cost Symptoms: Wasted computation on obsolete details, reduced flexibility, high revision overhead Diagnosis: Committing to unnecessary detail too early Fix: Defer specification until means-end coherence requires OR execution approaches
Detection Rule: If coordination overhead > 25% of productive work time Symptoms: Agents constantly negotiating, inconsistent assumptions across agents, deadlock states Diagnosis: Consistency requirements too strict OR communication protocols inefficient Fix: Relax non-critical consistency constraints, implement local consistency checking, batch coordination updates
Detection Rule: If deliberation cost exceeds action value for same decision type > 3 consecutive times Symptoms: Over-analyzing low-stakes decisions, missing action windows, computational resource waste Diagnosis: Treating all decisions as equally important Fix: Implement decision importance classification, set deliberation budgets per decision class, use satisficing for low-stakes choices
Scenario: Three AI agents managing a data center during peak load. Agent A (scheduler), Agent B (resource allocator), Agent C (performance monitor). Sudden 300% traffic spike detected.
Novice Approach: Each agent recomputes optimal strategy independently
Expert Application:
Commitment Formation (T+2 seconds):
Consistency Check (T+3 seconds):
Execution with Refinement (T+4 to T+600):
Override Decision (T+300):
Measurable Outcomes:
Scenario: AI coding assistant planning implementation of new feature. Requirements partially specified, 2-week deadline, dependencies uncertain.
Trade-off Analysis:
Option 1: Fully specify all implementation details upfront
Option 2: Commit only to architecture, defer all implementation
Expert Choice - Option 3: Structural partiality with refinement triggers
Execution:
T+0: Form partial plan (4 hours)
T+3 days: First refinement trigger
T+8 days: Performance monitoring trigger
Quality Results:
Planning Quality Checklist:
Execution Quality Checklist:
Calibration Quality Indicators:
This skill is NOT for:
Delegate to other skills when:
Warning signs you're misapplying this skill:
tools
Building resilient distributed systems with circuit breakers, retries with full-jitter exponential backoff, retry budgets (per-request 3-attempt + per-client 10% ratio per Google SRE), deadline propagation, and the cascading-failure math (4 layers × 3 retries = 64x amplification). Grounded in Resilience4j, Microsoft Cloud Patterns, AWS Architecture Blog (Marc Brooker), and Google SRE Book.
testing
Designing HTTP cache headers that work correctly across browsers, CDNs, and shared proxies — `Cache-Control` directives per RFC 9111, `stale-while-revalidate` and `stale-if-error` per RFC 5861, the Vary header for varying responses, and surrogate keys for tag-based purging. Grounded in IETF RFCs and Cloudflare/Fastly docs.
development
Use when designing or fixing a Content Security Policy on a real site, choosing between nonce-based and hash-based CSP, adding strict-dynamic, debugging "Refused to execute inline script" errors, deploying CSP in report-only mode first, configuring report-to / report-uri, or auditing an existing policy for unsafe-inline / unsafe-eval / wildcards. Triggers: "CSP blocks legitimate inline script", strict-dynamic, nonce-{RANDOM}, sha256-{HASH}, object-src none, base-uri none, frame-ancestors, Trusted Types, X-Content-Security-Policy obsolete, report-only vs enforced. NOT for general HTTP security headers (HSTS, COOP/COEP), Trusted Types deep dive, CORS configuration, or building a WAF.
tools
Choosing and operating an HTTP API versioning strategy that doesn't break clients — Stripe's date-based pinned versions, the Deprecation/Sunset header pair (RFC 9745 + RFC 8594), URI vs header vs media-type approaches, and the version-transformer pattern. Grounded in Stripe's published architecture and IETF RFCs.