iterative-retrieval

Iteratively refine search queries to retrieve relevant files for multi-agent codebase tasks.

Updated Jan 30, 2026
One-click install
npx skills add https://github.com/ThejanaJayalath/Niolla-PM-system --skill iterative-retrieval-thejanajayalath
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iterative-retrieval
Source: https://github.com/ThejanaJayalath/Niolla-PM-system/tree/main/.cursor/skills/iterative-retrieval
Command: npx skills add https://github.com/ThejanaJayalath/Niolla-PM-system --skill iterative-retrieval-thejanajayalath

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the context problem in multi-agent workflows where subagents lack the necessary codebase knowledge to perform tasks effectively, preventing failures caused by missing information or excessive token usage.

Core Features & Use Cases

  • Progressive Context Refinement: Uses a 4-phase loop (Dispatch, Evaluate, Refine, Loop) to narrow down relevant files.
  • Intelligent Search: Dynamically updates search patterns and keywords based on initial retrieval results.
  • Use Case: When a subagent is tasked with fixing a complex authentication bug, this skill helps it identify the specific files containing relevant JWT and session logic without loading the entire repository into context.

Quick Start

Activate the iterative-retrieval skill to progressively gather the most relevant files for the task of fixing the authentication token expiry bug.

Frequently Asked Questions about iterative-retrieval

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I optimize context retrieval for agents navigating a complex codebase?

Context retrieval is optimized by iteratively refining search queries based on file relevance scores. This prevents agents from loading the entire repository, minimizing token consumption while ensuring precise codebase navigation.

Why do my subagents fail to find relevant files when working on complex software engineering tasks?

Subagents fail due to missing codebase knowledge and excessive token usage. This issue is solved by progressively refining search patterns through a 4-phase evaluation loop to identify specific relevant files.

What is the best way to limit token usage during automated context discovery for multi-agent systems?

The best way to limit token usage is applying a structured 3-cycle evaluation and refinement loop. This dynamically updates search keywords based on initial retrieval results to narrow down relevant files.

How does progressive context refinement work for codebase navigation?

Progressive context refinement works through a 4-phase Dispatch, Evaluate, Refine, and Loop mechanism. It dynamically updates search patterns and keywords based on initial retrieval results to isolate relevant files.

Does iterative context discovery work for fixing complex authentication bugs across a large repository?

Yes, iterative context discovery works for complex authentication bugs. It helps agents identify specific files containing relevant JWT and session logic without loading the entire repository into the agent context.

When should I not use iterative search refinement for agent orchestration?

Iterative search refinement may not suit simple tasks where file locations are already known. It is designed for complex software engineering tasks requiring precise codebase navigation and limited token consumption.