Como usar a IA para contribuir com o core
Prepare uma alteração focada na camada correta, com contratos compatíveis, documentação alinhada e validação verificável.
Substitua os valores entre colchetes antes de enviar. Forneça os arquivos públicos relevantes da release alvo exata; use exemplos sintéticos e deixe credenciais, campanhas privadas e material proprietário fora do contexto.
O que você vai construir
Implemente uma capacidade genérica ou correção bem definida. Use um exemplo concreto de antes/depois e mantenha requisitos específicos de sistemas no próprio pacote.
Contexto para fornecer à IA
AGENTS.md, CONTRIBUTING.pt-BR.md, docs/pt-BR/development.md e arquitetura/mapa de código.
Serviço responsável, controlador de interface e testes existentes pertinentes ao comportamento.
Release pública alvo e restrições de compatibilidade ou migração.
Passo a passo
Descreva o problema do usuário e decida se pertence ao core ou ao pacote do sistema.
Confira o trabalho atual e use checkout separado quando necessário para preservá-lo.
Peça uma implementação pequena seguindo os serviços, modais, traduções e padrões visuais existentes.
Revise contratos, arquivos gerados, migrações, licenças e documentação inglês/português antes de preparar a contribuição.
Copie e adapte este prompt
Repositório: [checkout local ou repositório público]
Release alvo do host: [versão instalada/solicitada; preserve-a]
Escopo e autorização: [o que pode ser alterado/publicado]
Implemente esta alteração genérica focada: [exemplo antes/depois]. Release alvo: [versão].
Leia AGENTS.md e CONTRIBUTING.pt-BR.md, confira git status, implementação/testes responsáveis e preserve trabalho existente.
Mantenha validação, autorização e persistência nos serviços. Preserve Django/Jinja2/Datastar/JavaScript nativo/PixiJS e os modais existentes.
Preserve armazenamento local à instalação, isolamento de campanhas, recibos/revisões e notificações após commit. Não acrescente condicionais por sistema de RPG no core.
Se mudar um contrato de navegador, edite gravewright/modules/contracts/frontend.json e regenere com scripts/generate_frontend_api.py; revise fonte e arquivo gerado juntos.
Use testes focados significativos, inspecione mudanças visuais com dados sintéticos, alinhe documentação inglês/português e preserve avisos de terceiros.
Entregue diff final, comandos/resultados de validação e limitações reais. Prepare uma contribuição revisável; publique ou faça merge somente dentro da autorização desta tarefa.
Examine os arquivos reais e APIs suportadas antes de propor código. Não invente comandos, campos, endpoints ou capacidades de pacotes.
Use dados de teste descartáveis e ferramentas/caches locais à instalação. Explique requisitos sem suporte e valide o resultado com as ferramentas reais do projeto.
Entregue arquivos ou passos concretos no editor, verificações realizadas e limitações pendentes.Como validar
Execute os checks Django/node/navegador pertinentes descritos no repositório.
Revise o diff procurando dados privados, alterações sem relação, edição apenas de gerados e mudanças em migrações publicadas.
Confira traduções e comportamento visual real; use execução nativa em mudanças de Runner/instalador/updater.
Pronto quando
A mudança está na camada correta, preserva compatibilidade e dados e possui diff focado com evidências reais de validação.
Continue pela referência de módulos, API pública e guia de testes.