Skip to content

Manifiesto

Search the site

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.

Read in The manifesto

Canonical text · translation

How do we build software that amplifies people's capacity to achieve what they seek, without transferring the complexity of the technology to them?

Read in The manifesto

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.

Read in Building with AI

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.

Based on P03

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.

Based on P02

Canonical text · translation

AI must absorb complexity, not produce it.

Read in Building with AI

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.

Read in The manifesto

Canonical text · translation

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.

Read in The manifesto

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.

Read in Principles

  1. P01 The user's progress is the unit of design
  2. P02 Experience is also functionality
  3. P03 Complexity belongs to the system
  4. P04 Simple to begin with, deep when needed
  5. P05 The interface must not become another task
  6. P06 Attention is a product resource
  7. P07 Trust is designed
  8. P08 Quality lives in the accumulation of details
  9. P09 Time and continuity are part of the interface
  10. P10 The 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.

Read in Principles

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.

Based on P06

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.

Based on P01

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.

Based on P10

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.

Based on P07

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.

Based on P07

Canonical text · translation

What circumstance triggers this need?

What progress does it enable?

What evidence demonstrates it?

Read in Pocket guide

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.

See how to build with AI.

Based on SH-FUND

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.

Read in The manifesto

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.

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.

Contents