Protocolo de Bug — "Declare em Voz Alta"
A pilha de computação + motor é nova e está em movimento. Cada falha recebe este protocolo. Nunca ignore um erro para manter uma campanha em andamento — um bug engolido é pior do que um estágio bloqueado. Um mecanismo confabulado (inventar por que o motor fez algo) é o pior modo de falha: os piores momentos da campanha foram eventos de reconciliação, comportamento de preço e comportamento de orçamento confabulados. Verifique, não afirme.
Precedente: um bug de implantação excessiva de totalBudget (um livro com 40% do orçamento implantado ~96% do NAV na inicialização a frio) foi pego exatamente desta forma e invalidou semanas de resultados. A lição geral é colocar em quarentena todo resultado afetado por um defeito do motor e reexecutar somente após o comportamento ser corrigido.
Os cinco passos (aplique em cada falha)
- Pare e caracterize — é configuração (minha culpa), dados (lado da fonte) ou motor (NexusTrade)? Reproduza minimamente — o menor job/backtest que ainda o exiba.
- Registre imediatamente no
CAMPAIGN_LOG.mdda execução sob um título⚠️ BUG/ISSUE: sintoma, IDs de reprodução, esperado vs observado, hipótese atual (rotulada hipótese), o que ele bloqueia. - Se for um bug real de motor/dados, escreva um documento de transferência
<NOME>_BUG.mdno diretório da execução, modelado no modelo emreferences/BUG_TEMPLATE.md(resumo de uma linha, esperado vs observado, reprodução com IDs, hipótese principal, alternativas a descartar, onde procurar, impacto nos resultados). - Coloque em quarentena os resultados afetados — marque todo backtest/estudo que foi executado antes da correção como suspeito/inválido. Reexecute após a correção. Se o bug inflacionou a alavancagem, tanto retornos QUANTO drawdowns estão inflacionados e qualquer gene de varredura que ele tocou pode ser não diferenciador — revalide tudo.
- Informe o humano, prominentemente, no chat. Bugs são um entregável co-igual do episódio com o resultado de negociação — não uma vergonha a ser contornada.
O que NÃO é um bug (falhas de sinal honesto — não registre estas)
- Uma iteração retornando
NoEligibleCandidate= um sinal honesto, não um bug. Amplie a validação; não abaixe os pisos de certificação. - Um nome morto / ainda não listado (ex.: SNDK em 2022) estando ausente ou em uma lista de rejeição sem valores fabricados = comportamento correto. O motor fabricando um valor de preço/indicador para um nome que não negociou É um bug (veja sanidade-do-motor).
- Um alvo de reconciliação de um único tick = a estratégia ao vivo acumula o restante ao longo de rebalanceamentos diários — diga isso, não o rediagnostique como um bug (veja portão-de-implantação).
Lista de verificação verifique-não-afirme
Antes de escrever qualquer alegação sobre o comportamento do motor em um entregável, apoie-a com um de:
query_backtest_events / query_portfolio_events, um conditionFieldAudit, ou uma reprodução mínima. "O motor provavelmente…" não é evidência.