Find agent skills by outcome

- Embed metadata including generation timestamp

commit hash at time of indexing

- Surface files with no test coverage

no documentation

- Catalog external dependencies with version constraints

license types

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

bug-fix commits

- Identify circular dependencies

tightly coupled modules

- Annotate each entry point and boundary with its file path

purpose

- Document API routes

event handlers

- Identify shared libraries

utility packages

- Locate application entry points by scanning for main functions

server bootstrap files

- Trace module boundaries by identifying package exports

public API surfaces

- 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

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

commit count

- Run parallel glob searches across the five focus areas: source code

tests

- Build a hierarchical directory tree capturing folder depth

file counts

- Identify whether major structural changes (new directories

deleted modules

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

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

- Generate compressed

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

- Detect change hotspots by analyzing recent commit activity

file churn rates

- Graph dependency relationships between modules

packages

- Identify entry points

service boundaries

- Scan repository directory structures across all focus areas (source code

tests