The following table lists common failure modes, their causes, and recommended actions:
Issue Cause Action
Startup failure due to prompt budget Aggregate size exceeds the configured guard Remove or shrink prompts. Split large documents.
Tool hidden Missing scope Adjust token scopes or update configuration mapping.
Empty prompt plan --no-prompt flag used or directory empty Add prompts or omit the --no-prompt flag.
Selection returns empty set Over-restrictive filters Loosen filter criteria or inspect filenames.
For details on how prompt scopes and context enrichment interact during discovery, see OpenAPI visibility and context management.