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.