Antes, construir era caro. Eso obligaba a elegir.
Hoy agregar una opción más cuesta minutos, y la pregunta de si vale la pena es cada vez más fácil de saltar. El Manifiesto de Software Humano repone esa pregunta y le da un lugar en el proceso donde no se puede saltar.
Se puede leer el recorrido completo o entrar en cualquier punto; nada exige haber leído lo anterior.
Construir software es cada vez más fácil
Si construir dejó de ser el principal límite, ¿qué pasa a limitar la calidad?
Explicación
La inteligencia artificial redujo el costo de generar código, pantallas, textos y automatizaciones. Equipos pequeños construyen hoy productos que antes exigían organizaciones enteras, y una buena decisión puede llegar a manos de las personas en días.
Esa velocidad es una oportunidad real. También mueve el límite: cuando construir deja de ser lo difícil, lo difícil pasa a ser decidir qué merece existir y cómo debe sentirse al usarlo.
¿Cómo construimos software que amplifique la capacidad de las personas para conseguir lo que buscan, sin transferirles la complejidad de la tecnología?
Poder construir no significa deber construir
Explicación
Construir software se abarató. El costo no desapareció: pasó a quien lo usa. Se paga en atención, en aprendizaje y en decisiones que nadie vino a tomar.
Cuando construir es barato, una idea débil se convierte rápido en una implementación extensa, y una ambigüedad de producto en un comportamiento que parece terminado. El código puede ser correcto y aun así dejar en manos de la persona la complejidad que el equipo no resolvió.
Contraejemplo
Respuesta centrada en el sistema. Al enviar un formulario con un dato faltante, la página se recarga, borra lo escrito y muestra arriba «Error de validación». El sistema cumplió: rechazó un dato incompleto. Quien lo usa tiene que adivinar qué faltó y volver a escribir todo.
Ejemplo
Respuesta centrada en la persona. El formulario conserva lo escrito, señala junto al campo qué falta y explica qué se espera. La regla de validación es la misma; lo que cambia es cuánto trabajo recae en quien lo usa.
La IA debe absorber complejidad, no producirla.
El progreso humano es el producto
Explicación
La tesis cabe en una idea: el producto no es el software, sino el progreso que una persona consigue con él. Por eso la experiencia no es un acabado que se agrega al final; forma parte de la función.
Un sistema que entrega el resultado correcto, pero obliga a interpretar la interfaz, recordar convenciones o temer equivocarse, todavía no resolvió el problema. Solo lo trasladó.
El propósito del software es ampliar lo que una persona puede hacer.
Las personas no llegan a nuestros productos para utilizar funcionalidades. Llegan porque quieren comprender, decidir, crear, aprender, comunicarse, resolver o avanzar. Ese progreso es nuestro verdadero producto.
Diez principios para decidir
Explicación
Los principios no son aspiraciones. Cada uno tiene que poder cambiar una decisión, detener una implementación o exigir más evidencia; si una frase no tiene consecuencias prácticas, no cumple una función. Cada principio tiene su propia página, con su tensión, su significado, un ejemplo, un contraejemplo y las preguntas para usarlo en una revisión real.
P01El progreso del usuario es la unidad de diseñoP02La experiencia también es funcionalidadP03La complejidad pertenece al sistemaP04Simple al comenzar y profundo al necesitarloP05La interfaz no debe convertirse en otra tareaP06La atención es un recurso del productoP07La confianza se diseñaP08La calidad vive en la acumulación de detallesP09El tiempo y la continuidad forman parte de la interfazP10La persona conserva control y propiedad
Del principio a la decisión
Explicación
Un principio sirve cuando cambia lo que se hace. Hay tres formas en que puede actuar sobre una decisión concreta.
Ejemplo
Cambia una decisión. Una pantalla de inicio presenta cinco acciones con el mismo peso. Con P06 en la mesa, la pregunta es qué necesita la persona en ese momento: queda una acción principal y el resto aparece donde el contexto lo vuelve relevante.
Ejemplo
Exige evidencia. Una historia dice «como estudiante quiero recibir pistas para resolver derivadas». Con P01, la pregunta es cuándo aparece el bloqueo y cómo se reconocería el avance. Mientras no haya una observación que lo respalde, la historia es una hipótesis por comprobar, no un requisito.
Ejemplo
Detiene una implementación. Un asistente reescribe textos y los publica sin vista previa. Con P10, la implementación se detiene hasta que la persona pueda revisar, aceptar o rechazar el cambio antes de que se publique.
Contraejemplo
Sin el principio. Un agente de código termina una tarea y responde «listo». Para saber qué cambió, hay que revisar todo y confiar en su tono.
Ejemplo
Con el principio. El agente muestra qué archivos cambió, qué decidió por su cuenta y cómo deshacerlo. La confianza descansa en evidencia, no en el tono.
¿Qué circunstancia activa esta necesidad?
¿Qué progreso habilita?
¿Qué evidencia lo demuestra?
De la doctrina al desarrollo
Explicación
Los principios se vuelven práctica en un método: un fundamento de producto con autoridad, las Job Stories como forma de referencia, un flujo de ocho pasos, artefactos que existen solo si responden una pregunta, un contrato para agentes de código, razones explícitas para detenerse y una definición de terminado que no se conforma con código correcto.
Una implementación mediante SpecKit
Explicación
El manifiesto puede aplicarse con cualquier método. Una implementación de referencia lo lleva a SpecKit: el núcleo gobierna una constitución operativa, esa constitución condiciona al agente de código, y SpecKit, adaptado sin modificar su código, organiza la especificación, el plan, las tareas, el análisis y la implementación. Cómo funciona la adaptación.
Estado técnico confirmado
- Es una adaptación independiente.
- Usa los mecanismos nativos de personalización de SpecKit (presets).
- No modifica el código de SpecKit.
- Validada técnicamente en la versión 2.0.0, el 2026-09-27.
- No es una integración oficial ni cuenta con respaldo de GitHub.
Software Humano para SpecKit está publicada: versión 2.3.2, con el preset 2.0.3, que funciona igual que el 2.0.0 con que se construyó este sitio.
- Ver la versión 2.3.2 en GitHub
- Cómo instalarla, en el README del repositorio
- Huella SHA-256 del paquete, para comprobar la descarga:
bfb17a1fe3f5aa434c41881b8f354299385613a63d584d0fa1a43ea40d14c909
Se aplica hoy en un único proyecto real, este sitio. Su validación es técnica: todavía no hay evidencia de uso en otros equipos.