Aula 4

Dicas de Ouro

Na Aula 3 aprendemos a impedir drift com Hurl e Git. Suficiente ate 50 endpoints. Mas em escala maior surge novo problema: a IA confunde suas decisoes com detalhes e sobrescreve.

Principio: Tire as decisoes do codigo. Dentro do codigo suas decisoes e detalhes de implementacao estao misturados. A IA nao distingue. Declare decisoes em specs separadas e a IA nao pode sobrescrever.

Instale yongol: “npx skills add park-jun-woo/yongol”

Para o agente: “Declare a funcionalidade Login como SSOT”

Para o agente: “Execute yongol validate e reduza erros a zero”

10 SSOT — cada um responsavel por uma preocupacao

yongol separa decisoes em 10 specs declarativas. 8 de 10 sao padroes da industria. Voce nao precisa aprender — a IA sabe.

operationId — chave que une todas as camadas

Um nome une 10 camadas. Keystone da arquitetura.

yongol validate — 287 regras pegam contradicoes

Verificacao cruzada entre 10 specs. Ferramentas existentes veem so sua camada. yongol validate ve entre camadas.

Modelo 4.5B tambem converge a zero erros

Gemma4 4.5B local, custo zero, sem internet. Funciona porque feedback do validate e fato deterministico.

Benchmark: ZenFlow — 32 endpoints em 69 minutos

11/11 etapas passaram. Velocidade nao diminui com mais funcionalidades. 47 requests Hurl, nenhum teste existente quebrou.


Curso Completo de Reins Engineering

AulaTitulo
Aula 1Como Comandar a IA
Aula 2Como Nao Confiar na IA
Aula 3O App que Nao Quebra
Aula 4Decisoes Fora do Codigo
Aula 5IA com Redeas
Aula 6Passou, Trava
Aula 7Como Reverter a Bajulacao
Aula 8A Fabrica do Agente
Aula 9Automacao Alem do Codigo
Aula 10A Lei dos Dados

Fontes de Evidencia

  • Benchmark ZenFlow — 32 endpoints em 69 min, 14 tabelas, 47 requests Hurl
  • Experimento modelos yongol agent — Grok 4.3, Gemini 2.5 Flash, Gemma4 4.5B, Qwen3 8B — todos convergem a 0 erros
  • yongol validate — 287 regras, verificacao cruzada entre 10 SSOT