game-architecture-design
Skill de arquitetura, design review e balanceamento numerico de jogos — a camada de decisao antes de codigo de engine. Cobre selecao de paradigma (entidade rica vs data-driven vs prototipo), design de
SKILL.mdskills/66-game-architecture-design/SKILL.md
GitHubGame Architecture Design — Arquitetura, Review e Balanceamento de Jogo
Esta skill decide o que construir e por que, antes de decidir como construir em qual engine. Cobre três frentes que compartilham o mesmo público (game designer, arquiteto técnico, produtor): arquitetura de sistemas, revisão crítica de design, e modelagem numérica de balance.
Governanca Global
Esta skill segue GLOBAL.md, policies/execution.md, policies/source-driven.md,
policies/token-efficiency.md e policies/evals.md.
Conteudo denso vive em references/ — carregar sob demanda pelo assunto da task, nao a arvore inteira
de cara:
| Assunto | Arquivo |
|---|---|
| Selecao de paradigma de arquitetura (detalhe + sinais + mistura) | references/architecture-paradigms.md |
| Catalogo de sistemas de jogo (combate, skill, IA, narrativa, UI, PCG) | references/system-catalog.md |
| Dominios de design review + delegacao a subagentes + template de relatorio | references/design-review-domains.md |
| Playbooks de balance (combate/progressao, economia, PvP, recompensa aleatoria) | references/balance-playbooks.md |
| Estrutura fisica de projeto, pipeline de asset, arquitetura multiplayer de servidor | references/project-structure.md |
Esta skill e conhecimento de dominio + protocolo de review, nao um framework de workflow completo.
Combine com skills/09-orchestrator/SKILL.md para decidir a ordem de execucao numa task maior, ou use
isolada quando o pedido for so "desenhar esse sistema" / "revisar esse design" / "balancear esses numeros".
Para implementacao real em engine (Unity C#, Unreal C++), ver skills/67-game-engine-development/SKILL.md
— esta skill entrega a decisao arquitetural e os numeros; a 67 entrega o codigo que os implementa.
Quando Usar
- desenhar a arquitetura de um sistema de jogo novo (combate, skill/habilidade, IA, narrativa, UI, geracao procedural, save/load, mod support) antes de escrever codigo de engine
- decidir entre paradigmas de arquitetura (orientado a dominio/entidade rica vs data-driven vs prototipo descartavel) para um projeto ou modulo especifico
- revisar criticamente um GDD, mecanica, nivel, economia, ou prototipo existente — achar o que esta fraco, arriscado, contraditorio, ou insuficientemente validado
- comparar duas direcoes de design e decidir qual seguir com evidencia, nao preferencia
- desenhar primeiro-passe de numeros de balance (dano, custo, taxa de drop, curva de XP) que precisam ser defensaveis, nao chutados
- diagnosticar um sistema de jogo ja em producao que esta desbalanceado (classe dominante, economia inflacionada, progressao murcha) e propor ajuste com simulacao
- avaliar se uma mudanca de balance proposta pelo time resolve o problema sem quebrar outra coisa
Quando Nao Usar
- escrever codigo real de Unity (C#), Unreal (C++), ou qualquer engine — usar
skills/67-game-engine-development/SKILL.md - gerar sprite, textura, modelo 3D, ou qualquer asset visual — usar
skills/17-image-generator/SKILL.mdou o pipeline de imagem/video do ambiente - decisao de UI/UX que nao e especifica de jogo (paleta, tipografia, wireframe generico) —
skills/02-ui-ux-design/SKILL.md - planejamento de produto/roadmap fora do dominio de jogo —
skills/01-po-feature-spec/SKILL.md - pedido de "só me diz se é divertido" sem nenhum material pra examinar — pedir o GDD, prototipo, ou pelo menos a descricao da mecanica antes de comecar a review
Entradas Esperadas
- para arquitetura: genero do jogo, plataforma-alvo, escopo do sistema a desenhar, restricoes de equipe (programador vs designer editando conteudo)
- para review: o material a revisar (GDD, prototipo jogavel, dados de playtest, telemetria) — sem material nenhum, so cabe review exploratoria de direcao, nao review completa
- para balance: as regras/formulas atuais (se existirem), publico-alvo, horizonte de tempo (sessao/dia/temporada), e o que "bom" significa pra esse sistema especifico
Saidas Esperadas
- arquitetura: tabela de decisao de paradigma por modulo, diagrama de camadas (dado/logica/evento), justificativa de troca quando aplicavel
- review: relatorio com decisao em jogo, baseline de evidencia (confirmado/assumido/desconhecido), achados priorizados por severidade, menor intervencao recomendada, experimento de validacao
- balance: valores concretos, tabela de fluxo (fonte/sink), script de verificacao (temporario ou simulador persistente conforme o caso), veredito com plano de validacao
Arquitetura de Sistemas — Resumo
Três paradigmas cobrem a maioria das decisões: orientado a dominio/entidade rica (regras complexas
encapsuladas — combate, calculo de dano/buff, IA com decisao complexa), data-driven (camada de
dados dirige comportamento — conteudo expansivel, fluxo, gestao simples), e prototipo descartavel
(validacao rapida sem compromisso arquitetural). A maioria dos projetos mistura os dois primeiros por
modulo. Ver references/architecture-paradigms.md para os sinais completos de selecao e os padroes
de mistura.
Sete sistemas cobrem a maior parte do escopo de gameplay: combate/acao, skill/habilidade, IA, narrativa,
UI/HUD, PCG, e multiplayer — cada um com preocupacao propria de design. Ver references/system-catalog.md
para o detalhe por sistema e references/project-structure.md para arquitetura de servidor multiplayer.
Revisao de Design — Resumo
Quatro modos, escolher o mais estreito que resolve o pedido: completa (material formal existe, cobertura total), focada (cabe na conversa, sem documento formal), exploratoria (nenhuma direcao escolhida ainda — esbocar 2-3 e um teste que as distingue), comparativa (escolher entre opcoes definidas com os mesmos criterios). Toda review nomeia o objeto, declara a decisao em jogo, constroi baseline de evidencia, e fecha com achados + menor intervencao + experimento de validacao.
Um achado util carrega seis campos — observacao, mecanismo, status de evidencia, impacto, recomendacao,
validacao — sem eles e opiniao, nao review. Severidade em tres niveis (critico, maior, menor)
apenas quando ajuda a priorizar. Ver references/design-review-domains.md para o roteiro completo dos
onze dominios de review, o protocolo de delegacao a subagentes, e o template de relatorio.
Nao converta recomendacao de design direto em estrutura de codigo — isso e trabalho da skill 67 ou do orchestrator decidindo a proxima etapa. Nao fabrique reacao de jogador ou telemetria inexistente — marcar como hipotese e propor o teste que a confirmaria.
Balanceamento Numerico — Resumo
Balance não é "sensação de estar certo" — é número com procedência. Classificar a relação entre opções antes de comparar: transitiva (mais benefício custa mais), intransitiva (valor depende do que o oponente escolheu), situacional (depende de contexto/timing), ou mista. Forçar um conjunto intransitivo numa curva de poder absoluta é o erro mais comum de balance de PvP. Igualdade numérica não é o objetivo — assimetria deliberada é aceitável quando sustenta identidade ou decisão variada.
Não aceitar um modelo só de inspeção visual — executar. Usar script de verificacao temporario pra checagem independente de uma proposta (rodar, capturar evidencia, apagar depois), ou simulador persistente pra sistema que sera ajustado repetidamente (entregar e manter a ferramenta). Cálculo inline só basta quando poucas contas independentes determinam o resultado por completo.
Checkpoint: rodar a simulação → se o resultado não bater a curva pretendida (opção dominante emergindo, intransitividade colapsando pra transitiva), ajustar o parâmetro específico apontado pela simulação → rodar de novo. Não aceitar "está próximo o suficiente" — a simulação existe justamente pra substituir esse julgamento por número.
Sistemas de aleatoriedade sempre em três camadas: probabilidade matemática, utilidade pro jogador
(limiar, perda, duplicata), e probabilidade percebida (o que a apresentação faz o jogador acreditar).
Ver references/balance-playbooks.md para o procedimento completo de cada dominio (combate/progressao,
economia, PvP/metagame, recompensa aleatoria).
Regras Duras
| Nunca | Em vez disso |
|---|---|
| Propor numero de balance sem calculo ou simulacao por tras | Rodar script de verificacao ou simulador, reportar o que foi checado |
| Forcar sistema intransitivo (contador) numa curva de poder absoluta | Classificar a relacao antes de comparar |
| Fabricar reacao de jogador ou dado de telemetria inexistente | Marcar como hipotese e propor o teste que confirmaria |
| Converter achado de design review direto em tarefa de codigo | Encaminhar para skill 67 ou orchestrator com o achado como insumo |
| Aplicar arquitetura de dominio rico a conteudo que muda toda semana | Data-driven quando quem edita e o designer, nao o programador |
| Revisar so o que da pra ver sem examinar prototipo/telemetria disponivel | Inspecionar regra/config/comportamento real antes de analisar sistema existente |
| Entregar review sem severidade nem menor intervencao recomendada | Seguir a estrutura de achado de 6 campos |
| Misturar tipos de balance (dificuldade, progressao, fairness) numa recomendacao so | Declarar o trade-off explicitamente quando os alvos conflitam |
Handoff
Recebe de
- Skill 01 (PO) — objetivo de negocio e publico do jogo, quando o pedido vem de definicao de produto
- Skill 09 (Orchestrator) — quando a task maior decide que arquitetura/review/balance vem antes de implementacao de engine
Entrega para
- Skill 67 (Game Engine Development) — decisao arquitetural e numeros de balance viram insumo pra implementacao real em Unity/Unreal
- Skill 68 (Character Animation 3D) — quando o sistema de combate/locomocao desenhado aqui precisa da animacao de personagem 3D correspondente (rig, retargeting, IA de motion)
- Skill 69 (Character Pipeline 2D) — quando a biblioteca de acoes (locomotion/combat/reactions)
desenhada aqui precisa virar
MotionPlan.jsone sprite/rig 2D - Skill 02 (UI/UX) — quando a review de design aponta problema de interface/HUD que precisa de decisao visual, nao so estrutural
- Skill 09 (Orchestrator) — achados de review viram proxima etapa do pipeline quando a task exige mais de uma skill em sequencia
Evidencia de Conclusao
- para arquitetura: tabela de decisao de paradigma por sistema, com justificativa de cada escolha
- para review: relatorio com baseline de evidencia, achados priorizados, e experimento de validacao proximo
- para balance: valores/tabelas concretos, script ou simulador (com caminho e invocacao se persistente), veredito e plano do que confirmaria ou refutaria
Fontes
Estrutura e escopo desta skill foram inspirados por Yuki001/game-dev-skills
(https://github.com/Yuki001/game-dev-skills) — repositorio pessoal sem licenca declarada
(licenseInfo: null, sem arquivo LICENSE no repositorio). Por isso, nenhum texto ou codigo foi copiado
ou parafraseado de perto: o repositorio serviu apenas como evidencia de que existe um gap real no kit
(nenhuma skill cobria arquitetura, review, ou balanceamento de jogo) e como referencia de quais topicos
uma cobertura desse dominio precisaria endereçar (paradigma de arquitetura, catalogo de sistemas de jogo,
modos de review, playbooks de balance por dominio). Todo o conteudo desta skill — texto, tabelas,
exemplos, regras — foi escrito do zero especificamente para este kit, em portugues, seguindo o formato
padrao de skill deste repositorio (frontmatter, secoes de governanca, references/ sob demanda).
Nenhum arquivo (referencia, script, template) do repositorio Yuki001/game-dev-skills foi baixado, copiado, ou adaptado.