iterative-retrieval

Refines codebase context for subagents via iterative 4-phase search loops with relevance scoring.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/nhouseholder/nicks-claude-code-superpowers --skill iterative-retrieval-nhouseholder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iterative-retrieval
Source: https://github.com/nhouseholder/nicks-claude-code-superpowers/tree/main/skills/iterative-retrieval
Command: npx skills add https://github.com/nhouseholder/nicks-claude-code-superpowers --skill iterative-retrieval-nhouseholder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Progressive refinement of codebase context for subagents to solve the context problem in multi-agent workflows, enabling reliable reasoning when context is uncertain or large.

Core Features & Use Cases

  • 4-phase iterative loop (DISPATCH → EVALUATE → REFINE → LOOP) with a max of 3 cycles to converge on relevant files
  • Relevance scoring and gap identification to minimize token usage while maximizing context quality
  • Useful for bug hunts, feature explorations, and complex codebase investigations where context grows or changes across tasks

Quick Start

Initiate the iterative retrieval process by launching a broad file search, evaluate relevance, and iteratively refine the search criteria for up to three cycles.

Frequently Asked Questions about iterative-retrieval

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

FAQPage Schema
How do I refine codebase context for subagents in multi-agent workflows?

Iterative retrieval progressively refines codebase context for subagents in multi-agent workflows using a 4-phase loop: DISPATCH, EVALUATE, REFINE, and LOOP. It converges on relevant files to minimize token usage while maximizing context quality.

What is the best way to explore a large repository when hitting context size limits?

The best way to explore large repositories with context size limits is iterative retrieval. It applies relevance scoring and gap identification across up to 3 cycles, progressively assembling high-value context for agents to solve complex codebase investigations.

How does the iterative retrieval loop handle relevance scoring and gap identification?

The iterative retrieval loop evaluates dispatched file search results to score relevance and identify context gaps. It then refines search criteria in subsequent cycles, repeating up to 3 times to assemble high-value context for subagents.

Can I use iterative retrieval for bug hunts and feature exploration in complex codebases?

Yes, iterative retrieval is specifically designed for bug hunts, feature explorations, and complex codebase investigations. It handles scenarios where context grows or changes across tasks by refining codebase context for subagents.

What are the cycle limits when refining context through iterative retrieval?

The iterative retrieval loop has a maximum limit of 3 cycles. The 4-phase DISPATCH, EVALUATE, REFINE, and LOOP sequence repeats up to 3 times to converge on relevant files and assemble high-value context.

Do I need specific dependencies to run the iterative retrieval process?

No specific dependencies are required to run the iterative retrieval process. It operates independently to progressively refine codebase context for subagents, making it easily adoptable for multi-agent workflows.