Contexto
CLAUDE.md e CoreConfig definem gravidade, stack, padrões e autoridade antes de qualquer execução.
30setup
Determinismo Progressivo
O ponto não é a IA ser inteligente. É travar a IA no caminho certo, etapa por etapa, até a qualidade subir.
30→60→90progressão de acurácia
5etapas de amarração
3gates principais
Mapa da aula
Use este mapa para entender a sequência da aula antes de entrar nos detalhes.
Legenda de coresO que cada cor sinaliza nesta aula
Trava inicialCLAUDE.md, CoreConfig e PRD reduzindo espaço para invenção
Gate de confiançaQA, CodeRabbit e revisão externa aumentando a régua
Bloqueio finalCI/CD, PR e repositório impedindo regressão antes de publicar
Abstração soltaa LLM preenchendo lacunas sem critério externo
Como ler o 30 → 60 → 90
1. 30A própria IA revisa e corrige o óbvio.
2. 60QA e revisão externa aumentam a chance de pegar erro real.
3. 90CI/CD, repo e gates automatizados travam a entrega antes de publicar.
4. ProgressivoNenhum gate resolve tudo sozinho. A força está no empilhamento.
O que é (em linguagem simples)
Determinismo progressivo = a IA vai sendo presa no caminho certo, e a cada trava a qualidade sobe.
Determinismo
Forçar coisas fixas (specs, validações) em vez de deixar a IA inventar.
Progressivo
Trava por trava, etapa por etapa, a qualidade sobe a cada uma.
Abstração (o inimigo)
A LLM quer 'preencher os espaços em branco' do jeito dela. O determinismo fecha esses espaços. [SOURCE: L1335]
IA solta
- Prompt aberto demais.
- Sem PRD, sem Story, sem aceite.
- A própria IA decide o que é suficiente.
- Erro aparece tarde, quando já virou retrabalho.
IA com determinismo
- Contexto amarrado desde CLAUDE.md e CoreConfig.
- Story validada antes do Dev.
- Gates empilhados: self-healing, QA e CI/CD.
- Erro aparece cedo, barato e corrigível.
Onde o determinismo começa
O travamento não começa no código. Começa lá atrás, na configuração.
Escopo
PRD, épicos e Stories dizem o que será construído, em qual ordem e com qual aceite.
60story
Gate
Validate Story Draft, QA, CodeRabbit e CI/CD conferem o trabalho antes de publicar.
90merge
A amarração de contexto: cada etapa adiciona uma trava [SOURCE: L2899-2919]
1
CLAUDE.md
as leis que regem o ambiente (a gravidade)
2
core-config
a stack, code standard, sourcing definida
3
PRD
o que vai ser construído
4
Épicos → Stories
decomposição executável
5
Validate Story Draft
valida ANTES de executar
A progressão 30 → 60 → 90
A cada gate de qualidade, a acurácia sobe. Cada gate soma confiança.
Self-healing (selfie)
QuemDev
Acurácia~30%
O que fazIA revisa o próprio trabalho antes do checklist [SOURCE: L2265]
Review
QuemQA
Acurácia~60%
O que fazQA aciona CodeRabbit, análise mais pesada [SOURCE: L2899-2919]
CI/CD
Quemrepositório
Acurácia~90%
O que fazCodeRabbit em staging + produção [SOURCE: L2657, L2869]
Snapshot da progressão
Mesmos gates da tabela: self-healing, QA Review e CI/CD.
30 -> 60 -> 90
| Gate | Self-healing | QA Review | CI/CD | Clareza gerada |
|---|---|---|---|---|
| Acurácia inicialprimeira trava | 30 | 60 | 90 | Suficiente para iterar, insuficiente para publicar. |
| Confiança de reviewcritério externo | 30 | 60 | 90 | QA e CodeRabbit reduzem abstração antes do PR. |
| Bloqueio finalantes do merge | 30 | 60 | 90 | CI/CD e PR travam regressão antes de produção. |
Por que somar gates?Sozinho, o self-healing pega o óbvio (30%). Empilhado com QA (60%) e CI/CD (90%), o resultado final é muito mais confiável que qualquer gate isolado. CodeRabbit adiciona +60-70% de filtro de qualidade só por existir. [SOURCE: L799, L927-929]
O mesmo código fica melhor quando passa por mais portões
Determinismo progressivo não é teoria, é o que acontece quando o trabalho deixa de depender de uma resposta única da IA.
Um aluno comum olha para o 30 → 60 → 90 e pensa que é número técnico. Não é. É uma forma de enxergar confiança. A primeira versão da IA pode estar útil, mas ainda está abstrata. Quando ela passa por self-healing, QA e CI/CD, a mesma entrega deixa de ser chute bonito e vira artefato mais preso na realidade.
De resposta bonita para entrega travada
A saída inicial parecia boa, mas só virou confiável depois de passar por gates empilhados.
Começou comoCódigo gerado por IA com aparência de pronto.
VirouEntrega revisada por self-healing, QA e CI/CD.
ProvaCada portão remove uma camada de abstração: primeiro o óbvio, depois o risco, depois a regressão.
LiçãoConfiança não nasce do primeiro output. Nasce do caminho que o output atravessou.
130Self-healing pega o óbvio.
260QA e CodeRabbit revisam com mais peso.
390CI/CD e PR travam antes de publicar.
- Cada portão remove uma camada de abstração: primeiro o óbvio, depois o risco, depois a regressão.
- Confiança não nasce do primeiro output. Nasce do caminho que o output atravessou.
- A pergunta certa é: por quais portões isso passou?
- 30: Self-healing pega o óbvio.
- 60: QA e CodeRabbit revisam com mais peso.
- 90: CI/CD e PR travam antes de publicar.
menos opinião, mais portão
1
Output nasce
A IA entrega algo plausível.
2
Gate reduz abstração
Cada revisão força critério externo.
3
Artefato fica confiável
A entrega deixa de ser só uma resposta bonita.
O que é um Quality Gate
Portão de entrada e saídaQuality Gate = um portão que só deixa passar se o critério foi cumprido. Pode acontecer em nível de task OU de workflow. O CodeRabbit está em todos eles, muitas vezes silenciosamente. [SOURCE: L1623-1629, L927-929]
A metáfora do relógioO AIOX é montado peça com peça como um relógio: se uma etapa falha, o relógio fica capenga. Cada gate é uma engrenagem; uma falha desincroniza o todo. [SOURCE: L1071-1072]
Quantos gates essa entrega precisa atravessar antes de eu confiar nela?
O número de gates é função do risco, não da pressa. Cada gate remove uma camada de abstração.
~30% basta
É rascunho local, reversível, sem ninguém dependendo?
signal
Suba para ~60%
Vai para review ou outra pessoa vai usar?
bench
↓ ↓ ↓
Exija ~90%
Vai para produção / merge / usuário real?
pain
↓ ↓ ↓
Por quantos portões isso passou, e quem moveu cada um?
Se passou por zero ou um gate, ainda é abstração da IA, não entrega confiável.
Self-healing da própria IA pega o óbvio. Suficiente para iterar.É rascunho local, reversível, sem ninguém dependendo?
Adicione QA + CodeRabbit. Bugs óbvios filtrados antes do humano.Vai para review ou outra pessoa vai usar?
CI/CD + PR + self-healing. Trave a regressão antes de publicar.Vai para produção / merge / usuário real?
Glossário sem jargão
Determinismo progressivo
Travar a IA etapa por etapa, com a qualidade subindo a cada gate.
Quality Gate
Portão que só deixa passar o que tem qualidade suficiente.
Self-healing (selfie)
A IA revisa e corrige o próprio trabalho automaticamente (~30%).
CI/CD
Workflows de teste automático para staging e produção (gate de ~90%).
Faça agora (2 minutos)
Conte os gates do seu último trabalho com IA.
Diagnóstico rápido de determinismo
Use quando uma entrega parece pronta, mas você não sabe por quais gates ela passou.
listar artefato→contar gates→classificar risco→adicionar gate→revalidarListar— Qual artefato foi produzido e para que serve?Contar— Passou por self-healing, QA, teste, CodeRabbit, CI/CD?Risco— Se passou por zero ou um gate, ainda está abstrato demais.Adicionar— Adicione o menor gate útil antes de escalar.
Exemplo preenchido: classificar uma entrega recente
ArtefatoUma Story implementada com IA que parece pronta, mas ainda não foi revisada.
Gates encontradosSelf-healing do @dev rodou. QA ainda não entrou. PR ainda não existe.
LeituraA entrega está na faixa inicial do determinismo. Boa para iterar, fraca para publicar.
Próximo gateMover para Review, acionar QA + CodeRabbit e registrar achados antes do PR.
DecisãoSó tratar como pronta depois de CI/CD e PR, porque produção exige a faixa final da progressão.
Portão da aulaVocê entendeu determinismo progressivo quando consegue apontar onde a IA foi travada, por quem e antes de qual risco.
- Abra um trabalho recente que você fez com IA.
- Conte: quantos 'gates' ele passou? (auto-revisão? revisão de QA? teste no repositório?)
- Se passou por zero gates, ele está em ~0% de determinismo (pura abstração da IA).
- Adicione UM gate (peça uma auto-revisão, ou rode um lint) e veja a diferença.
Funcionou se
- Você consegue dizer em que % de determinismo seu trabalho estava.
- Você adicionou pelo menos 1 gate e percebeu a melhora.
Bloco de código: travas que sobem o determinismo
A sequência de gates que leva a IA de 30 para 90, fechando os espaços em branco.
01determinismo_30:02tem: "CLAUDE.md + core-config" # ambiente e stack fixos03determinismo_60:04adiciona: "PRD + Epicos + Stories" # o que construir, decomposto05determinismo_90:06adiciona: "Validate Story Draft" # valida ANTES de executar07efeito: "a IA para de preencher o espaco em branco do jeito dela"