prometeu-runtime/docs/runtime/pull-requests/README.md

Pull Requests

Este diretório armazena propostas de PRs arquiteturais e de implementação para o runtime.

Padrão

Toda PR neste diretório deve ser autocontida.

Cada documento deve incluir, no mínimo:

• Briefing
• Alvo
• Critérios de Aceite
• Tests, quando necessário

Barra de Qualidade

O padrão esperado é JVM-grade.

Isso implica:

• arquitetura vem antes de implementação;
• decisões arquiteturais não devem ser tomadas durante a fase de implementação;
• quando a implementação encontrar dúvida arquitetural, a PR deve voltar para discussão de arquitetura;
• diante de ambiguidade estrutural, é preferível interromper a execução da PR e levantar um questionamento severo do que cristalizar uma decisão errada no código.

Condução

Uma PR deste diretório deve:

• definir claramente o problema;
• delimitar o alvo da mudança;
• explicitar o que está fora de escopo quando houver risco de expansão;
• estabelecer critérios objetivos de aceite;
• definir a estratégia de teste proporcional ao risco da mudança.

Roadmap Publicado

PRs propostas para execucao da rodada atual:

1. PR001-spec-core-sync-16-and-16a.md
2. PR002-gfx-status-first-surface-and-fault-matrix.md
3. PR003-audio-status-first-surface-and-fault-matrix.md
4. PR004-asset-status-first-surface-and-lifecycle.md
5. PR005-abi-verifier-loader-and-stress-regeneration.md
6. PR006-conformance-regression-suite-fault-status.md

Sequenciamento recomendado:

• PR001 primeiro;
• PR002, PR003 e PR004 em paralelo;
• PR005 depois das tres verticais;
• PR006 por ultimo para consolidacao de regressao.