Estamos construindo uma plataforma de pôquer e a IA acabou de tentar fazer o deploy da nossa infraestrutura

Construir uma plataforma de pôquer do zero significa usar muitos chapéus ao mesmo tempo. Num dia qualquer, estou pensando em lógica de jogo, requisitos de compliance, experiência do jogador, fluxos de transações financeiras e umas cem outras coisas que não têm nada a ver entre si. A IA tem sido um verdadeiro salva-vidas pra manter tudo isso sob controle.

Ela também acabou de tentar fazer o deploy da nossa infraestrutura quando eu só pedi pra escrever um parágrafo.

O contexto

A plataforma de pôquer roda em cima de uma especificação técnica detalhada — um documento vivo que cobre tudo: como o motor de cartas funciona, como o ledger rastreia os fundos dos jogadores, como o geofencing garante o jogo restrito ao Texas, como cada venue recebe sua experiência white-label. É a fundação a partir da qual tudo é construído.

Quando chegou a hora de formalizar nossa abordagem de Terraform como infrastructure-as-code, eu queria documentar a estratégia na spec. Quais padrões usaríamos, como estruturaríamos os deploys no Azure, a filosofia geral. Uma seção. Alguns parágrafos.

Pedi pra IA adicionar isso.

A IA, em vez disso, adicionou uma implementação completa e executável de Terraform.

Código legal, entrega errada

Módulos. Arquivos de variáveis. Definições de recursos. Um projeto IaC totalmente montado — encaixado dentro de um documento de especificação em markdown.

O pulo do gato? O código era de fato bom. Estrutura de módulos sólida, organização de recursos limpa, nomes de variáveis sensatos. Se eu tivesse pedido pra ela construir o setup do Terraform, teria sido um ótimo ponto de partida.

Mas eu pedi pra ela descrever a estratégia, não executá-la. Há uma diferença significativa entre "documente como a gente pretende usar Terraform" e "aqui está o Terraform". Um humano teria percebido isso. A IA, com toda a confiança, não percebeu.

Por que isso importa especialmente para uma plataforma de pôquer

Uma plataforma de pôquer tem muitas peças em movimento que precisam estar certas — não aproximadamente certas, nem certas em direção, e sim exatamente certas. Estado do jogo, entradas do ledger, regras de compliance, lógica do geofence. A spec é o contrato entre o design e a implementação. Quando algo é adicionado a ela, tem que ser intencional.

Uma IA que, prestativa, gera código e o joga dentro do documento de spec sem ser pedido não está só fazendo trabalho extra — está potencialmente corrompendo a fonte de verdade da qual tudo lá embaixo depende. Num codebase tão sensível, o raio de explosão de uma instrução mal interpretada importa.

Esse incidente específico foi de baixo risco e fácil de consertar. Mas é uma boa ilustração de algo que vale a pena ter em mente enquanto a gente constrói: a IA executa com confiança e quase nunca faz perguntas. O humano no loop existe pra fechar a brecha entre o que foi dito e o que foi realmente quisto.

O conserto e a lição

Trinta segundos pra apagar o código gerado. Mais trinta pra reescrever o prompt com restrições explícitas: "só prosa, sem blocos de código, descreva a estratégia." Na segunda tentativa, peguei exatamente o que queria.

O que fica, na prática: quando você pede pra IA fazer trabalho de documentação ou de spec, trate como se estivesse escrevendo instruções pra alguém que vai fazer exatamente o que você falar e vai interpretar qualquer ambiguidade generosamente como permissão pra fazer mais. Porque é isso que ela faz.

Seja explícito quanto ao formato. "Adicione uma seção sobre X" é ambíguo. "Adicione uma seção em prosa, sem código, descrevendo nossa abordagem pra X" não é.

Espere que ela entregue demais na direção errada. A IA tende a fazer mais, não menos. Quando a tarefa é aditiva (como atualizar uma spec), esse instinto precisa de guardrails.

Leia antes de commitar. Isso é óbvio e, de algum modo, ainda é o passo mais comumente pulado.

Estamos construindo essa plataforma em público — as vitórias, os desvios estranhos, e os momentos em que as ferramentas fazem algo inesperadamente hilário. Esse foi um desses momentos.

A IA é impressionante pra um projeto desses. E, ocasionalmente, também um pouco ansiosa demais pra ajudar.

Eu aprofundo em agentic AI, spec-driven development e como é de verdade usar IA pra construir sistemas de produção em The Salty Korean — a metodologia por trás do pôquer, sem o pôquer.

A plataforma tá avançando. Em breve tem mais.

Stay salty.