iterative-retrieval

Retrieves relevant code files by scoring relevance and refining search criteria across up to three cycles.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/JGcode3675/gcs-os --skill iterative-retrieval-jgcode3675
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iterative-retrieval
Source: https://github.com/JGcode3675/gcs-os/tree/main/home/james/claude-config/skills/iterative-retrieval
Command: npx skills add https://github.com/JGcode3675/gcs-os --skill iterative-retrieval-jgcode3675

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Subagents often start with insufficient context, lacking knowledge of which code files are relevant, the project's terminology, or necessary patterns, leading to ineffective or over‑loaded prompts.

Core Features & Use Cases

  • Four‑phase iterative loop: Dispatch, evaluate, refine, and repeat up to three cycles.
  • Relevance scoring: Assigns scores to files and filters by high relevance (≥0.7).
  • Terminology learning: Extracts keywords and patterns from high‑relevance files to improve subsequent searches.
  • Use Cases: Quickly gather context for bug fixes, new feature implementations, or codebase exploration without exceeding token limits.

Quick Start

Use the iterative-retrieval skill to gather the most relevant files for the task "add rate limiting to API endpoints".

Frequently Asked Questions about iterative-retrieval

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

FAQPage Schema
How do I retrieve relevant code files to fill subagent context gaps?

To retrieve relevant code files for subagent context gaps, use a four-phase iterative loop of dispatch, evaluate, refine, and repeat up to three cycles. Score file relevance, identify missing terminology, and return high-relevance files (≥0.7) for the given task.

What is the best way to gather code context for bug fixes without exceeding token limits?

The best way to gather code context for bug fixes without exceeding token limits is applying iterative retrieval. It scores file relevance and filters by high relevance (≥0.7), ensuring only the most pertinent files are loaded into the subagent context.

How does terminology learning improve code search relevance for new feature implementations?

Terminology learning improves code search relevance by extracting keywords and patterns from high-relevance files. This extracted terminology refines search criteria in subsequent iterative cycles, returning more accurate code files for new feature implementations.

Does iterative retrieval work with any programming project for codebase exploration?

Yes, iterative retrieval works with any programming project for codebase exploration. It applies a four-phase loop across up to three cycles to score file relevance, identify missing terminology, and refine search criteria, returning high-relevance files (≥0.7).

Why does my subagent start with insufficient context for prompt generation?

Subagents start with insufficient context because they lack knowledge of which code files are relevant, the project's terminology, or necessary patterns. This leads to ineffective or over-loaded prompts during codebase exploration or feature implementation.

What are the limitations of using a three-cycle iterative retrieval loop for code context refinement?

The iterative retrieval loop is limited to a maximum of three cycles for code context refinement. After these cycles, it stops refining search criteria and returns files scoring ≥0.7, which may miss deeply nested or poorly named code files.