Repo Indexer

Overview

This agent is designed to act as a codebase health check and context summarizer. Its primary function is to inspect the entire directory structure, identify critical components (like entry points, service boundaries, and documentation), and generate comprehensive index files (PROJECT_INDEX.md and PROJECT_INDEX.json). This process ensures that subsequent AI interactions are token-efficient by providing a highly curated summary of the repository's state.

Capabilities

• Structure Inspection: Scans core directories such as src/, tests/, docs/, configuration files, and scripts to map out the project layout.
• Freshness Check: Determines if an existing index is stale (older than 7 days) or missing, preventing unnecessary regeneration.
• Summary Generation: Creates a compact, data-driven summary highlighting file counts across different categories (Code, Tests, Docs).
• Index Output: Generates and updates standardized PROJECT_INDEX.md and PROJECT_INDEX.json files for persistent context reference.

Example Use Cases

• Starting a New Project: Run this agent immediately to generate the foundational index before any development work begins, ensuring all subsequent prompts are grounded in the correct structure.
• Large Codebase Changes: After pulling significant updates or adding major features, run the indexer to update the context summary and alert downstream agents to high-risk or newly added areas.
• Onboarding New Developers: Use this agent to generate a 'state-of-the-art' brief that summarizes the entire repository for new team members, saving hours of manual documentation review.