Ir para o conteúdo

Manifiesto

Buscar no site

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.

Ler em O manifesto

Texto canônico · tradução

Como construímos software que amplifique a capacidade das pessoas de alcançar o que buscam, sem transferir a elas a complexidade da tecnologia?

Ler em O manifesto

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.

Ler em Construir com IA

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.

Baseia-se em P03

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.

Baseia-se em P02

Texto canônico · tradução

A IA deve absorver complexidade, não produzi-la.

Ler em Construir com IA

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.

Ler em O manifesto

Texto canônico · tradução

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.

Ler em O manifesto

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.

Ler em Princípios

  1. P01 O progresso da pessoa é a unidade de design
  2. P02 A experiência também é funcionalidade
  3. P03 A complexidade pertence ao sistema
  4. P04 Simples no começo e profundo quando necessário
  5. P05 A interface não deve se tornar outra tarefa
  6. P06 A atenção é um recurso do produto
  7. P07 A confiança é projetada
  8. P08 A qualidade vive no acúmulo de detalhes
  9. P09 O tempo e a continuidade fazem parte da interface
  10. P10 A 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.

Ler em Princípios

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.

Baseia-se em P06

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.

Baseia-se em P01

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.

Baseia-se em P10

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.

Baseia-se em P07

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.

Baseia-se em P07

Texto canônico · tradução

Que circunstância ativa esta necessidade?

Que progresso ela habilita?

Que evidência o demonstra?

Ler em Guia de bolso

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.

Veja como construir com IA.

Baseia-se em SH-FUND

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.

Ler em O manifesto

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.

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.

Conteúdo