Sam's Blog
A mente de um artista. A disciplina de um engenheiro.
October 07, 2026
Sou artista. Também sou engenheiro de software. Ambos fazem parte do meu ADN. Pintar deu-me outra forma de explorar ideias e de cuidar dos detalhes que as fazem funcionar.
Hoje, uso IA para desenvolver todos os programas que construo para a Hearts & Colors: o nosso site e as ferramentas internas que me ajudam a gerir as nossas operações. É assim que trabalho, todos os dias. Isso dá a uma pequena empresa espaço para fazer mais.
Para os engenheiros de software, aprender a aproveitar a IA é mais do que manter-se relevante. Amplia o que podemos criar e dá-nos tempo para o trabalho que exige julgamento humano, atenção e cuidado. Na Hearts & Colors, essa oportunidade tem um propósito: mais tempo para cuidarmos uns dos outros.
Mas um código mais rápido ainda precisa de uma intenção clara. Como sabemos que o que construímos é o que pretendíamos?
A 7 de outubro, lancei o SDD, um skill para Claude Code e Codex. SDD significa desenvolvimento orientado por especificações: antes de escrever código, descreve-se o que o software deve fazer e como se vai verificar isso. Essa descrição—a especificação—torna-se o contrato para construir e testar o resultado.
Para a comunidade de desenvolvimento de software, o SDD oferece uma forma de pôr as capacidades da IA a trabalhar mantendo os engenheiros responsáveis pelo resultado. O meu skill dá ao agente um processo repetível: requisitos testáveis, aprovação humana, implementação e evidências. Você mantém o controlo.
A ideia central é que o tamanho de uma mudança e a garantia que um produto exige são duas coisas diferentes. Algumas linhas que afetam pagamentos ou direitos de acesso podem merecer mais escrutínio do que uma grande experiência. Uma demonstração rápida não deveria carregar a burocracia de uma grande migração de sistema.
Há dois controlos independentes.
O tamanho decide a burocracia. Quanto está a mudar? Isso determina a estrutura da especificação, o esforço de planeamento e os pontos de aprovação, desde uma pequena correção até um trabalho que exige documentos de design e contratos separados.
A garantia decide a prova. O que acontece se o produto errar algo? Isso determina os cenários, os casos de falha e a verificação necessária. Uma experiência pode reconhecer as suas limitações. Software que serve clientes ou afeta dinheiro e segurança precisa de provas mais sólidas.
O processo adapta-se, desde um site de uma página até um trabalho que exige garantia rigorosa.
Este primeiro lançamento é a v0. O fluxo de trabalho para pequenas mudanças funciona de ponta a ponta em todos os níveis de garantia; as mudanças em linha têm um caminho mais leve. Fluxos de trabalho maiores, revisão independente e verificação adicional de alta garantia estão no roteiro. Instalar um skill não torna um sistema conforme a um regulamento.
As especificações, aprovações e evidências de teste permanecem junto ao código. Pode começar no Claude Code e continuar no Codex; a sessão seguinte tem um registo a partir do qual trabalhar.
O amor, o cuidado e o respeito orientam a nossa arte e a forma como construímos esta empresa. No software, isso significa respeitar as pessoas que dependem daquilo que criamos. A IA pode ajudar-nos a construir mais; a nossa responsabilidade é colocar essa capacidade ao serviço das pessoas.
O SDD está disponível sob a licença MIT. Se constrói software com IA, visite o repositório, leia o guia dos dois controlos e experimente uma pequena mudança. Issues e contribuições são bem-vindas.