| name | indexar-proyecto |
| model | claude-haiku-4-5 |
| description | Genera índice AST de archivos JS/TS para navegación estructural sin leer archivos completos |
| allowed-tools | Bash, Read |
Skill: Indexar Proyecto
Propósito: Crear un índice AST (.sdd/arquitectura/ast-index.jsonl) de todos los archivos JS/TS del proyecto. Permite a los agentes entender la estructura del código con ~60% menos tokens que leyendo archivos completos.
Cuándo usar este skill
- Al inicio de una sesión de implementación en proyectos JS/TS grandes (>20 archivos)
- Cuando un agente necesita saber qué exporta un módulo sin leer el archivo completo
- Antes de refactorizar — para conocer qué funciones están expuestas
- Cuando el agente recibe errores de "función no encontrada" — para localizar rápido
Uso
/indexar-proyecto → indexa todo el proyecto
/indexar-proyecto src/ → indexa solo el directorio src/
/indexar-proyecto src/auth.ts → indexa un archivo específico
Pasos
PASO 1 — Verificar prerequisitos
node --version
ls .sdd/arquitectura/ 2>/dev/null || echo "directorio no existe aún"
PASO 2 — Ejecutar indexer
node claude-hooks/ast-indexer.js
node claude-hooks/ast-indexer.js --dir src/
node claude-hooks/ast-indexer.js src/auth.ts
PASO 3 — Verificar resultado
node claude-hooks/ast-query.js --stats
node claude-hooks/ast-query.js --archivo "src/auth.ts" --tipo exports
node claude-hooks/ast-query.js --buscar "login"
Cómo usan el índice los agentes
En lugar de Read src/auth.ts (carga el archivo completo, ~2000 tokens), el agente hace:
node claude-hooks/ast-query.js --archivo "src/auth.ts" --tipo exports
node claude-hooks/ast-query.js --buscar "hashPassword"
node claude-hooks/ast-query.js --archivo "src/auth.ts" --tipo imports
Solo usa Read completo si necesitas el cuerpo de una función específica.
Limitaciones
- Solo cubre JS/TS (.js, .mjs, .cjs, .ts, .tsx, .jsx)
- TypeScript avanzado (decoradores, tipos complejos) puede omitirse sin error
- El índice es una foto fija — re-indexar si cambian los archivos significativamente
- Para Python/Go/Rust usar Read directamente (soporte multilenguaje en v3.x)
Output esperado
✅ ast-indexer: 47 archivos indexados, 312 símbolos → .sdd/arquitectura/ast-index.jsonl
3 archivos omitidos (TS avanzado o parse error)