Building used to be expensive. That forced us to choose.
Today, adding one more option takes minutes, and the question of whether it is worthwhile is increasingly easy to skip. Software Humano's Manifiesto restores that question and gives it a place in the process where it cannot be skipped.
You can read it all the way through or enter at any point; nothing requires having read what came before.
Building software is becoming easier
If building is no longer the main constraint, what starts to limit quality?
Explanation
Artificial intelligence has reduced the cost of generating code, screens, copy, and automations. Today, small teams build products that once required entire organizations, and a good decision can reach people in days.
That speed is a real opportunity. It also shifts the boundary: when building is no longer the hard part, the hard part becomes deciding what deserves to exist and what using it should feel like.
How do we build software that amplifies people's capacity to achieve what they seek, without transferring the complexity of the technology to them?
Being able to build does not mean we should build
Explanation
Building software has become less expensive. The cost did not disappear: it shifted to the person using it. It is paid in attention, learning, and decisions no one came to make.
When building is inexpensive, a weak idea quickly becomes an extensive implementation, and product ambiguity becomes behavior that appears finished. The code may be correct and still leave the person to handle the complexity the team did not resolve.
Counterexample
System-centered response. When a form is submitted with missing information, the page reloads, erases what was entered, and displays “Validation error” at the top. The system fulfilled its role: it rejected incomplete information. The person using it has to guess what was missing and enter everything again.
Example
Person-centered response. The form retains what was entered, indicates next to the field what is missing, and explains what is expected. The validation rule is the same; what changes is how much work falls on the person using it.
AI must absorb complexity, not produce it.
Human progress is the product
Explanation
The thesis fits into one idea: the product is not the software, but the progress a person achieves with it. That is why experience is not a finishing touch added at the end; it is part of the function.
A system that delivers the correct outcome but forces people to interpret the interface, remember conventions, or fear making a mistake has still not solved the problem. It has only transferred it.
The purpose of software is to extend what a person can do.
People do not come to our products in order to use features. They come because they want to understand, decide, create, learn, communicate, solve problems or move forward. That progress is our real product.
Ten principles for making decisions
Explanation
The principles are not aspirations. Each one must be able to change a decision, stop an implementation, or require more evidence; if a statement has no practical consequences, it serves no function. Each principle has its own page, with its tension, meaning, an example, a counterexample, and the questions for using it in an actual review.
P01The user's progress is the unit of designP02Experience is also functionalityP03Complexity belongs to the systemP04Simple to begin with, deep when neededP05The interface must not become another taskP06Attention is a product resourceP07Trust is designedP08Quality lives in the accumulation of detailsP09Time and continuity are part of the interfaceP10The person retains control and ownership
From principle to decision
Explanation
A principle is useful when it changes what is done. There are three ways it can act on a specific decision.
Example
It changes a decision. A home screen presents five actions with the same weight. With P06 on the table, the question is what the person needs at that moment: one primary action remains, and the rest appear where the context makes them relevant.
Example
It requires evidence. A story says, “As a student, I want to receive hints for solving derivatives.” With P01, the question is when the blockage appears and how progress would be recognized. Until there is an observation to support it, the story is a hypothesis to be tested, not a requirement.
Example
It stops an implementation. An assistant rewrites copy and publishes it without a preview. With P10, the implementation stops until the person can review, accept, or reject the change before it is published.
Counterexample
Without the principle. A coding agent finishes a task and replies “done.” To know what changed, you have to review everything and trust its tone.
Example
With the principle. The agent shows which files it changed, what it decided on its own, and how to undo it. Trust rests on evidence, not tone.
What circumstance triggers this need?
What progress does it enable?
What evidence demonstrates it?
From doctrine to development
Explanation
The principles become practice through a method: an authoritative product foundation, Job Stories as the reference form, an eight-step workflow, artifacts that exist only if they answer a question, a contract for coding agents, explicit reasons to stop, and a definition of done that is not satisfied with correct code.
An implementation using SpecKit
Explanation
The manifesto may be applied with any method. A reference implementation brings it to SpecKit: the core governs an operational constitution, that constitution constrains the coding agent, and SpecKit, adapted without modifying its code, organizes the specification, plan, tasks, analysis, and implementation. How the adaptation works.
Confirmed technical status
- It is an independent adaptation.
- It uses SpecKit's native customization mechanisms (presets).
- It does not modify SpecKit's code.
- Technically validated in version 2.0.0, on 2026-09-27.
- It is not an official integration and is not endorsed by GitHub.
Software Humano for SpecKit is published: version 2.3.2, with preset 2.0.3, which works the same as the 2.0.0 this site was built with.
- See version 2.3.2 on GitHub
- How to install it, in the repository README
- SHA-256 checksum of the package, to verify the download:
bfb17a1fe3f5aa434c41881b8f354299385613a63d584d0fa1a43ea40d14c909
It is currently applied to a single real project: this site. Its validation is technical; there is no evidence yet of use by other teams.