Un manifiesto para construir con IA

Entiende antes
de acelerar.

La IA nos ayuda a escribir código más rápido. Entender nos ayuda a construir lo correcto. Una forma compartida de planificar, revisar y entregar software con intención.

Leer el manifiestoLlevarlo a la práctica

Por Carlos Santana Roldán

UNDERSTAND FIRST

El orden importa.

  1. 01

    Entender

    El objetivo. El contexto. Las incógnitas.

  2. 02

    Decidir

    Evidencia compartida. Responsabilidad clara.

  3. 03

    Construir

    Con IA. Con criterio humano. Con verificación.

Mejores preguntas. Decisiones claras. Mejor software.

El tiempo reserva atención. La evidencia demuestra preparación.

01 / El manifiesto

Una forma compartida de trabajar.

Implementar más rápido hace que entender sea más valioso. Estos son los principios que elegimos para trabajar.

  1. 01

    Empieza por el resultado.

    Entiende quién se beneficia, qué debe cambiar y cómo se reconoce el éxito. Aclara el problema antes de elegir una solución.

  2. 02

    Conecta el propósito y la implementación.

    Une el objetivo del negocio y el plan técnico. Haz explícitos el alcance, el comportamiento, las dependencias y los ejemplos de aceptación.

  3. 03

    Haz visible la comprensión.

    Explica el plan con tus palabras. Compara interpretaciones, verifica los supuestos importantes y usa evidencia para descubrir lagunas antes de que generen retrabajo.

  4. 04

    Revisa según el riesgo.

    Mantén ligeros los cambios simples. Da a las decisiones importantes la atención y la experiencia que necesitan. El proceso debe ayudar a avanzar.

  5. 05

    La IA ayuda. Las personas responden.

    Usa la IA para explorar, redactar e implementar. Las personas verifican las afirmaciones importantes, toman las decisiones y son responsables del resultado.

  6. 06

    Resuelve los bloqueos antes de avanzar.

    Registra las inquietudes y obtén consentimiento informado sobre los planes vigentes. Estar preparado significa tener evidencia suficiente para avanzar, sin bloqueos importantes conocidos.

  7. 07

    Aprende de cada entrega.

    Valida el comportamiento, revisa el retrabajo y las esperas, y mejora el siguiente plan. Reabre las decisiones afectadas cuando nueva evidencia cambie lo que sabemos.

Tres preguntas diferentes

Dedicar tiempo no demuestra comprensión.

01

Esfuerzo de revisión

¿Cuánta atención necesitamos?

Reserva y registra tiempo para leer y revisar. Consume capacidad real del equipo.

02

Preparación

¿Entendemos lo suficiente para empezar?

Busca interpretaciones compatibles, ejemplos verificables, evidencia y bloqueos resueltos.

03

Previsión de entrega

¿Cuándo podríamos entregar?

Usa el historial de trabajo comparable, la capacidad disponible, las colas y las dependencias.

Los minutos de revisión no se convierten en horas de programación ni en una fecha de entrega.

02 / En la práctica

De una petición a un resultado.

Un ciclo práctico, proporcional al cambio. Empieza con dos planes breves y avanza con evidencia.

Goal PlanProducto / responsable de la tarea

Qué y por qué

El resultado para el usuario, los límites, las reglas de negocio y ejemplos concretos de aceptación.

SSD PlanDesarrollador que implementa

Cómo funcionará

Especificación y diseño del software: comportamiento, dependencias, posibles fallos, pruebas y recuperación.

  1. 01

    Definir y clasificar

    Aclara el objetivo y los límites. Identifica el riesgo y las perspectivas que necesita la revisión.

  2. 02

    Diseñar y verificar

    Prepara un plan técnico proporcional. Reúne evidencia sobre las afirmaciones importantes y las incógnitas.

  3. 03

    Leer y explicar

    Protege el tiempo de lectura. Revisa individualmente, explica el plan con tus palabras y compara interpretaciones.

  4. 04

    Resolver y consentir

    Resuelve las contradicciones, actualiza ambos planes y registra el consentimiento y las inquietudes pendientes.

  5. 05

    Construir y validar

    Toma trabajo cuando haya capacidad. Construye con IA, revisa el código, prueba y verifica la entrega.

  6. 06

    Medir y adaptar

    Revisa el retrabajo, los bloqueos que pasaron inadvertidos y las esperas. Mejora el siguiente ciclo con lo aprendido.

¿Cuánta revisión es suficiente?

Ajusta la profundidad al riesgo. Las incógnitas pueden necesitar un prototipo con tiempo limitado cuya evidencia se incorpore al plan.

Trivial
Cambios de texto o diseño: una comprobación independiente.
Bajo
Responsable, implementador y revisor; planes breves y revisión asíncrona.
Estándar
Perspectivas de producto, implementador, otro desarrollador y QA.
Alto
Revisión estándar más especialistas relevantes, sobre todo para pagos, permisos, migraciones o datos sensibles.
¿Qué significa estar preparado?

Revisa seis dimensiones: objetivo, alcance, comportamiento, dependencias, riesgo y recuperación, y verificación.

Rojo
Una laguna que bloquea. Resuélvela; no la diluyas en un promedio.
Ámbar
Una inquietud registrada. Asigna un responsable y una respuesta.
Verde
Evidencia suficiente para avanzar en esta dimensión.

Avanza con planes vigentes y sin bloqueos pendientes. Un descubrimiento importante reabre solo las decisiones y los participantes afectados.

Un ejemplo sencillo: un reembolso

«Reembolso solicitado» y «reembolso completado» son estados diferentes. Si el proveedor no responde a tiempo, puede haber procesado la petición de todos modos.

Mantén el reembolso pendiente hasta que el proveedor confirme que se completó.

Normal
La confirmación de que se completó actualiza el estado del reembolso.
Duplicado
Las peticiones repetidas no pueden reembolsar dos veces.
Sin respuesta
Mantenlo pendiente y concilia la petición original.

Empieza poco a poco

Prueba. Aprende. Conserva lo que ayuda.

  1. 01

    Calibra

    Revisa entre 5 y 10 tareas completadas.

  2. 02

    Observa

    Prueba la revisión sin bloquear la entrega.

  3. 03

    Aplica

    Usa el criterio de preparación en trabajo de riesgo estándar y alto.

  4. 04

    Simplifica

    Revisa los resultados y elimina pasos innecesarios.

03 / El autor

Principal Engineer

Carlos Santana
Roldán.

Carlos Santana Roldán es desarrollador web sénior con 20 años de experiencia práctica creando y entregando productos web de gran impacto. Como ingeniero líder full-stack en Universal Music Group, diseña y lleva a producción sistemas escalables, impulsa buenas prácticas de ingeniería y es mentor de desarrolladores que trabajan con React, Node.js y TypeScript. También es escritor de libros sobre React, con cinco publicaciones.

UnderstandFirst reúne esas ideas: hacer de la comprensión una responsabilidad compartida, usar la IA con intención y aprender de las entregas reales.

Ir al Perfil de Carlos SantanaVer la presentación

Para profundizar

Las ideas detrás del manifiesto.

Explora la serie Understanding Estimation de Carlos Santana Roldán. Artículos originales en inglés.

Parte 01

Understanding Estimation for the AI Coding Era

Repensar la planificación cuando la IA cambia el esfuerzo de implementación.

LinkedInParte 02

From Review Time to Readiness

Hacer visible la comprensión con evidencia y consentimiento informado.

LinkedInParte 03

From Readiness to Team Delivery

Conectar la preparación con la capacidad, la entrega y el aprendizaje.

LinkedIn
Ver la presentación original