iterative-retrieval

Discover relevant files in large codebases via a dispatch-evaluate-refine loop.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/nferrer-dev/claude-dotfiles --skill iterative-retrieval-nferrer-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iterative-retrieval
Source: https://github.com/nferrer-dev/claude-dotfiles/tree/main/skills/iterative-retrieval
Command: npx skills add https://github.com/nferrer-dev/claude-dotfiles --skill iterative-retrieval-nferrer-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the context-window dilemma where agents either lack sufficient information or are overwhelmed by irrelevant files, preventing the common pitfall of guessing which files to read.

Core Features & Use Cases

  • Dispatch-Evaluate-Refine Loop: A structured, three-phase iterative process to narrow down search results.
  • Relevance Scoring: Uses a 0-1 scale to prioritize files based on their functional importance to the task.
  • Use Case: When tasked with fixing a bug in an unfamiliar, large-scale repository, this skill guides the agent to discover the correct files by analyzing naming conventions and import chains rather than performing blind searches.

Quick Start

Use the iterative-retrieval skill to find the necessary files for fixing the rate limiting bug in the current codebase.

Frequently Asked Questions about iterative-retrieval

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

FAQPage Schema
How do I find relevant files in an unfamiliar codebase?

To find relevant files in an unfamiliar codebase, use a structured dispatch-evaluate-refine loop that executes targeted keyword searches and glob patterns, scoring file relevance to narrow down results systematically.

What is the best way to search a large codebase for fixing a bug?

The best way to search a large codebase for bug fixing is to analyze naming conventions and import chains iteratively, using relevance scoring to prioritize files based on their functional importance rather than performing blind searches.

How does the dispatch-evaluate-refine loop work for codebase search?

The dispatch-evaluate-refine loop works by dispatching targeted keyword searches, evaluating file relevance on a 0-1 scale, and refining search criteria based on discovered imports and naming conventions to maintain high-precision context retrieval.

Do I need specific tools to perform iterative codebase retrieval?

Yes, you need access to standard grep and glob-based file system traversal tools to perform iterative codebase retrieval, which are required to execute targeted searches and maintain high-precision context retrieval.

Why does my agent get overwhelmed by irrelevant files during codebase search?

Agents get overwhelmed by irrelevant files due to the context-window dilemma where they either lack sufficient information or are flooded with files, which systematic iterative retrieval solves by scoring and refining search criteria.

When should I use systematic context retrieval instead of a blind codebase search?

You should use systematic context retrieval instead of a blind search when working in large or unfamiliar repositories, as it guides agents to discover correct files by analyzing import chains and naming conventions iteratively.