iterative-retrieval

Progressively load Java context in large Spring Boot or Maven codebases.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/RogerioSobrinho/codeme-copilot --skill iterative-retrieval-rogeriosobrinho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iterative-retrieval
Source: https://github.com/RogerioSobrinho/codeme-copilot/tree/main/skills/iterative-retrieval
Command: npx skills add https://github.com/RogerioSobrinho/codeme-copilot --skill iterative-retrieval-rogeriosobrinho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reduces context overload by starting with minimal context and expanding progressively only when blocked, enabling faster navigation in large Java projects.

Core Features & Use Cases

  • Three-layer progressive expansion: structural reconnaissance, targeted search, and selective reading to minimize work.
  • Grep-before-read: locate relevant symbols and entry points before loading files.
  • Stop conditions and token-budget management: avoid noise and keep context focused in monorepos or multi-module Maven projects.
  • Use Case: when exploring 50+ Java classes in a Spring Boot mono-repo, use iterative retrieval to locate APIs and entry points with minimal context.

Quick Start

Invoke the iterative-retrieval pipeline to load Java context progressively as you navigate a large codebase.

Frequently Asked Questions about iterative-retrieval

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

FAQPage Schema
How do I reduce context overload when navigating a large Spring Boot monorepo?

To reduce context overload in a large Spring Boot monorepo, load context progressively by starting with structural reconnaissance before expanding. This approach keeps context lean and prevents unfocused exploration when navigating large Java codebases.

What is the grep-before-read rule for Java code navigation?

The grep-before-read rule for Java code navigation locates relevant symbols and entry points using targeted search before loading full files. This minimizes token consumption by ensuring only necessary code sections are read into context.

Can I use iterative retrieval for multi-module Maven projects with 50+ classes?

Yes, iterative retrieval is designed for multi-module Maven projects with 50+ classes. It uses a three-layer expansion strategy and token-budget management to handle large Java codebases efficiently without overwhelming the context window.

What is the best way to locate APIs in a large Java codebase?

The best way to locate APIs in a large Java codebase is using a three-layer progressive expansion strategy. It begins with structural reconnaissance, applies grep-before-read to find entry points, and selectively reads only the relevant files to maintain focus.

Why does context exploration slow down in large Java monorepos?

Context exploration slows down in large Java monorepos because loading all files at once causes context overload. Without stop conditions and token-budget management, the excess noise prevents targeted retrieval and unfocuses the navigation process.

When should I not use progressive context loading in Java projects?

You should not use progressive context loading in Java projects when the codebase is small enough to fit entirely within the context window. In smaller projects, the overhead of structural reconnaissance and targeted search outweighs the benefits of keeping context lean.