grill-game-design
v1.1.4
Published
Skills de Game Design e Game Development para ciclos de desenvolvimento orientados por specs.
Downloads
508
Maintainers
Readme
🔥 Grill Game Design
Skill de Game Design para explorar ideias de jogos, tomar decisões de design e transformá-las em especificações verificáveis, seguindo princípios de Spec-Driven Development (SDD).
A Skill conduz o desenvolvimento do jogo em ciclos progressivos, usando as decisões registradas no projeto como contexto para orientar as próximas etapas.
Instalação
No terminal, dentro do projeto do jogo:
npx grill-game-designO instalador pergunta qual agente você está usando e instala somente a integração necessária:
- GitHub Copilot
- Claude Code
- Cursor
- Codex
Também é possível indicar diretamente:
npx grill-game-design --target copilot
npx grill-game-design --target claude
npx grill-game-design --target cursor
npx grill-game-design --target codexPara instalação global:
npx grill-game-design --scope globalUso
Depois da instalação, abra o agente no projeto e invoque:
/grill-me-game-designA Skill identifica automaticamente o ciclo atual do projeto a partir dos documentos existentes.
Ciclos
O desenvolvimento é organizado em quatro ciclos progressivos:
| Ciclo | Objetivo | | ---------------------- | ----------------------------------------------------- | | 1 — Núcleo Jogável | Transformar a ideia em um primeiro incremento jogável | | 2 — Diversão | Aprofundar mecânicas, desafio e balanceamento | | 3 — Estrutura | Desenvolver progressão, conteúdo e variedade | | 4 — Polimento | Refinar interface, arte, áudio e experiência |
Cada ciclo segue o fluxo:
Explorar
↓
Decidir
↓
Especificar
↓
Implementar
↓
Playtest
↓
Feedback
↓
Próximo cicloOs ciclos são progressivos. A Skill identifica o estado atual do projeto e conduz para a próxima etapa.
Sessões de Game Design
Internamente, a Grill utiliza diferentes dimensões de investigação:
- S0 — Fundação
- S1 — Agência do jogador
- S2 — Desafio e balanceamento
- S3 — Estrutura e progressão
- S4 — Câmera, interface e experiência
- S5 — Arte e áudio
Essas sessões funcionam como dimensões de investigação utilizadas pela Skill conforme as decisões necessárias para cada ciclo.
O que a Skill faz
A Grill:
- Explora a ideia do jogo por meio de perguntas.
- Identifica decisões de design que precisam ser tomadas.
- Registra as decisões nos documentos de contexto.
- Cria e atualiza especificações.
- Define critérios verificáveis para as Specs.
- Identifica quais Specs formam o próximo incremento jogável.
- Ao final do ciclo, sugere uma divisão das entregas entre as funções do grupo.
- Registra o estado do ciclo para orientar o próximo passo.
A Skill não gerencia o projeto nem controla as tarefas do grupo.
A divisão sugerida é apenas uma orientação. A equipe decide como o trabalho será distribuído e gerenciado.
Spec-Driven Development
A ideia central é:
IDEIA
↓
GRILL
↓
DECISÕES
↓
CONTEXTO
↓
SPECS
↓
CICLO
↓
IMPLEMENTAÇÃO
↓
PLAYTEST
↓
FEEDBACK
↓
GRILLGame Development
O pacote também inclui a Skill:
/grill-me-game-devEla utiliza os documentos de contexto, Specs e estado do ciclo para orientar a implementação.
Enquanto a Game Design explora e especifica:
O que devemos construir?
A Game Dev orienta a implementação:
Como podemos construir o que foi especificado?
Estrutura do projeto
Durante o desenvolvimento, a Skill utiliza documentos externos ao agente para manter o contexto do projeto, incluindo:
docs/
├── context/
├── specs/
├── progress-tracker.md
└── ...Isso permite que diferentes sessões e agentes compartilhem o mesmo estado do projeto.
Licença
MIT.
