Codebase Map
Map a repository into entry points, dependency boundaries and a focused reading plan.
Get a compact architecture map with file references and unresolved questions.
Free · 2 KB · SKILL.md, instructions and example files. Requires read access to the repository and a file/text search tool.
A worked example
A small example to try before using your own data.
Input
{
"files": {
"app.py": "from routes import api",
"routes.py": "from service import load",
"service.py": "from storage import read",
"storage.py": "def read(): ..."
},
"task": "Find where persistence behavior belongs"
}Expected result
Entry: app.py → routes.py → service.py → storage.py. Persistence adapter: storage.read. Read storage.py and its callers in service.py first; inspect tests before changing the adapter.
What to check: Every edge must exist in the supplied imports; do not claim a runtime call graph or identify hot files without evidence.
Limits: Static imports do not prove runtime behavior. Plugins, reflection and generated routes may need runtime inspection.
Worked example included. Model-specific performance and vendor compatibility have not been benchmarked.
🧠 Why it works
Every edge must exist in the supplied imports; do not claim a runtime call graph or identify hot files without evidence.
⚙️ How it works
- Read repository instructions and build manifests, then list source files while excluding dependencies, generated files and secrets.
- Locate runtime entry points and trace their immediate imports, routes or command registrations.
- Map modules by responsibility and show the direction of dependencies. Mark inferred or dynamic edges.
- Choose the shortest reading path for the requested change; include file and symbol references rather than dumping source.
- Validate every named file against the working tree and list concrete uncertainties.
Description
Get a compact architecture map with file references and unresolved questions.
Requires read access to the repository and a file/text search tool.
Limits: Static imports do not prove runtime behavior. Plugins, reflection and generated routes may need runtime inspection.
Recommended Use
Sign in to suggestTools and workflow packs this skill pairs well with. Forge picks are auto-generated from category + capability signals; Community picks are added by people who've used the pairing.
Report compatibility
Tell the community which tool you used this skill with, and whether it worked.
Suggest a pairing
Recommend a tool or workflow pack that this skill works well with. Up to 5 recommendations per day.