# Flujo con IA: Bruno Pintos

> Cómo construyo con Claude Code, con este sitio como ejemplo

Construyo software con Claude Code. Para este sitio diseñé un conjunto de agentes, hooks y reglas que deciden cómo trabaja la IA sobre el código, y Claude me ayudó a escribirlos.

Este sitio se construye con este sistema, con un registro escrito de cada sesión.

- 8 agentes activos
- 5 hooks en cada sesión
- 40+ sesiones registradas

## Cómo se hace un cambio

1. **Triage:** Un 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. **Bloqueo:** Un 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 registrado:** Antes 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 verificar:** Implementa, corre el build y el chequeo de tipos y descarga el HTML estático. Los resultados van al mismo registro.
5. **Revisión:** Antes 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

- **Triage:** Deriva cada tarea. Nunca edita.
- **Funcionalidades:** Páginas, componentes, estilos y contenido del sitio.
- **Debugging:** Bugs y fallas de build, hasta la causa raíz.
- **Tests:** Escribe y corre tests. Nunca toca el código fuente.
- **Dependencias:** Actualizaciones de paquetes. Siempre me pregunta antes.
- **Seguridad:** Audita 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

- **Restringido:** Secretos, configuración de deploy y de build. El agente frena y me pregunta antes de escribir.
- **Requiere revisión:** El head de las páginas y el esquema de contenido. El agente sigue, pero marca el cambio.
- **Prohibido:** Salida del build, archivos generados y el lockfile. Nunca se escriben a mano.
- **Destructivo:** Todo lo que no se puede deshacer espera mi confirmación, esté donde esté.

## Cómo se ve

El bloqueo, simplificado:

```
antes de Edit | Write | Bash:
  ¿solo lectura?       permitir
  ¿corrió el triage?   permitir
  si no                bloquear
```

Un plan registrado (de cuando se hizo esta página):

- **Alternativa:** Sumar esta página como proyecto. Descartada: contaría como trabajo para un cliente en el CV.
- **Supuesto:** Una segunda app de sistema no necesita cambios de layout.
- **Lo refutaría:** Que falle el build o que cambie el conteo del CV.

## 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. https://www.brunopintos.com/llms.txt

Este sistema lo diseñé yo y Claude me ayudó a escribirlo. El repositorio es privado, así que los ejemplos de esta página están simplificados.

HTML: https://www.brunopintos.com/es/ai-workflow/