Ir para o conteúdo

Validação e Merge

Todo workflow — rápido ou estruturado — termina em validação antes de qualquer código chegar na sua branch protegida. Esse é o momento em que você testa a mudança numa execução real antes de aprovar.

A etapa de validação

Quando a execução termina, o N45 para e pede pra você validar. Você tem quatro opções:

Opção O que acontece
Rodar a aplicação O N45 inicia o runbook pra você testar ao vivo
Aprovado — pronto pra merge Segue pro merge ou PR
Encontrei um problema Dispara uma iteração de hot fix sem sair da validação
Quero um ajuste Dispara uma iteração de quick feat pra um tweak

Durante a validação, o N45 mantém o foco: ele não troca pra outros workflows mesmo se você fizer perguntas off-topic. Ele responde, e depois reapresenta as mesmas quatro opções até você aprovar.

Ajustes e correções durante a validação

Se você vê um problema, não precisa sair da validação:

  • Encontrei um problema → descreva o que está errado → o N45 diagnostica e roda uma iteração de hot fix → volta pra validação
  • Quero um ajuste → descreva a mudança desejada → o N45 roda uma iteração de quick feat → volta pra validação

São permitidas até 3 iterações por categoria. Depois disso, o N45 escala o trabalho pra um fix ou feature estruturado.

Iterações ficam confinadas à validação

Iterações vindas da validação ainda passam pelas mesmas checagens de condições. Uma mudança que exija schema migration ou novo contrato público é rejeitada e empurrada pra um fluxo estruturado após o merge.

Merge ou Pull Request

Uma vez aprovado, o N45 pergunta onde entregar:

  • Pull Request → <branch protegida> — abre um PR usando o título da spec e um resumo
  • Merge → <branch protegida> — faz merge direto na branch protegida

A lista de branches protegidas vem da configuração do seu projeto (padrão: main / master).

Pra trabalho estruturado

O título e o body do PR vêm da spec — conteúdo que você já aprovou durante a revisão da spec.

Pra hot fixes e ajustes rápidos

O título do PR é a mensagem do último commit; o body resume os arquivos modificados e o que a mudança faz.

O que vai pro commit

Origem Formato da mensagem de commit Tag
Roadmap estruturado feat(work_id): <descrição da task> (sem tag)
Quick Feat feat(escopo): <descrição> [quick-feat]
Hot Fix fix(escopo): <descrição> [hot-fix]

As tags permitem que o N45 (e você) rastreiem quais mudanças vieram de cada caminho ao gerar retrospectivas.

Veja também