Implementación incremental: pasos pequeños que se pueden probar y deshacer

Cómo entregar un cambio por incrementos: rebanadas verticales, una cosa cada vez, código que siempre compila, funciones tras un interruptor, valores por defecto seguros, vuelta atrás fácil.

Metodologíametodologiasviluppoincrementaleingegneria del software19 de noviembre de 2026 · 3 min de lectura

Escribir durante dos días un único cambio grande y probarlo al final es la forma más rápida de descubrir, en el último momento, que el problema estaba en la primera hora. La implementación incremental invierte el orden: se construye una pieza pequeña, se prueba, se guarda y solo entonces se pasa a la siguiente.

El ciclo del incremento

Se elige la siguiente porción pequeña, se construye, se prueba (pruebas, compilación, control a simple vista), se guarda con un commit descriptivo y solo después se sigue adelante. Si a mitad de camino algo se rompe, el daño es de veinte minutos, no de dos días.

Cómo cortar el trabajo

  • Rebanadas verticales (preferidas). Una rebanada atraviesa todas las capas y produce algo que funciona: del dato a la pantalla, para un caso sencillo. Se puede enseñar y probar.
  • Primero el contrato. Cuando varias partes deben hablar entre sí, se acuerda y se escribe primero la frontera (la interfaz, el formato de los datos), y luego cada uno trabaja por su lado.
  • Primero el riesgo. Se aborda primero la parte más incierta: si no se puede hacer, mejor saberlo el primer día.

Las reglas

Primero la sencillez. La solución más simple que funciona es la correcta hasta que la realidad demuestre otra cosa.

Disciplina del alcance. Se hace lo que está en la tarea. La idea «ya que estoy, añado también esto» es la forma en que un cambio de una hora se convierte en uno de tres días.

Una cosa cada vez. Un incremento, una intención. Cambios no relacionados en un mismo incremento hacen imposible entender qué ha roto qué.

Siempre compilable. Entre un incremento y otro el sistema arranca y las pruebas pasan. Si se rompe, se repara antes de seguir.

Interruptores para las funciones incompletas. Una función a medias se oculta tras una opción de configuración (feature flag), de modo que el código pueda integrarse sin que los usuarios lo vean.

Valores por defecto seguros. Una opción nueva empieza apagada y prudente.

Fácil de deshacer. Cada incremento debe poder retirarse solo, sin arrastrar nada más.

Cuando se trabaja con un agente

Vale lo mismo, y más: un agente al que se deja libre tiende a producir mucho código de golpe. Se pide un paso cada vez, se verifica y se decide el siguiente. Más de un centenar de líneas escritas sin ejecutar nada es una campana de alarma.

Señales de alarma

  • Más de un centenar de líneas escritas sin ejecutar las pruebas.
  • Varios cambios no relacionados en un solo incremento.
  • Ampliaciones de alcance del tipo «añado esto sobre la marcha».
  • Saltarse la verificación para ir más rápido.
  • Compilación o pruebas rotas entre un incremento y otro.
  • Grandes cambios sin guardar que se acumulan.
  • Abstracciones construidas antes de que un tercer caso de uso las pida.

Un ejemplo

Hay que añadir el envío de una notificación cuando un pedido cambia de estado. Primer incremento: enviar un mensaje fijo al pasar de «nuevo» a «confirmado», probado con una prueba. Segundo: personalizar el texto. Tercero: gestionar los demás estados. Cuarto: permitir al cliente desactivarla. En cada paso el sistema funciona y quien revisa el código lee pocas líneas, no un muro.

Cuándo usarla

Al realizar una funcionalidad o un cambio que toca más de un archivo, cuando se va a escribir mucho código de golpe o cuando un trabajo parece demasiado grande para concluirse en un solo paso.

Este método deriva de la familia de skills de código abierto agent-skills de Addy Osmani (licencia MIT), reescrita y adaptada.

Este artículo es una skill de OIAR

Lo que acabas de leer es el contenido de una skill del catálogo de OIAR, escrito para las personas. Un conocimiento como este pero más rico y profundo, escrito para los agentes, guía las entrevistas, el análisis y el informe dentro de la plataforma. Las skills se usan en OIAR: para probarla en un proyecto tuyo necesitas una cuenta.

incremental-implementationMétodo para realizar un cambio en pequeños incrementos verificables: ciclo elige-construye-prueba-guarda, rebanadas verticales, reglas de alcance, código siempre compilable, interruptores para funciones incompletas, vuelta atrás fácil. Úsese cuando un cambio toca varios archivos o se va a escribir mucho código de golpe.