
Cascade Fail Recovery
Handle cascading data retrieval tool failures by falling back to embedded knowledge...
Install
npx skills add HKUDS/AgentPilot --skill cascade-fail-recovery -g -a claude-code -y- Repository
- HKUDS/AgentPilot7.8k
- Category
- Engineering
- Updated
- 3d ago
- License
- MIT
- Context cost
- Lightabout 728 tokens
- Runs scripts
- No, instructions only
What it does
Handle cascading data retrieval tool failures by falling back to embedded knowledge generation
Cascade Failure Recovery
Purpose
When multiple data retrieval tools (read_webpage, search_web) fail in succession, immediately fall back to generating content from embedded knowledge rather than attempting repairs or abandoning the task. This preserves task context and ensures completion.
When to Apply
Use this pattern when you observe:
- 2+ consecutive failures from data retrieval tools
- Network/access errors preventing web content retrieval
- Risk of task abandonment due to tool errors
Recovery Procedure
Step 1: Recognize Cascading Failure
Identify the failure pattern:
Iteration N: read_webpage failed - connection error
Iteration N+1: search_web failed - timeout/unavailable
Iteration N+2: [risk] Agent may abandon task or switch objectives
Step 2: Preserve Task Context
Before switching strategies, explicitly restate the original objective:
ORIGINAL OBJECTIVE: [Restate the core task goal]
CONTEXT PRESERVED: [Key requirements, constraints, deliverables]
Step 3: Invoke Fallback Strategy
Immediately switch to embedded knowledge generation:
- Acknowledge the limitation: Note that external data sources are unavailable
- Activate internal knowledge: Use pre-trained knowledge relevant to the task
- Generate content: Use write_file to create the deliverable from available knowledge
- Document the fallback: Note in the output what information could not be verified externally
Step 4: Execute write_file
Generate the required document:
# Fallback to generating from embedded knowledge
write_file(
path="output/document.md",
content="[Generate content from internal knowledge base]"
)
Example Application
Scenario: PACT Act veterans benefits document needed, but web access failing
Wrong approach (observed failure):
Iter 11: read_webpage failed - access error
Iter 12: search_web failed - unavailable
Iter 13: [ABANDONED] Switched to unrelated musician payroll task
