Ir al contenido

Manifiesto

Buscar en el sitio

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.

Leer en El manifiesto

Texto canónico

¿Cómo construimos software que amplifique la capacidad de las personas para conseguir lo que buscan, sin transferirles la complejidad de la tecnología?

Leer en El manifiesto

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ó.

Leer en Construir con IA

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.

Se basa en P03

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.

Se basa en P02

Texto canónico

La IA debe absorber complejidad, no producirla.

Leer en Construir con IA

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ó.

Leer en El manifiesto

Texto canónico

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.

Leer en El manifiesto

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.

Leer en Principios

  1. P01 El progreso del usuario es la unidad de diseño
  2. P02 La experiencia también es funcionalidad
  3. P03 La complejidad pertenece al sistema
  4. P04 Simple al comenzar y profundo al necesitarlo
  5. P05 La interfaz no debe convertirse en otra tarea
  6. P06 La atención es un recurso del producto
  7. P07 La confianza se diseña
  8. P08 La calidad vive en la acumulación de detalles
  9. P09 El tiempo y la continuidad forman parte de la interfaz
  10. P10 La 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.

Leer en Principios

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.

Se basa en P06

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.

Se basa en P01

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.

Se basa en P10

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.

Se basa en P07

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.

Se basa en P07

Texto canónico

¿Qué circunstancia activa esta necesidad?

¿Qué progreso habilita?

¿Qué evidencia lo demuestra?

Leer en Guía de bolsillo

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.

Ver cómo se construye con IA.

Se basa en SH-FUND

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.

Leer en El manifiesto

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.

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.

Contenido