Introdução

O desenvolvimento de jogos é um dos exemplos mais claros de como o Codex pode ajudar além da geração de código. Na prática, criar um jogo costuma envolver documentar o conceito, implementar a camada de renderização, montar a estrutura do frontend, gerenciar o estado no backend, produzir recursos para o jogo e ajustar o visual continuamente.

Esse processo funciona melhor quando o Codex começa registrando exatamente como o jogo deve funcionar e depois usa a habilidade Playwright interactive para testar o jogo diretamente no navegador a cada rodada de ajustes.

Comece pelo plano do jogo

Antes de o Codex montar a estrutura inicial, peça que ele crie um arquivo PLAN.md com definições concretas para cada aspecto do jogo:

• o objetivo do jogador
• o ciclo principal do jogo
• as entradas e os controles
• as condições de vitória e derrota
• a progressão ou a dificuldade
• a direção visual
• as tecnologias e as premissas de hospedagem
• a ordem das etapas de desenvolvimento

Esse plano é importante porque o pedido “crie um jogo” é vago demais por si só. O Codex precisa saber como implementar cada parte do jogo e consultar esses detalhes com frequência durante o desenvolvimento.

Você pode ativar o modo planejamento com o comando de barra /plan. Salve o plano gerado em um arquivo PLAN.md.

Oriente o comportamento do Codex com o AGENTS.md

Para garantir que o Codex siga o plano, verifique o próprio trabalho e use as ferramentas adequadas, crie um arquivo AGENTS.md como este:

# Nome do jogo

<Type of game>

Tecnologias:

- NextJS para o frontend (hospedado na Vercel)
- <insert technology> para a renderização
- Fastify para o backend, com WebSockets (hospedado em <hosting platform>)
- Postgres para o banco de dados (hospedado em <hosting platform>)
- Redis para cache e pub/sub (hospedado em <hosting platform>)
- OpenAI para os recursos de IA generativa

Dicas:

- Assim que concluir uma funcionalidade ou tarefa, execute os comandos de build e de teste para verificar seu trabalho.
- Consulte o arquivo PLAN.md ao desenvolver novas funcionalidades.
- Registre seu trabalho na pasta .logs, incluindo seu raciocínio e suas decisões. Crie novos arquivos de log quando julgar necessário e consulte esses registros ao refinar as funcionalidades.
- Use playwright para testar o resultado visual. Faça ajustes se algo parecer errado ou destoar do estilo do jogo.
- Use imagegen para gerar os recursos visuais do jogo. Sempre que gerar uma coleção, salve os prompts usados em arquivos na pasta .prompts para poder gerar mais recursos do mesmo tipo depois.
- Use o Context7 MCP para consultar a documentação de <rendering framework>.

Com essas orientações, o Codex pode trabalhar por conta própria por bastante tempo e usar as habilidades adequadas conforme necessário.

Use as habilidades

Adicione as habilidades mencionadas no arquivo AGENTS.md:

• Imagegen para que o Codex possa gerar recursos visuais para o jogo conforme necessário
• Playwright interactive para que o Codex possa testar o jogo diretamente no navegador
• OpenAI docs para que o Codex possa consultar a documentação mais recente da API da OpenAI
• Se quiser, adicione também o servidor MCP do Context7 para consultar a documentação mais recente do framework de renderização

Saiba como adicionar habilidades na documentação de habilidades.

Deixe o Codex desenvolver e refinar o jogo

O Codex vai gerar a primeira versão do jogo com base no plano inicial.

Se houver muitas imagens para gerar, essa primeira versão pode levar algum tempo, às vezes várias horas. Como o Codex consegue testar o próprio trabalho e experimentar o jogo diretamente no navegador, ele pode continuar por bastante tempo sem precisar de novas instruções.

Quanto mais bem definido estiver o plano, melhor será o resultado da primeira iteração.

À medida que você testar o jogo, peça os ajustes necessários. Envie capturas de tela, solicite mudanças na jogabilidade ou peça ao Codex que atualize os recursos visuais até que o resultado fique como você quer.