Acerca del Manifiesto
Una doctrina para decidir qué merece ser construido.
El Manifiesto para el desarrollo de software humano con inteligencia artificial propone pensar y evaluar los productos desde el progreso de las personas, preservando su claridad, su confianza y su control.
Construimos herramientas para ampliar las capacidades de las personas, no para exhibir las capacidades del software.
Por qué existe
Construir software se ha vuelto más rápido. La inteligencia artificial permite convertir instrucciones en pantallas, automatizaciones y código con una facilidad inédita. Pero esa abundancia no garantiza mejores productos: también puede transformar una decisión débil en una funcionalidad perfectamente terminada.
Escribí este manifiesto ante ese cambio. Su pregunta central no es solo si algo puede construirse, sino si merece existir, qué progreso habilita y qué carga introduce en la vida de quien lo usa.
Por eso su unidad de medida no es la cantidad de funcionalidades entregadas. Es el progreso que una persona puede alcanzar con claridad, confianza y control.
Una forma de entender el software
Las personas no llegan a un producto para utilizar funcionalidades. Llegan porque quieren comprender, decidir, crear, aprender, comunicarse, resolver o avanzar. Ese progreso es el verdadero producto.
Desde esta perspectiva, la experiencia forma parte de la función. Una solución sigue incompleta si alcanza el resultado técnico, pero obliga a descifrar la interfaz, recordar convenciones innecesarias o actuar sin comprender qué ocurrirá después.
El manifiesto no rechaza la complejidad de los problemas. Sostiene que la complejidad de construir una solución no debe trasladarse automáticamente a quien la usa. La tecnología —y en particular la inteligencia artificial— debe absorber complejidad, no multiplicarla. Puede proponer, explicar y automatizar, pero permanece subordinada a la intención de la persona.
Origen e influencias
Este marco es una elaboración independiente inspirada en ideas públicas de Craft y en las conversaciones que dieron origen a este documento. No es un manifiesto oficial de Craft ni atribuye a su fundador las reglas operativas aquí propuestas.
De Craft recoge la unión entre forma y función; el efecto que una herramienta produce en la energía y capacidad de quien la usa; la complejidad adaptable, que aparece cuando se necesita; y un enfoque human first, frente a sistemas que obligan a las personas a acomodarse a su estructura.
De Jobs to Be Done conserva el progreso como referencia superior. De Job Stories adopta una forma concreta de llevar ese progreso al diseño mediante la circunstancia, la motivación y el resultado buscado. Las Job Stories son una referencia útil, no una estructura obligatoria: el marco puede respetar definiciones de producto expresadas de otras maneras sin deformarlas ni reducir su alcance.
Una síntesis propia
Lo que busqué no fue reunir estas influencias, sino convertirlas en un sistema de decisión verificable.
Sus diez principios conectan el progreso humano con la experiencia, la atención, la confianza, la continuidad y el control. El fundamento de producto establece qué debe construirse y por qué. La doctrina para inteligencia artificial distingue aquello que admite generación de lo que requiere certeza. Las pruebas de aceptación exigen evidencia de que la persona pudo avanzar, no solo software correcto o una interfaz terminada.
Así, el manifiesto une una perspectiva humanista con una práctica concreta: comprender antes de construir, justificar cada capacidad y verificar el progreso que produce.
Lo que el manifiesto no prescribe
El marco no impone un estilo visual, una tecnología, una estructura única de PRD, una estrategia de entrega ni un framework de ingeniería. Define principios y límites que pueden traducirse a distintos métodos y herramientas sin convertir la estructura interna del sistema en trabajo adicional para la persona.
La tecnología puede ser extraordinariamente sofisticada detrás de la interfaz. Delante de ella debe permanecer una persona concentrada en aquello que quería conseguir.
Fuentes e influencias documentadas
- Acerca de Craft, Craft.
- Introducing Craft 3, Balint Orosz, 28 de noviembre de 2024.
- Your content is yours and that is more empowering than ever, Balint Orosz, 27 de noviembre de 2025.
- Designing Features Using Job Stories, Alan Klement, publicado por Intercom el 23 de diciembre de 2013.
Autoría y versiones
El manifiesto y este sitio son obra de Damián Acuña. El texto publicado corresponde al núcleo del manifiesto, versión 2.1, de septiembre de 2026.
Una versión nueva no reemplaza en silencio a la anterior: se registra qué cambió y se revisan las páginas que dependen de ella.
Software Humano y el Manifiesto
El Manifiesto es obra de Damián Acuña. Lo publica y lo cuida Software Humano, la agencia que crea productos digitales bajo esta doctrina y acepta ser evaluada con ella. Cada sitio tiene su trabajo: este explica, fundamenta y gobierna; a Software Humano le corresponde presentar su propuesta y sus productos, en su propio sitio. Por eso aquí no hay oferta comercial, y los pasajes del núcleo se leen completos solo en este sitio.
De dónde viene cada texto
El sitio distingue y rotula cada clase de contenido. El texto canónico se muestra tal como está en el manifiesto. Las explicaciones, los ejemplos y las pruebas se redactan para el sitio a partir de un pasaje identificado, que siempre se puede abrir. Las traducciones conservan la referencia al original en español, que es el que tiene autoridad. El estado técnico de la adaptación a SpecKit se muestra como un dato verificado, con su versión y su fecha.
Todo el contenido vive en archivos versionados: cada cambio queda registrado con quién lo aprobó y qué idiomas afecta.
Una iniciativa independiente
Software Humano no tiene afiliación con las empresas, herramientas ni autores que lo influyeron. La adaptación a SpecKit es una implementación de referencia independiente, sin respaldo de GitHub.
Licencias
| Material | Licencia | Qué puedes hacer |
|---|---|---|
| Texto del núcleo del manifiesto | CC BY 4.0 | Copiarlo, traducirlo, adaptarlo y compartirlo, también con fines comerciales, citando a Damián Acuña como autor, enlazando la licencia e indicando si hiciste cambios |
| Contenido editorial del sitio: explicaciones, ejemplos y textos de página | CC BY 4.0 | Lo mismo, con la misma atribución |
| Código del sitio | MIT | Usarlo, modificarlo y distribuirlo conservando el aviso de copyright y la licencia |
| Método para SpecKit (preset y herramientas) | MIT | Lo mismo |
| Los nombres «Software Humano» y «Manifiesto», y el logotipo | Reservados | No forman parte de esas licencias. Una adaptación no debe presentarse como oficial, certificada ni respaldada por Software Humano |