Antes, construir era caro. Isso obrigava a escolher.
Hoje, acrescentar mais uma opção leva minutos, e a pergunta sobre se vale a pena é cada vez mais fácil de ignorar. O Manifiesto da Software Humano recupera essa pergunta e lhe dá um lugar no processo em que não pode ser ignorada.
Você pode ler o percurso completo ou entrar em qualquer ponto; nada exige ter lido o que veio antes.
Construir software está cada vez mais fácil
Se construir deixou de ser o principal limite, o que passa a limitar a qualidade?
Explicação
A inteligência artificial reduziu o custo de gerar código, telas, textos e automações. Hoje, times pequenos constroem produtos que antes exigiam organizações inteiras, e uma boa decisão pode chegar às mãos das pessoas em dias.
Essa velocidade é uma oportunidade real. Ela também desloca o limite: quando construir deixa de ser a parte difícil, a dificuldade passa a ser decidir o que merece existir e qual deve ser a sensação ao usá-lo.
Como construímos software que amplifique a capacidade das pessoas de alcançar o que buscam, sem transferir a elas a complexidade da tecnologia?
Poder construir não significa dever construir
Explicação
Construir software ficou mais barato. O custo não desapareceu: passou para a pessoa que o utiliza. Ele é pago em atenção, aprendizado e decisões que ninguém veio tomar.
Quando construir é barato, uma ideia fraca se transforma rapidamente em uma implementação extensa, e uma ambiguidade de produto, em um comportamento que parece concluído. O código pode estar correto e, ainda assim, deixar nas mãos da pessoa a complexidade que o time não resolveu.
Contraexemplo
Resposta centrada no sistema. Ao enviar um formulário com um dado faltando, a página recarrega, apaga o que foi escrito e mostra “Erro de validação” na parte superior. O sistema cumpriu seu papel: rejeitou um dado incompleto. A pessoa que o utiliza tem que adivinhar o que faltou e escrever tudo novamente.
Exemplo
Resposta centrada na pessoa. O formulário preserva o que foi escrito, indica ao lado do campo o que está faltando e explica o que se espera. A regra de validação é a mesma; o que muda é quanto trabalho recai sobre a pessoa que o utiliza.
A IA deve absorver complexidade, não produzi-la.
O progresso humano é o produto
Explicação
A tese cabe em uma ideia: o produto não é o software, mas o progresso que uma pessoa alcança com ele. Por isso, a experiência não é um acabamento acrescentado ao final; ela faz parte da função.
Um sistema que entrega o resultado correto, mas obriga as pessoas a interpretar a interface, lembrar convenções ou temer errar, ainda não resolveu o problema. Apenas o transferiu.
O propósito do software é ampliar o que uma pessoa pode fazer.
As pessoas não chegam aos nossos produtos para utilizar funcionalidades. Chegam porque querem compreender, decidir, criar, aprender, comunicar-se, resolver problemas ou avançar. Esse progresso é o nosso verdadeiro produto.
Dez princípios para decidir
Explicação
Os princípios não são aspirações. Cada um tem que poder mudar uma decisão, interromper uma implementação ou exigir mais evidência; se uma frase não tem consequências práticas, ela não cumpre uma função. Cada princípio tem sua própria página, com sua tensão, seu significado, um exemplo, um contraexemplo e as perguntas para usá-lo em uma revisão real.
P01O progresso da pessoa é a unidade de designP02A experiência também é funcionalidadeP03A complexidade pertence ao sistemaP04Simples no começo e profundo quando necessárioP05A interface não deve se tornar outra tarefaP06A atenção é um recurso do produtoP07A confiança é projetadaP08A qualidade vive no acúmulo de detalhesP09O tempo e a continuidade fazem parte da interfaceP10A pessoa conserva controle e propriedade
Do princípio à decisão
Explicação
Um princípio é útil quando muda o que é feito. Há três maneiras pelas quais ele pode atuar sobre uma decisão concreta.
Exemplo
Muda uma decisão. Uma tela inicial apresenta cinco ações com o mesmo peso. Com P06 em discussão, a questão é o que a pessoa precisa naquele momento: resta uma ação principal, e as demais aparecem onde o contexto as torna relevantes.
Exemplo
Exige evidência. Uma história diz: “Como estudante, quero receber dicas para resolver derivadas”. Com P01, a pergunta é quando o bloqueio aparece e como o avanço seria reconhecido. Enquanto não houver uma observação que a respalde, a história é uma hipótese a ser testada, não um requisito.
Exemplo
Interrompe uma implementação. Um assistente reescreve textos e os publica sem pré-visualização. Com P10, a implementação é interrompida até que a pessoa possa revisar, aceitar ou rejeitar a alteração antes que ela seja publicada.
Contraexemplo
Sem o princípio. Um agente de código termina uma tarefa e responde “pronto”. Para saber o que mudou, é preciso revisar tudo e confiar no tom dele.
Exemplo
Com o princípio. O agente mostra quais arquivos alterou, o que decidiu por conta própria e como desfazer as alterações. A confiança se apoia em evidências, não no tom.
Que circunstância ativa esta necessidade?
Que progresso ela habilita?
Que evidência o demonstra?
Da doutrina ao desenvolvimento
Explicação
Os princípios se tornam prática em um método: um fundamento de produto com autoridade, as Job Stories como forma de referência, um fluxo de oito passos, artefatos que existem apenas se respondem a uma pergunta, um contrato para agentes de código, razões explícitas para parar e uma definição de conclusão que não se contenta com código correto.
Uma implementação por meio do SpecKit
Explicação
O manifesto pode ser aplicado com qualquer método. Uma implementação de referência o leva ao SpecKit: o núcleo governa uma constituição operacional, essa constituição condiciona o agente de código, e o SpecKit, adaptado sem modificar seu código, organiza a especificação, o plano, as tarefas, a análise e a implementação. Como funciona a adaptação.
Estado técnico confirmado
- É uma adaptação independente.
- Usa os mecanismos nativos de personalização do SpecKit (presets).
- Não modifica o código do SpecKit.
- Validada tecnicamente na versão 2.0.0, em 2026-09-27.
- Não é uma integração oficial nem conta com o respaldo do GitHub.
Software Humano para SpecKit está publicada: versão 2.3.2, com o preset 2.0.3, que funciona igual ao 2.0.0 com que este site foi construído.
- Ver a versão 2.3.2 no GitHub
- Como instalá-la, no README do repositório
- Checksum SHA-256 do pacote, para verificar o download:
bfb17a1fe3f5aa434c41881b8f354299385613a63d584d0fa1a43ea40d14c909
Hoje é aplicada em um único projeto real, este site. Sua validação é técnica: ainda não há evidência de uso por outros times.