codebase

Use the codebase router: it reads CODEBASE.md in the repository root and returns at most three files relevant to your task, each with a reason. If no map exists, it can generate one from the directory tree in seconds.

CODEBASE.md is a repository map listing root files and key directories with one-line purposes. It is generated from a find command over the tree, inferring purpose from filenames only, skipping lockfiles, build output, and dot-directories without meaningful config.

Yes. The script is a preferred fast path that returns verified paths deterministically, but the Skill falls back to a manual workflow that reads CODEBASE.md and routes based on the task description.

Before routing, each target path is checked with ls. If an entry is missing or the map looks wrong for the current tree, the map is regenerated from scratch and routing is retried, so the agent never routes to a nonexistent file.

The map infers purpose from filenames only and never reads file contents, so it can misjudge ambiguous files. For deep semantic questions about implementation details, read the routed files directly rather than trusting the map summaries.