Trabajo con agentes de IA

El workspace está preparado para que un agente pueda descubrir primero el límite correcto, entender el impacto y validar el cambio sin cargar repositorios enteros en contexto.

Flujo recomendado

1. Identificar el repositorio Git propietario.
2. Leer su AGENTS.md y las instrucciones específicas del área.
3. Consultar el índice semántico o grafo de código antes de abrir ficheros grandes.
4. Localizar símbolos, rutas, contratos y llamadas afectadas.
5. Revisar el estado Git y preservar cambios ajenos.
6. Hacer el cambio mínimo que complete el flujo funcional.
7. Ejecutar validaciones enfocadas y después las generales que sean proporcionales al riesgo.
8. Reindexar el repositorio modificado.
9. Actualizar documentación o guía de migración cuando cambie el comportamiento observable.

Instrucciones locales

Cada repositorio debería tener un AGENTS.md breve que responda:

• qué posee el repositorio;
• qué no debe modificarse desde él;
• cómo arrancar, comprobar y construir;
• dónde están sus límites arquitectónicos;
• qué archivos son generados;
• qué secretos o datos nunca deben exponerse;
• qué consecuencias aguas abajo hay que comprobar.

Las instrucciones no deben copiar todo el README. Deben reducir ambigüedad operativa.

Contexto eficiente

Para agentes y personas, la información más útil es la que permite tomar una decisión:

• mapas de repositorios en lugar de árboles completos;
• nombres de símbolos y contratos en lugar de ficheros enteros;
• comandos exactos y reproducibles;
• diagramas pequeños para flujos con varios consumidores;
• decisiones arquitectónicas con estado, contexto y consecuencias.

Seguridad

Nunca deben entrar en el contexto de un agente claves, tokens, datos personales reales ni volcados de producción. Usa variables de entorno, secretos del CI y fixtures sintéticos. Revisa además artefactos de debug antes de adjuntarlos o versionarlos.