Estamos descubriendo mejores maneras de desarrollar software en colaboración con agentes de Inteligencia Artificial.

A través de este trabajo, hemos aprendido a valorar:

  • La dirección clara y el contexto estructurado más que la simple generación pasiva de código.
  • El avance incremental validado más que entregas monolíticas sin control.
  • La comprensión humana y la simplicidad más que las abstracciones prematuras de la máquina.
  • La trazabilidad y la documentación viva más que la velocidad sin control.

Aunque los elementos de la derecha tienen valor, priorizamos los de la izquierda.

Nuestros principios

I. Asumimos la silla de dirección

No pedimos solo código. Dirigimos agentes muy rápidos.

Preparamos el ambiente. Definimos las reglas. Delimitamos las fronteras de actuación.

II. Respetamos el ritmo del pensamiento

No mezclamos exploración, planificación e implementación.

Primero exploramos la idea. Después planificamos las etapas. Solo entonces damos la orden de construir.

III. Celebramos la etapa única

Rechazamos el impulso de crear todo el sistema de una vez.

Preferimos implementar, revisar y validar una pequeña etapa por ciclo.

IV. Exigimos explicabilidad

No aceptamos código que no podamos explicar.

Si la arquitectura se vuelve ininteligible para la mente humana, la velocidad dejó de ayudar.

V. Validamos sin descanso

Ninguna línea de código está lista sin prueba de funcionamiento.

La validación no es burocracia. Es el contrato mínimo entre intención y realidad.

VI. Protegemos el historial

Usamos Git desde el primer ciclo.

Commits pequeños y bien descritos preservan contexto, reducen miedo y hacen reversible el avance.

VII. Gobernamos por contexto

Reconocemos el archivo AGENTS.md como la constitución del proyecto.

Registra reglas, criterios, límites y modo de trabajo.

VIII. Modelamos antes de persistir

Respetamos la estructura de los datos.

Antes de escribir lógica de negocio, documentamos entidades, campos, relaciones y reglas.

IX. Restringimos para liberar

Limitamos la creatividad técnica de la máquina para proteger el mantenimiento del producto.

La solución más simple que funciona suele ser la mejor primera solución.

X. Cultivamos la memoria del proyecto

La documentación viva preserva el porqué de las decisiones.

Sin memoria, cada nueva sesión intenta reconstruir el proyecto desde cero.

Un ejemplo de ciclo

1. Escriba el objetivo de la etapa.
2. Diga qué archivos pueden cambiar.
3. Implemente poco.
4. Ejecute lint, prueba y build.
5. Revise el diff.
6. Registre riesgos y próximos pasos.

Vibe coding no es abdicar de la ingeniería.

Es usar IA sin abandonar dirección, criterio y responsabilidad.