# Codebase Map

> Skill: Codebase Map — Indexacion de Dependencias Internas

- Skill: `gonzalezpazmonica/codebase-map` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add gonzalezpazmonica/codebase-map`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gonzalezpazmonica/codebase-map/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gonzalezpazmonica (https://skillmd.com/u/gonzalezpazmonica)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/gonzalezpazmonica/codebase-map

---


# Skill: Codebase Map — Indexacion de Dependencias Internas

> Inspirado en GitNexus: knowledge graph que indexa codebases en symbol maps.
> Aplicado a pm-workspace: indexa comandos, agentes, reglas y skills.

## Cuando usar

- Al inicio de sesion para entender que herramientas hay disponibles
- Cuando el NL-resolver no encuentra el comando correcto
- Para detectar reglas huerfanas o agentes nunca invocados
- Para entender cadenas de dependencia antes de modificar una regla

## Que escanea

### Comandos (.opencode/commands/*.md)
- Referencias `@` a reglas, skills, agentes
- Frontmatter: model, allowed-tools, context_cost
- Skill referenciado: linea "Ejecutar skill: @..."

### Agentes (.opencode/agents/*.md)
- Frontmatter: tools, model, permissionMode
- Descripcion: PROACTIVELY triggers
- Referencias a ficheros de proyecto en el body

### Reglas (docs/rules/domain/*.md)
- Quien las referencia (comandos, agentes, otras reglas)
- Hub score: numero de consumidores

### Skills (.opencode/skills/*/SKILL.md)
- Frontmatter: category, tags, priority
- Dependencias: que reglas o agentes invocan

## Output

Fichero: `output/codebase-map-{YYYYMMDD}.md`

Secciones:
- **Grafo de dependencias**: comando → agente → regla → skill (formato lista)
- **Hubs**: reglas con 5+ consumidores (cross-ref con semantic-hub-index.md)
- **Huerfanos**: reglas/agentes sin ningun consumidor
- **Cadenas criticas**: si una regla cambia, que comandos se afectan
- **Estadisticas**: total comandos, agentes, reglas, skills, densidad de conexiones

## Algoritmo

1. Glob todos los .md de commands/, agents/, rules/domain/, skills/
2. Para cada fichero: extraer referencias @ y menciones de otros componentes
3. Construir grafo dirigido: nodo = componente, arista = referencia
4. Calcular in-degree (hub score) y out-degree (dependencias)
5. Detectar nodos con in-degree 0 (huerfanos)
6. Detectar nodos con in-degree >= 5 (hubs)
7. Generar reporte

## Limitaciones

- Solo detecta referencias explicitas (@path o nombres en texto)
- No detecta invocaciones dinamicas (NL-resolver, skill-auto-activation)
- El grafo es estatico — snapshot del momento de ejecucion

