
Jogo de quebra-cabeça com gatos sai em três dias com agente de IA como QA
Um jogo de gatos feito em três dias
O desenvolvedor Błażej Kustra, engenheiro de Developer Relations na Software Mansion, relata como criou o Purrkour, um quebra-cabeça de "parkour" com gatos em um tabuleiro 5x5. O objetivo é colocar todos os gatos em caixas, pulando sobre outros gatos, plantas e caixas ocupadas. Segundo o texto, a primeira versão foi feita em três dias: o primeiro commit foi em 21 de julho de 2026 e a versão 1.0.0 ficou pronta para a App Store em 23 de julho, com anúncios, política de privacidade, configuração do EAS e publicação web, em 15 commits.
Renderização com WebGPU dentro do Expo
O jogo inteiro é renderizado com WebGPU dentro de um app Expo, sem arquivos de imagem, modelos 3D ou áudio. Gatos, cães, plantas, novelos e caixas são geometria procedural de baixo polígono, feita com cubos e pirâmides em TypeScript. A trilha e os efeitos de miado são gerados ao vivo por osciladores, por meio da react-native-audio-api.
O autor queria testar a tese de que um jogo 3D renderizado na GPU pode ser um app Expo comum, com uma base de código para App Store e web, sem motor de jogo nem código gráfico nativo. A escolha foi preferida a Unity ou Godot porque a lógica, o renderizador e a interface ficariam em TypeScript, compartilhando código com um site. O TypeGPU compila funções tipadas para WGSL, e o mesmo código roda no Chrome e no iPhone via react-native-webgpu (Dawn). Segundo o texto, o Expo SDK 57 na New Architecture (React Native 0.86) funcionou com todos os módulos nativos sem contornos.
Arquitetura: um motor e duas cascas
As regras, o solver, os níveis, a renderização e o áudio ficam no pacote packages/engine, com cerca de 3,4 mil linhas de TypeScript. O app Expo e o site em Vite são cascas finas ao redor dele. A plataforma é injetada: um contexto de canvas WebGPU, uma fábrica de AudioContext e um armazenamento tipo localStorage, que usa MMKV no celular e localStorage na web. Segundo o autor, um bug corrigido no motor é corrigido nas duas plataformas.
Níveis gerados e filtrados por um solver
O jogo tem 25 níveis. Os 10 primeiros foram feitos à mão, cada um ensinando uma ideia. Para os demais, um script gera dezenas de milhares de tabuleiros aleatórios e mantém apenas os que um solver BFS aprova. Os critérios são: poucas peças; cães necessários, pois o nível precisa ser impossível só com gatos e todo cão deve se mover na solução ótima; e uma primeira jogada não óbvia. Cada nível tem uma faixa de par, indo de uma jogada de aquecimento até um final de 20. Um teste unitário resolve novamente os 25 níveis, e por isso cada "Purrfect score" é um mínimo comprovado. Dicas mostram o próximo movimento ótimo: no celular, por anúncio premiado opcional; na web, após um intervalo de 20 segundos.
Testes com um agente que não enxerga o tabuleiro
O autor usou o Claude Code para programar, e o agente usou o Argent para jogar sozinho no simulador iOS e no Chrome, após cada alteração. O problema é que o tabuleiro é um único canvas WebGPU, sem árvore de acessibilidade. Para o agente, o jogo era apenas uma imagem, e adivinhar a posição de um gato por captura de tela era pouco confiável.
A solução foi uma ponte de depuração, presente apenas nas builds de desenvolvimento, que expõe o objeto __purrkour. Sua função cellScreen usa a mesma projeção de câmera do renderizador para indicar o ponto exato na tela de cada célula. O ciclo é: pedir ao solver o próximo movimento ótimo, localizar a célula na tela, tocar nela pelo Argent, conferir o estado com state() e checar a captura. Nas palavras do autor, o solver garante que cada nível seja resolvível, e o Argent garante que seja jogável.
Resultados e limites
Segundo o texto, o jogo mantém 120 fps, mas o autor ressalta que a carga de computação é leve, de modo que o dado serve mais como prova de que a pilha não atrapalha do que como benchmark. Ele considera o Purrkour concluído como jogo pequeno; se houver novidades, citou um editor de níveis ou um quebra-cabeça diário, já que o solver pode validar qualquer tabuleiro e calcular seu par. Seu pedido ao Expo é suporte a WebGPU no Expo Go, para testar jogos TypeGPU sem build de desenvolvimento.