trkbt10/indexion-agent-orient

¿Qué hace indexion-agent-orient?

Genera y utiliza un resumen de estructura previo a la edición para que los agentes de codificación conozcan los propietarios probables, las superficies de consumo y las ubicaciones de edición inseguras antes de implementar.

¿Qué hace?

Antes de que un agente de IA realice cambios en el código, esta habilidad genera un resumen de estructura conciso que contiene:

• Propietarios probables: basados en git blame para cada archivo
• Superficies de consumo: qué archivos/módulos importan o dependen del archivo
• Ubicaciones de edición inseguras: archivos que no deben modificarse (por ejemplo, generados automáticamente, node_modules, archivos empaquetados)

Por qué es útil

Los agentes de codificación a menudo fallan porque:

• Editan archivos que son generados automáticamente (y los cambios se sobrescriben)
• Rompen dependencias sin saberlo
• No actualizan todas las ubicaciones que necesitan un cambio
• Modifican archivos cuyo propietario no conocen

Al tener un resumen de estructura antes de editar, el agente puede tomar decisiones más informadas.

Plataformas compatibles

• Claude Code (primario)
• Cursor (con configuración de reglas adecuada)
• Codex CLI (con configuración de contexto)
• Cualquier agente que admita indicaciones previas al código o archivos de reglas

Cómo funciona

1. El agente solicita indexion.sh (o se ejecuta automáticamente mediante un enlace previo al código)
2. indexion.sh escanea el directorio actual en busca de archivos de código relevantes
3. Para cada archivo:
   • Ejecuta git blame para encontrar al último autor
   • Busca referencias de importación/dependencia en otros archivos
   • Marca archivos en directorios ignorados (node_modules, build, .git, etc.)
4. Genera un archivo STRUCTURE_BRIEF.md en la raíz del proyecto
5. El agente lee STRUCTURE_BRIEF.md antes de hacer cualquier edición

Instalación

# Clonar o copiar este repositorio en tu proyecto
git clone https://github.com/trkbt10/indexion-agent-orient.git .indexion

# (Opcional) Agregar como submódulo
git submodule add https://github.com/trkbt10/indexion-agent-orient.git .indexion

Uso

En Claude Code

Agregar a tu archivo CLAUDE.md o instructions.md:

Antes de editar cualquier archivo, ejecuta `bash .indexion/indexion.sh` para generar un resumen de estructura. Luego lee `.indexion/STRUCTURE_BRIEF.md` para entender los propietarios, consumidores y áreas inseguras.

En Cursor

Agregar a .cursorrules:

Antes de implementar cambios, ejecuta `bash .indexion/indexion.sh` y revisa `.indexion/STRUCTURE_BRIEF.md`.

Manual

bash .indexion/indexion.sh
cat .indexion/STRUCTURE_BRIEF.md

Salida de ejemplo (STRUCTURE_BRIEF.md)

# Resumen de estructura

## Archivo: src/api/handlers.ts
- **Propietario**: @jane.doe (último commit: abc123)
- **Consumidores**: src/routes/users.ts, src/middleware/auth.ts
- **Inseguro**: No

## Archivo: node_modules/express/lib/route.js
- **Propietario**: N/A (archivo de terceros)
- **Inseguro**: Sí (node_modules)

Personalización

Edita indexion.sh para cambiar:

• Patrones de exclusión de archivos/directorios
• Número de líneas de contexto de git blame
• Formato de salida del resumen

Licencia

MIT