---
title: "El Manifiesto Vibe Coding"
summary: "Una declaración de principios para construir software con agentes de IA sin abandonar dirección humana, validación y simplicidad."
slug: "manifiesto-vibe-coding"
language: "es"
publishedAt: "2026-05-20"
updatedAt: null
tags:
  - "manifiesto"
  - "vibe coding"
  - "proceso"
translationOf: "pt/manifesto-vibe-coding"
translationStatus: "current"
---

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

```txt
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.