Flujo con IA

Cómo se hace un cambio

1. TriageUn agente de solo lectura clasifica la tarea, nombra los archivos que toca, los revisa contra las reglas de rutas y elige qué agente hace el trabajo.
2. BloqueoUn hook bloquea toda edición hasta que el triage corrió en esa sesión. Leer código y los comandos de solo lectura pasan sin problema.
3. Plan registradoAntes de tocar un archivo, el agente escribe su plan en un registro de decisiones: la mejor alternativa que descartó, el supuesto en el que se apoya el plan y qué demostraría que está mal.
4. Construir y verificarImplementa, corre el build y el chequeo de tipos y descarga el HTML estático. Los resultados van al mismo registro.
5. RevisiónAntes de un push, un hook sugiere un comando de revisión que chequea toda la rama. Solo pasa con cero hallazgos de severidad alta.

Agentes

• TriageDeriva cada tarea. Nunca edita.
• FuncionalidadesPáginas, componentes, estilos y contenido del sitio.
• DebuggingBugs y fallas de build, hasta la causa raíz.
• TestsEscribe y corre tests. Nunca toca el código fuente.
• DependenciasActualizaciones de paquetes. Siempre me pregunta antes.
• SeguridadAudita secretos, XSS y links inseguros. Nunca edita.

Los agentes de APIs, bases de datos y CI están guardados, listos para volver cuando un proyecto los necesite. Cada uno tiene un área clara, y un agente deriva en vez de meterse en el área de otro.

Reglas que la IA no puede saltear

• RestringidoSecretos, configuración de deploy y de build. El agente frena y me pregunta antes de escribir.
• Requiere revisiónEl head de las páginas y el esquema de contenido. El agente sigue, pero marca el cambio.
• ProhibidoSalida del build, archivos generados y el lockfile. Nunca se escriben a mano.
• DestructivoTodo lo que no se puede deshacer espera mi confirmación, esté donde esté.

Por qué le importa a un cliente

• La IA sigue las reglas del proyecto, no sus propios defaults, así que el código queda consistente.
• Cada decisión tiene un motivo escrito, así que quien revisa ve el porqué, no solo el qué.
• No puede tocar secretos, configuración de deploy ni dependencias sin mi OK explícito.

Hecho para que también lo lean agentes

Cada página del sitio tiene una versión en Markdown, y un llms.txt las indexa, así que asistentes como Claude pueden leer el portfolio directamente.

llms.txtEsta página en Markdown