Dois profissionais de engenharia investigando um problema juntos em uma estação de trabalho.

Do problemaa uma mudança pronta para revisão.

Dê à engenharia as evidências do cliente, o contexto do código e as decisões por trás do trabalho. Prepare mudanças e explicações para a equipe revisar antes de publicar.

Exemplos de sistemas

GitHubLinearSlackNotionGoogle Docs

Engenharia

Dê ao próximo engenheiro um ponto de partida claro.

Leve as evidências do cliente para uma proposta de correção, investigue mudanças recentes e preserve o raciocínio por trás das decisões técnicas.

01 / Revisão de código

Leve o bug até uma correção para revisão.

Leve a captura de tela do cliente para uma proposta de correção do layout, um teste de regressão e um pull request que um engenheiro possa avaliar.

Slack#engenharia

Fluxo de trabalho ilustrativo

Engenheiro

O botão de exportação fica fora da tela no celular. Use esta captura de tela do cliente para investigar o layout e preparar uma correção.

Captura de tela do cliente
MiloIA
Pronto para revisão

Registros conectados e memória da empresa revisados.

Aqui estão a correção proposta e a verificação de regressão.

Pull request propostoRevisão solicitada

Manter a exportação acessível no celular

ExportActions.css+4 −1
  .export-actions {- flex-wrap: nowrap;+ flex-wrap: wrap;  }+ .export-button {+ flex-shrink: 0;+ }
Proposta de teste de regressão

Em 320px, o botão de exportação permanece na área visível e acessível pelo teclado.

Fontes

  • SlackCaptura de tela do cliente
  • GitHubLayout da barra de exportação
  • Cérebro da empresaChecklist de lançamento para dispositivos móveis
Detalhes da revisão
SlackCaptura de tela do cliente

O botão de exportação fica fora da área visível no celular.

GitHubLayout da barra de exportação

A linha de ações não quebra em telas estreitas.

Cérebro da empresaChecklist de lançamento para dispositivos móveis

A exportação e os controles ao lado devem permanecer acessíveis em 320px.

02 / Investigação de incidentes

Comece a investigação pelo que mudou.

Milo organiza as mudanças da versão, os tickets relacionados e as notas de incidentes em uma linha do tempo, separando fatos confirmados de possíveis causas.

GitHubSlackNotion
Crie este fluxo com a gente
GitHubFluxo de trabalho ilustrativo
Incidente no checkout · eventos ilustrativos

Cronologia do incidente

  1. 09:10
    Release v2.18 implantado

    Notas da versão: tratamento de novas tentativas de pagamento alterado no PR #318.

  2. 09:18
    Primeiro relato de erro no checkout

    A conversa do plantão no Slack relata tentativas de checkout malsucedidas.

  3. 09:26
    Incidente anterior vinculado para revisão

    INC-072 descreve um timeout de pagamento; a semelhança não comprova a mesma causa.

Causa não confirmada

Compare as solicitações com falha com o PR #318 e o timeout anterior antes de propor uma reversão.

Fontes

  • GitHubVersão v2.18 · PR #318
  • SlackConversa do plantão sobre o incidente

03 / Decisões técnicas

A decisão chega ao próximo engenheiro.

Milo registra a abordagem escolhida, as alternativas descartadas e a questão pendente, e prepara atualizações vinculadas para os documentos e o ticket de engenharia.

SlackNotionLinear
Crie este fluxo com a gente
NotionFluxo de trabalho ilustrativo
Registro de decisão + atualização proposta do ticket

ADR-014 · preservar o endpoint existente

Decisão
Manter /v1/accounts para os clientes atuais.
Alternativa rejeitada
Mover todos os clientes para /v2 agora exigiria uma migração coordenada.
Ponto em aberto
Por quanto tempo ambas as versões devem continuar sendo suportadas?
Atualização proposta · ENG-218

Adicionar uma verificação de compatibilidade para os clientes atuais de /v1; deixar a data de desativação de /v1 em aberto até a decisão da equipe.

Fontes

  • SlackDecisão de engenharia
  • LinearENG-218

Engenharia

Traga o problema que sua equipe precisa reconstruir toda vez.

Fale com nosso time