Metodología para desarrollo con IA

El antídoto al vibe coding.
Specs mínimos.
Valor real.

$ micro-sdd init "detección de paradas"
Spec creado: 3 acceptance tests
Slice vertical identificado
Listo para implementar

Micro SDD es una metodología de desarrollo guiado por specs mínimos, diseñada para equipos que usan IA. No asumes la solución — la descubres a través de ciclos cortos, verificables y orientados a valor.

El problema

La IA genera código rápido. No garantiza valor.

El vibe coding produce el espejismo de la productividad: actividad sin dirección, velocidad sin destino.

✕ Vibe coding
Prompt → código → a ver qué pasa
Sin tests, sin criterio de aceptación
Deuda técnica invisible desde el día 1
Arquitectura que nadie entiende en 2 semanas
Métricas de actividad, no de entrega
✓ Micro SDD
Spec mínimo → test → implementación guiada
Criterio de aceptación antes de escribir código
Cada ciclo entrega valor verificable
Arquitectura emergente, no presumida
Progreso medido en slices completados
Fundamentos

Cinco principios. Un sistema.

Cada principio resuelve una tensión real del desarrollo con IA. No son sugerencias — son invariantes.

P1
Slice vertical completo
Cada entrega atraviesa todas las capas: desde UI hasta persistencia. Nunca divides por capa técnica. El valor se entrega completo o no se entrega.
P2
Tests primero, siempre
ATDD define el criterio de aceptación. TDD unitario guía la implementación desde afuera hacia adentro. El test es la especificación ejecutable.
P3
Descubrimiento continuo
La solución emerge del proceso, no de un diseño previo. Cada ciclo aporta conocimiento que cambia los siguientes specs. No se presume, se descubre.
P4
Feedback integrado
El ciclo no termina en el merge. La retroalimentación del entorno real alimenta el siguiente spec. El sistema aprende de cada entrega.
El ciclo

De idea a valor verificable en ciclos cortos.

Cada iteración de Micro SDD sigue el mismo patrón — pequeño, verificable, completo.

01
Identificar el slice
Define la unidad mínima de valor. Un spec es un slice vertical, nunca una capa técnica.
02
Escribir el spec
El spec define el criterio de aceptación antes de cualquier implementación. Tests primero.
03
Implementar con IA
La IA implementa guiada por los tests. No adivina — sigue una especificación ejecutable.
04
Verificar y aprender
Los tests pasan. El feedback actualiza el mapa de specs candidatos para el próximo ciclo.
En la práctica
deteccion-paradas.spec
// Spec: Detección de paradas en ruta
// Slice vertical — P0 mínimo viable

Feature: Detección de paradas

  Scenario: Parada detectada correctamente
    Given un GPS con coordenadas cada 30s
    When el vehículo permanece < 50m por 5min
    Then se registra una parada con timestamp

  Scenario: Movimiento continuo no genera parada
    Given velocidad promedio > 15 km/h
    Then no se registra ninguna parada

// 2 acceptance tests · 1 slice · 0 suposiciones
Pequeño porque el mejor camino se descubre, no se presume.

Este spec no dice cómo detectar la parada — dice cuándo se considera que una parada ocurrió. La implementación queda libre. La IA tiene contexto real, no suposiciones.

Dos scenarios. Un slice vertical completo. Criterio de aceptación claro antes de escribir una sola línea de código de producción.

ATDD slice vertical P0 aplicado sin estimados criterio ejecutable
Filosofía

"El spec pequeño no es una limitación — es un reconocimiento de honestidad: no sabes la solución hasta que la descubres."

— Micro SDD · Principio de descubrimiento continuo
¿Listo para empezar?

Deja de adivinar. Empieza a descubrir.

Lee el artículo fundacional y entiende por qué Micro SDD es el eslabón que faltaba entre la agilidad y el desarrollo con IA.

Leer el artículo fundacional Ver los principios en detalle