Merge na pasta que o servidor lê derruba a tela com marcadores de conflito

[!NOTE] Resumo Executivo (DEV-2026-119): Durante um merge, quem usava o sistema recebeu ParseError com unexpected token ‘«’. O servidor de desenvolvimento lia os arquivos com os marcadores de conflito no disco.


🚨 O Desafio Técnico / Contexto

O merge parou com conflito em um serviço PHP, e o php artisan serve lia essa mesma pasta. Enquanto os testes rodavam, com o conflito já resolvido mas o merge ainda aberto, a pessoa já tinha visto o erro numa tela que não tinha relação com o assunto.


💡 Principais Lições Aprendidas & Descobertas

  • 💡 PHP não tem etapa de build: o que está no disco é o que roda. Merge com conflito em pasta servida quebra o sistema na hora.
  • 💡 Faça merge com conflito esperado em uma worktree separada, e traga o resultado pronto.
  • 💡 git merge-tree –write-tree simula o merge sem tocar nos arquivos e lista os conflitos.
  • 💡 O merge limpo também merece leitura: o automático juntou duas regras para a mesma chave em um array PHP. Funcionou, porque a última vence, mas uma das linhas virou código morto.
  • 💡 Depois de um merge, confira marcadores, sintaxe, a suíte e as telas, nessa ordem.

🛠️ Especificação Técnica & Código-Chave

# Simula, sem mexer na pasta de trabalho
git merge-tree --write-tree --name-only meu-branch main

📈 Impacto no Ecossistema & Valor Prático

Merge com conflito esperado passou a ser feito fora da pasta que o servidor usa.

  • Projetos Relacionados: sistema-de-atendimento
  • Registro de Origem: _data/daily.dev-19.yml

Publicado originalmente como parte do Diário de Desenvolvimento 2026 do ecossistema Artes do Sul & Araguaci.