Como estamos construindo o Salty Poker: spec-driven development

A maior parte das plataformas de pôquer é construída do mesmo jeito que a maior parte das mãos de pôquer é jogada — rápido, no feeling, descobrindo as coisas enquanto avança. Não estamos fazendo isso.

Desde o primeiro dia tomamos uma decisão deliberada de construir essa plataforma usando spec-driven development. É uma metodologia que vem ganhando tração de verdade nos círculos de engenharia assistida por IA, e é a fundação sobre a qual tudo o que estamos construindo se apoia.

O que spec-driven development significa

Antes de uma única linha de código de produção ter sido escrita, uma especificação foi escrita primeiro. Mais de 100 páginas. Vinte e três módulos cobrindo cada domínio do sistema — infraestrutura, schema de banco de dados, contratos de API, fronteiras de serviço, controles de compliance, pipelines de CI/CD, runbooks operacionais.

A metodologia se divide em três níveis. Spec-first: uma spec completa é escrita antes de qualquer código, e depois usada para guiar o desenvolvimento. Spec-anchored: a spec permanece viva e evolui ao lado do código conforme o projeto amadurece. Spec-as-source: a spec é a única coisa que o humano toca — o código é inteiramente gerado a partir dela.

Há também um padrão de falha que vale a pena nomear: spec-once — quando uma spec lança um projeto e depois é silenciosamente abandonada à medida que o build avança. O blueprint vira uma relíquia.

Somos explicitamente projetados contra isso. Nossa spec é um documento vivo. Ela é atualizada à medida que decisões são tomadas, à medida que edge cases aparecem, à medida que a arquitetura evolui. Quando uma sessão termina, a spec reflete o que foi construído. Quando a próxima sessão começa, ela pega exatamente onde a anterior parou.

Por que isso importa para uma plataforma de pôquer

Plataformas de pôquer falham de formas previsíveis — e quase todas voltam à mesma causa raiz: atalhos tomados cedo que se acumulam em problemas sérios lá na frente.

Um sistema de wallet construído sem um ledger de partida dobrada adequado. Um game engine que não foi stress-tested para edge cases. Uma camada de compliance parafusada depois, em vez de integrada desde o primeiro dia. Uma plataforma que funciona bem com 50 jogadores e desaba com 500.

Spec-driven development é a disciplina que impede isso. Toda fronteira de serviço é definida antes de ser construída. Todo fluxo de dados é documentado antes de ser implementado. Todo requisito de compliance está na spec antes de uma única migration rodar. Não existem decisões do tipo "a gente resolve isso depois" — porque "depois" é quando os jogadores estão nas mesas.

Agentic AI como motor de execução

Estamos usando agentic AI para construir essa plataforma — e existe uma distinção importante entre isso e as ferramentas de IA que a maioria das pessoas conhece.

Agentic AI não se limita a responder perguntas ou autocompletar código. Ela executa workflows de múltiplos passos de forma autônoma dentro de limites definidos — escreve o código, roda os testes, captura a falha, corrige, commita — sem precisar de um humano supervisionando cada ação. Trabalha numa tarefa do início ao fim e devolve o controle quando chega a uma decisão reservada para um humano.

A spec é o que torna isso seguro e previsível. O agente opera a partir de uma spec definida, revisada e versionada. Cada sessão carrega um subconjunto focado de módulos — dois a quatro de cada vez — dando ao agente exatamente o contexto que ele precisa e nada que ele não precise. Cada sessão tem escopo definido. Um checkpoint é a porta para a próxima fase. Nada avança enquanto a checklist não estiver limpa.

O agente não decide o que construir. A spec decide. O agente executa.

O resultado

Uma plataforma construída com o rigor que ela merece. Cada decisão arquitetural documentada. Cada fronteira de serviço intencional. Cada requisito de compliance resolvido antes de virar problema.

É isso que estamos construindo. E você vai sentir a diferença quando jogar nela.

Eu escrevo sobre spec-driven development como metodologia — as decisões, o tooling, a estrutura de sessão, e o que isso significa além do pôquer — em The Salty Korean. Se o lado de engenharia disso te interessa, é lá que ficam as análises mais profundas.

Para mais sobre a metodologia: Using Spec-Driven Development with Claude Code, do Heeki Park.

Stay salty.