A especificação é o novo código-fonte.
O conhecimento tácito dos engenheiros seniores passa a artefactos explícitos. A especificação funciona como o contrato que o código implementa.
/ Thinkia · Metodologia /
Entrega de IA exponencial.
Os copilotos aceleram cada engenheiro. A alavanca exponencial está no sistema de entrega. Seis fases governadas, um Golden Spec, três níveis de risco — entrega de IA reprodutível à escala empresarial.
O teto do copiloto
Os copilotos aceleram os engenheiros. Não corrigem o sistema de entrega.
-
Sem contexto partilhado
Cada sprint começa do zero. Sem um Context Package, os agentes de IA perdem a intenção, as restrições e as decisões tomadas em cada fase anterior.
-
Geração sem governação
O código segue para produção sem rastreabilidade. Sem AI-BOM que inventarie o que foi gerado, sem classificação de risco, sem cadeia de aprovação — apenas um diff.
-
Deriva das especificações
Os requisitos dispersam-se por tickets e chats. Sem um `.spec.md` vivo, as decisões de arquitetura desaparecem e a intenção desliga-se da implementação.
-
Proliferação de modelos
Cada engenheiro escolhe uma ferramenta de IA diferente. Sem um gateway unificado não há controlo de custos, nem soberania dos dados, nem aplicação consistente de políticas.
-
O retrabalho domina
Sem metodologia, 60% do tempo vai para retrabalho e depuração do output da IA. A rapidez na geração transforma-se em lentidão na entrega.
-
Sem reprodutibilidade
Os resultados dependem de quem estava na sala, não de um sistema. O que funcionou num projeto não pode ser transferido, auditado nem escalado.
Mudança de paradigma
Deixe de escrever código. Comece a especificar a intenção.
O VibeCoding — escrita assistida por IA, prototipagem mais rápida — é o primeiro passo. O Spec-Driven Development é o seguinte. A mesma IA, agora a operar sobre um sistema de entrega governado e partilhado por toda a equipa.
Os quatro pilares
-
-
A revisão é a atividade central.
O tempo do engenheiro passa de escrever código para o validar, subindo de 20% para 50% do seu tempo.
-
A arquitetura é concebida para ser legível por agentes.
Os padrões e convenções são guardados em artefactos versionados, em vez de ficarem apenas nas conversas.
-
A governação está integrada no fluxo.
Os quality gates, a prevenção de perda de dados (DLP) e a rastreabilidade estão incorporados nas fronteiras do processo, e não em camadas separadas.
Percurso de maturidade
O percurso do software assistido por IA.
Nem todas as organizações partem do mesmo ponto. O desenvolvimento de software assistido por IA tem cinco etapas de maturidade — e saber onde está define o que deve fazer a seguir.
-
Desenvolvimento tradicional
O software é construído manualmente, com controlo total mas a um custo elevado.
-
VibeCoding
O software é gerado depressa… mas sem controlo nem consistência.
-
Coding 3.0
O software é acelerado com IA, mas continua a depender do programador.
-
Spec-Driven Development
O software é definido através de intenção estruturada dentro de um quadro de regras.
-
Destino Enterprise AI-SDLC
O software é orquestrado como um sistema governado de regras, specs e capacidades.
O salto crítico: do VibeCoding ao Spec-Driven
O maior erro das organizações é confundir VibeCoding com transformação. Gerar código depressa sem governação cria dívida técnica à velocidade da IA. A chave não é a velocidade de geração — é a qualidade da especificação que a precede.
Enterprise AI-SDLC: o destino
Na etapa Enterprise, o software deixa de ser um produto artesanal e passa a ser o resultado governado de um sistema de regras, specs e capacidades. A IA não substitui o engenheiro — redefine o tipo de engenheiro que precisa de ser.
Seis fases
De F0 a F5 — seis fases, seis resultados assinados.
As cinco fases — Enquadramento, Especificação, Geração, Revisão, Entrega — correspondem a seis resultados assinados: de F0 a F5. Cada fase começa com o Context Package da anterior: o Golden Spec, o AI-BOM e o último Health Report.
- 1
F0 — Input Bundle
Alinhamento estratégico, refinamento do backlog, inventário de riscos e mapa de contexto. O resultado assinado é o Context Package que todos os agentes seguintes leem antes de gerar o que quer que seja.
- 2
F1 — Enquadramento do problema
Definição precisa do problema, limites do âmbito e primeira atribuição do nível de risco. Produz o System Brief `.spec.md` — o documento de intenção com base no qual opera cada agente.
- 3
F2 — Engenharia de especificações
Trabalho de especificação estruturado: decisões de arquitetura, contratos de componentes e design de interação em formato legível por máquina. Produz o Architecture Decision Record `.design.md` e a especificação de interação `.ui-spec.md` — completando o Golden Spec antes de a geração começar.
- 4
F3 — Construção
Desenvolvimento paralelo assistido por IA com base no Golden Spec. Cada unidade de código é classificada por risco (Verde / Âmbar / Vermelho), registada no AI-BOM e validada pelo quality gate de 17 pontos antes da aprovação.
- 5
F4 — QA e validação
Gates de teste estruturados: funcional, desempenho, segurança, conformidade. A biblioteca de skills executa os 17 validadores automáticos e produz um Health Report da fase antes de recolher qualquer assinatura.
- 6
F5 — Passagem para produção
Implementação, linha de base de monitorização e runbook operacional. A cadeia de cinco assinaturas fecha-se — PM, Arquiteto, Segurança, Jurídico/Conformidade, Platform Owner — tornando cada entrega rastreável de ponta a ponta.
Não é preciso adotar as seis fases de uma só vez. A maioria das equipas começa por F0 (Input Bundle) e pelo Golden Spec, e alarga o framework de forma incremental à medida que a confiança cresce.
A espinha dorsal da governação
O Golden Spec
Um artefacto obrigatório por sprint. Três ficheiros mestre que definem o que se constrói. Cinco assinaturas que confirmam que é seguro construí-lo.
O que é
O Golden Spec é a espinha dorsal da governação de qualquer projeto AI-SDLC. É criado em F0 e assinado em cada gate de fase. Sem ele, nenhum agente de IA gera — e nenhum resultado é entregue.
`.spec.md` — System Brief
A intenção do projeto num único ficheiro — objetivos, personas, restrições e requisitos não funcionais. É o que cada agente de IA lê antes de gerar o que quer que seja. O contrato entre a intenção de negócio e a execução técnica.
`.design.md` — Architecture Decision Record
Cada decisão estrutural com a respetiva justificação completa — o que foi escolhido, o que foi rejeitado e porquê. Evita a deriva da arquitetura à medida que o projeto evolui e dá à cadeia de cinco assinaturas um artefacto concreto para rever.
`.ui-spec.md` — Especificação de UI
A especificação de interação e o contrato de componentes. Define os estados de ecrã, os fluxos de utilizador e o comportamento dos componentes, para que a UI gerada por IA assente em decisões de design deliberadas e não na intuição do modelo.
AI-BOM + Health Reports
O AI Bill of Materials inventaria cada unidade de código gerada por IA com o respetivo nível de risco e estado de aprovação. Os Health Reports de fase são retratos de qualidade produzidos pelos 17 validadores da biblioteca de skills em cada gate.
A cadeia de cinco assinaturas
PM · Arquiteto · Segurança · Jurídico/Conformidade · Platform Owner. Cada gate de fase exige a cadeia completa antes de o Context Package avançar. Sem aprovações parciais, sem exceções.
Governação do risco
Três níveis. Uma política.
Cada unidade de código produzida por ou com IA recebe um nível de risco no momento da geração e é registada no AI-BOM. O nível determina quais dos 17 validadores de qualidade são executados, os revisores necessários e as evidências de auditoria que têm de existir antes de a unidade poder ser entregue.
Gerado por IA, revisto por pessoas
Unidades de baixo risco: documentação, estruturas de testes, boilerplate. Geradas livremente com base no Golden Spec, revistas por um engenheiro. Basta uma aprovação para avançar.
Assistido por IA, validado por pessoas
Unidades de risco médio: lógica de negócio, integrações de API, transformações de dados. Validadas face ao ADR `.design.md` com duas aprovações e um Health Report que confirma que todos os validadores relevantes foram aprovados.
Escrito por pessoas, apoiado por IA
Unidades de alto risco: controlos de segurança, lógica de conformidade, cálculos financeiros. Uma pessoa redige o rascunho com apoio da IA; é necessária a cadeia completa de cinco assinaturas antes de a unidade entrar no AI-BOM como aprovada.
Resultados
Como é a entrega de IA governada em produção
37–42%
Menos esforço de desenvolvimento
Medido em produção numa seguradora global face ao seu método tradicional, com a mesma qualidade. Os engenheiros dedicam o tempo à intenção e à aprovação, não ao retrabalho.
90%
Menos perda de contexto
O Context Package — Golden Spec, AI-BOM, Health Report — transporta o estado completo do projeto através de cada fase e de cada sprint.
100%
Pronto para auditoria
Cada artefacto assinado. Cada unidade gerada por IA inventariada no AI-BOM. Cada resultado de fase rastreável até um requisito de negócio.
17
Validadores de qualidade
Verificações pré-construídas que cobrem gates funcionais, de segurança, de desempenho e de conformidade — executadas automaticamente pela biblioteca de skills em cada fronteira de fase.
108
Skills validadas
Biblioteca de skills compatível com MCP, invocável por Claude, GPT-4o ou Gemini — sem integração personalizada em qualquer cadeia de ferramentas de IA compatível.
4–6 semanas
MVP da Etapa 1
O Sprint 0 demora 2–4 semanas a instalar a metodologia. O MVP da Etapa 1 é entregue em 4–6 semanas, com aplicação em CI e a cadeia de fases completa ativa.
Onde se aplica
Concebida para ambientes regulados e complexos
Serviços financeiros
Pistas de auditoria, controlos de risco de modelos e gates de conformidade integrados em cada fase — e não acrescentados a posteriori.
Saúde e ciências da vida
Os requisitos de governação de dados de doentes e de validação de software clínico são cumpridos pelo sistema de níveis de risco e pela cadeia de cinco assinaturas.
Software empresarial
As grandes equipas de engenharia que adotam IA em escala precisam de estrutura, não só de ferramentas. A metodologia dá-lhes um modelo operacional comum.
Setor público e defesa
Implementação soberana, tratamento de contextos classificados e auditabilidade total — o nível Vermelho cobre o código mais crítico.
Retalho e e-commerce
Ciclos de entrega rápidos sem risco de regressão. A construção assistida por IA no quadro Verde/Âmbar reduz o time-to-market com segurança.
Perguntas
Perguntas frequentes
O que é o VibeCoding e porque atinge um teto?
O VibeCoding é produtividade individual assistida por IA — escrever mais depressa, prototipar mais depressa — que continua a depender do contexto local de cada engenheiro. Atinge um teto porque não resolve as specs partilhadas, a classificação de risco nem a governação. O Spec-Driven Development é o passo seguinte: é a equipa, e não apenas o indivíduo, que opera com IA em cada camada do sistema de entrega.
Em que difere do Agile ou do DevOps tradicionais?
O Agile e o DevOps foram concebidos antes de o código gerado por IA ser uma realidade. O AI-SDLC acrescenta um sistema de classificação por níveis de risco, um Golden Spec de três ficheiros legível por máquina e uma cadeia de governação de cinco assinaturas concebida especificamente para artefactos gerados por IA.
Precisamos do Thinkia Pulse para usar a metodologia?
Não. A metodologia é independente da cadeia de ferramentas. No entanto, o Pulse oferece suporte nativo ao Golden Spec, à biblioteca de skills e ao gateway MCP — o que torna a adoção significativamente mais rápida.
Como funciona na prática o sistema de níveis de risco?
Na construção F3, cada unidade de código é marcada como Verde, Âmbar ou Vermelho consoante a sua criticidade para o negócio e a sensibilidade dos dados. O nível determina a cadeia de revisão: um engenheiro para Verde, duas aprovações para Âmbar, a cadeia completa de cinco assinaturas para Vermelho.
Isto é uma ferramenta ou uma metodologia?
Uma metodologia. O Enterprise AI-SDLC é um framework de governação — um conjunto de fases, artefactos e práticas de revisão. O Thinkia Pulse é a plataforma que o implementa, mas as equipas podem adotar a metodologia com as suas próprias ferramentas.
O que é o Sprint 0 e como começamos?
O Sprint 0 é um processo de onboarding estruturado em que a Thinkia mapeia o seu processo de entrega atual, instala a metodologia e produz o primeiro Input Bundle e o primeiro Golden Spec para o seu primeiro sprint AI-SDLC. Normalmente demora 2–4 semanas.
O que significa “compatível com MCP” para a biblioteca de skills?
As 108 skills da biblioteca estão empacotadas como ferramentas Model Context Protocol. Qualquer agente de IA que suporte MCP — incluindo Claude, GPT-4o e Gemini — pode invocá-las diretamente, sem integração personalizada.
Podemos adotá-la fase a fase?
Sim. A maioria das equipas começa por F0 e pelo Golden Spec e depois adota progressivamente o sistema de níveis de risco, os validadores de qualidade e a cadeia de fases completa. A metodologia foi concebida para adoção incremental — sem necessidade de uma implementação big bang.
Duas formas de começar
Comece pela estrutura.
Leia o AI-SDLC Playbook — a metodologia completa num único documento, com modelos de fase, o formato do Golden Spec e a checklist dos 17 validadores.
Ou marque uma conversa de Sprint 0. Vamos mapear o seu processo de entrega atual e mostrar-lhe exatamente onde se aplica a metodologia.