codemap

¿Qué hace codemap?

Ejecuta el script empaquetado. Lee el árbol de trabajo actual en cada llamada e imprime un mapa compacto y ordenado; nunca escribe nada.

${CLAUDE_SKILL_DIR}/scripts/codemap --ext php,blade.php --dir app
${CLAUDE_SKILL_DIR}/scripts/codemap --ext css,scss --symbols
${CLAUDE_SKILL_DIR}/scripts/codemap --ext ts,tsx --dir src --symbols --max 150

Opciones: --ext (separado por comas, sin puntos), --dir, --symbols, --max (límite de líneas de salida, por defecto 300), --exclude REGEX (repetible).

La salida tiene el siguiente aspecto:

# codemap: 12 files in 3 dirs (dir: app, ext: php, via rg)
Http/Controllers/
  UserController.php: class UserController, fn index, fn store

Cuándo usarlo

• Necesitas todos los archivos de uno o más tipos y no sabes dónde se encuentran.
• Estás a punto de leer varios archivos solo para saber qué definen: ejecuta primero con --symbols y lee solo los archivos que importan.
• Un subagente comienza a trabajar en un área desconocida: pásale el mapa de código de ese directorio en lugar de dejar que busque desde cero.

Cuándo no usarlo

• Conoces el nombre del archivo o un patrón preciso: usa Glob.
• Necesitas texto dentro de archivos: usa Grep.
• Necesitas definiciones o referencias de un símbolo y un plugin LSP está habilitado: usa la herramienta LSP.

Trucos

• Se respeta .gitignore cuando ripgrep o git están disponibles; vendor/, node_modules/, la salida de compilación, los archivos minimizados y los mapas fuente siempre se omiten.
• Los símbolos provienen de patrones basados en líneas, no de un analizador sintáctico: clases/funciones PHP de nivel superior, exportaciones JS/TS, class/def de nivel superior en Python, type/func de Go, propiedades personalizadas CSS (como recuento) y mixins de SCSS/Less. Trátalos como una tabla de contenidos y luego lee el archivo.
• Cuando la salida termina con # ... truncated, reduce con --dir, --ext o --exclude en lugar de aumentar mucho --max.