Engenharia Orientada a Especificações (Desenvolvimento com IA Guiado por RFCs)

1. Visão Geral do Conceito e Problema Sistêmico

A principal armadilha para iniciantes em vibe coding é a pressa. O desenvolvedor abre um IDE agentic e imediatamente escreve no chat: "Crie uma página de carrinho de compras com códigos promocionais". O agente gera 1000 linhas de código em 15 segundos, mas:

• Utiliza um hook obsoleto em vez do state manager moderno do projeto.
• Os códigos promocionais são calculados no cliente em vez do backend (uma vulnerabilidade de segurança).
• Nomes de tipos estão duplicados e a localização foi totalmente ignorada.

Spec-First Engineering é a regra de ouro para codificação produtiva com IA: nunca toque no código sem um plano aprovado. O engenheiro atua como arquiteto-chefe, formulando um contrato abrangente (implementation_plan.md), alinhando casos extremos e somente então autorizando o agente a gerar o código.

2. Taxonomia Arquitetural e Modelo Mental

┌─────────────────────────────────────────────────────────────┐
│                 CICLO DE ENGENHARIA SPEC-FIRST              │
├─────────────────────────────────────────────────────────────┤
│ 1. Exploração de Intenção                                   │
│    • Brainstorming, Entrevista de Casos Extremos ("Grill-Me")│
│    • Definição de Anti-Objetivos (o que NÃO deve existir)   │
├─────────────────────────────────────────────────────────────┤
│ 2. Criação do Artefato de Especificação Formal              │
│    • Tipos & Contratos de Dados (interfaces TypeScript / Zod)│
│    • Mapa de Mutações de Arquivos ([NEW], [MODIFY], [DELETE])│
│    • Critérios de Verificação (comandos de testes automatizados)│
├─────────────────────────────────────────────────────────────┤
│ 3. Aprovação Humana e por Pares                             │
│    • O engenheiro revisa o plano, introduz correções        │
├─────────────────────────────────────────────────────────────┤
│ 4. Execução Autônoma Determinística                         │
│    • O agente executa o plano passo a passo sem desvios     │
└─────────────────────────────────────────────────────────────┘

3. Cenários Práticos de Engenharia em Produção

01. Entrevistando o modelo antes da feature (Padrão Grill-Me)

Antes de escrever o plano, o desenvolvedor instrui: "Quero adicionar um sistema de pagamento Stripe. Faça-me 5 perguntas rigorosas sobre processamento de webhooks, pagamentos duplicados e segurança, antes de eu escrever o plano". Isso revela problemas ocultos na fase de ideia, não em produção.

02. Proteção contra erosão arquitetural

Se o projeto for conduzido por uma equipe de três engenheiros usando agentes, todas as mudanças passam primeiro por PRs na pasta docs/specs/. A equipe visualiza a intenção antes que o modelo crie 50 novos componentes.

4. Armadilhas, Erros Comuns e Segurança

• Analysis Paralysis (Burocracia Excessiva): Escrever um plano de 20 páginas para mudar a cor de um botão é desperdício de tempo. Para edições triviais, aplica-se a regra de edição direta. A especificação é necessária para tarefas que afetam mais de 2 arquivos ou envolvem lógica de negócio.
• Drift de Plano durante a Execução (Spec Drift): Se, durante a codificação, o agente descobre um novo detalhe e altera arbitrariamente a arquitetura sem atualizar a especificação, o sistema perde controlabilidade. Exija que o agente atualize o plano diante de qualquer dificuldade imprevista.

5. Conclusão Estratégica para o Engenheiro de 2026

Em um mundo onde a geração de código custa zero centavos, a habilidade de engenharia mais valiosa deixa de ser a velocidade de digitação e passa a ser a profundidade e a precisão na formulação da especificação técnica. Quem domina a especificação, controla o sistema.