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