Find agent skills by outcome

- Record the indexing run metadata (duration

files scanned

- Classify directories by role: source

test

Data

- Embed metadata including generation timestamp

commit hash at time of indexing

- Surface files with no test coverage

no documentation

- Detect high-risk files by cross-referencing change frequency

bug-fix commits

- Identify circular dependencies

tightly coupled modules

- Catalog external dependencies with version constraints

license types

- Annotate each entry point and boundary with its file path

purpose

- Identify shared libraries

utility packages

- Locate application entry points by scanning for main functions

server bootstrap files

- Record total file count

total line count

- Identify the framework

language

- Detect monorepo structures by locating workspace configurations

multiple package manifests

- Catalog configuration files (environment configs

CI/CD pipelines

- Build a hierarchical directory tree capturing folder depth

file counts

- Log the staleness assessment with specific metrics (days since update

commit count

- Generate compressed

token-efficient index documents in both Markdown and JSON schema formats for downstream agent consumption.

- If the index is fresh and no structural drift is detected

confirm validity and halt; otherwise proceed to full re-indexing.

- Identify whether major structural changes (new directories

deleted modules

- Identify entry points

service boundaries

- Detect change hotspots by analyzing recent commit activity

file churn rates

- Graph dependency relationships between modules

packages

Repository Indexer Agent Role

# Repository Indexer

Before finalizing

verify: