SuperAPI AI Directory

explore

Coding & development

View repository

Updated 11-17 04:15

About this skill

Systematic Codebase Exploration

Start with the big picture

  1. codemap .: project tree with file counts and top extensions
  2. codemap --deps .: dependency flow showing how packages connect
  3. Hub files: these are the most important files to understand first

Trace a feature

  1. Find the entry point (CLI command, API route, event handler)
  2. codemap --importers <entry-file>: who calls this?
  3. codemap --deps .: follow the import chain
  4. Read hub files in the chain first: they define the shared types/interfaces

Understand a subsystem

  1. Check .codemap/config.json for routing subsystems: they define logical boundaries
  2. Each subsystem has paths, keywords, and associated docs
  3. Read the subsystem's docs first, then trace the code

Find what you're looking for

Question Command
Where is X defined? codemap find "<words from its name>"
Where is this bug? codemap find "<symptom words>" scores names first, then body text ((body) hits); grep for the exact symptom text
Who uses X? codemap --importers <file>
What's the architecture? codemap --deps . → look at hub files
What changed recently? codemap --diff
What was I working on? Check working set in prompt-submit output