Agência de software · Engenharia
Integração de desenvolvedor a um projeto de cliente
Leve rápido um desenvolvedor que entra em um projeto em andamento até a primeira mudança mesclada, sem perder dias com acessos e instalação. O cliente aprova o novo integrante e libera os acessos por um link público, e o trabalho do sprint fica travado até o líder de engenharia confirmar que o desenvolvedor está pronto.
- Duração: 1 a 2 semanas
- Frequência: Sempre que um desenvolvedor entra em um projeto
- Etapas: 9 etapas
- Agentes de IA: 1 agente de IA
- Aprovações: 1 aprovação
Plano gratuito, sem cartão de crédito.
O que muda com este modelo
Sem o modelo
O desenvolvedor novo espera dias pelos acessos do cliente.
O guia de instalação está desatualizado, e cada pessoa nova perde um dia com ele.
A integração é uma ligação e um link para o repositório.
O cliente descobre que há alguém novo na equipe em uma demo de sprint.
Com o modelo
O cliente aprova e libera os acessos por um único link, antes da data de início.
Cada desenvolvedor anota as lacunas, e o guia é atualizado antes da liberação dele.
Um mentor apresenta o código ao desenvolvedor e revisa a primeira mudança dele.
O cliente aprova cada desenvolvedor novo antes de ele receber acesso.
O modelo, etapa por etapa
Cada etapa diz quem a faz: alguém da sua equipe, um agente de IA ou o cliente por um link público. Uma aprovação mantém todas as etapas seguintes travadas até ser dada.
- Feito pela sua equipe
- Feito por um agente de IA
- Feito pelo cliente, por um link público
Começa quando
Um desenvolvedor entra em um projeto de cliente em andamento, recém-contratado ou vindo de outro projeto. O gerente de projeto inicia uma execução com o nome do desenvolvedor e a data de início.
- 1
Anunciar o desenvolvedor e compartilhar o link com o cliente
Antes do dia 1Gerente de projeto · Equipe
Mande ao cliente por e-mail quem entra, a partir de quando, em qual função e com qual e-mail, e envie o link público para a aprovação dele e os acessos que ele precisa liberar.
Checklist
- O contrato permite a mudança na equipe
- Acordo de confidencialidade assinado pelo desenvolvedor
- Link público enviado ao cliente
Campos a preencher
- Nome do desenvolvedor (obrigatório)
- E-mail do desenvolvedor (obrigatório)
- Data de início no projeto (obrigatório)
- 2
O cliente aprova o desenvolvedor e libera os acessos
Antes do dia 1Contato do cliente · Link público
Pelo link público, o cliente aprova o novo integrante e libera o acesso aos sistemas dele, ou anota o que precisa acontecer antes, como o treinamento de segurança da própria empresa.
Checklist
- Acesso ao repositório de código liberado
- Acesso ao ambiente de homologação liberado
- Contas do cliente ou VPN configuradas
Campos a preencher
- Aprovação (obrigatório)
- Condições antes do acesso
- 3
Configurar os acessos e o ambiente local
Dias 1 a 2Desenvolvedor · Equipe
Aceite cada convite, monte o projeto localmente pelo guia de instalação e anote onde o guia estava errado ou incompleto. Se faltar um acesso, marque a execução como bloqueada e anote qual.
Checklist
- O app roda localmente
- Os testes rodam localmente
- A homologação e a ferramenta de tickets funcionam
Campos a preencher
- Lacunas do guia de instalação
- 4
Fazer o tour pelo código
Dias 2 a 3Mentor de integração · Equipe
Mostre ao desenvolvedor a arquitetura, os fluxos principais, o deploy e as convenções da equipe, e apresente os contatos e as reuniões fixas do cliente.
Checklist
- Arquitetura e fluxos principais explicados
- Regras de branches, revisão e versões explicadas
- Contatos e reuniões do cliente apresentados
Campos a preencher
- Temas para retomar
- 5
Entregar uma primeira mudança pequena
Dias 3 a 5Desenvolvedor · Equipe
Escolha com o mentor um ticket pequeno, desenvolva com testes e abra um pull request.
Checklist
- Ticket combinado com o mentor
- Testes incluídos
- Pull request aberto
Campos a preencher
- Link para o pull request (obrigatório)
- 6
Revisar juntos a primeira mudança
Oculto no link públicoDias 4 a 5Mentor de integração · Equipe
Revise o pull request com o desenvolvedor, explique as observações e faça o merge quando ele atender ao padrão da equipe.
Checklist
- Revisado com o desenvolvedor
- Observações explicadas
- Merge feito
Campos a preencher
- No que focar a seguir
- 7
Verificar a prontidão
Oculto no link públicoDia 5Verificador de prontidão · Agente de IA
O verificador de prontidão compara as checklists e os campos de cada etapa anterior com a lista de integração das suas instruções, lista o que ainda está em aberto e escreve um resumo curto de prontidão.
Campos a preencher
- Pontos em aberto
- Resumo de prontidão (obrigatório)
Revisão humana: O líder de engenharia resolve os pontos em aberto e confirma a prontidão na etapa 8.
- 8
Confirmar que o desenvolvedor está pronto
Oculto no link públicoDia 5Líder de engenharia · Equipe
Leia o resumo de prontidão, resolva ou planeje os pontos em aberto e confirme que o desenvolvedor pode assumir trabalho do sprint.
Checklist
- Pontos em aberto resolvidos ou planejados
- Guia de instalação atualizado com as lacunas encontradas
Aprovação: O trabalho do sprint fica travado até o líder de engenharia confirmar que o desenvolvedor está pronto.
- 9
Colocar o desenvolvedor no sprint e avisar o cliente
Semana 2Gerente de projeto · Equipe
Coloque o desenvolvedor no próximo sprint e na lista da equipe do projeto, e avise o cliente que a integração terminou.
Checklist
- Incluído no planejamento do sprint
- Incluído na lista da equipe
- Cliente avisado
Campos a preencher
- Início do primeiro sprint (obrigatório)
Termina quando
O desenvolvedor tem acessos funcionando, conhece o código e tem uma primeira mudança revisada e mesclada, e o cliente sabe quem entrou na equipe.
Deixe do seu jeito. Renomeie etapas, troque responsáveis e adicione itens de checklist, campos ou aprovações. O modelo é um ponto de partida para o jeito de trabalhar da sua equipe.
Os agentes de IA deste modelo
Um agente só trabalha nas próprias etapas, e alguém da sua equipe confere o que ele fez. Tudo o que um agente grava em um app conectado aguarda aprovação, a menos que você permita.
Verificador de prontidão
Verifica o que ainda está em aberto na integração e resume em que ponto o desenvolvedor está.
O que ele faz
- Lê as checklists e os campos de cada etapa anterior
- Compara com a lista de integração das suas instruções
- Lista os pontos em aberto e escreve um resumo curto de prontidão
- Conclui a sua etapa para o líder de engenharia revisar
Revisão humana: O líder de engenharia resolve os pontos em aberto e confirma a prontidão na etapa 8.
Perguntas que este modelo responde
Consiga primeiro a aprovação e os acessos do cliente, depois um ambiente local funcionando, um tour pelo código e uma primeira mudança pequena. Este modelo segue essa ordem, da aprovação do cliente na etapa 2 até a verificação do líder de engenharia na etapa 8.
Mire em uma mudança pequena e revisada na primeira semana, para que problemas de ambiente e lacunas de entendimento apareçam cedo. Na etapa 5 o desenvolvedor entrega uma primeira mudança pequena com testes, e na etapa 6 o mentor de integração a revisa junto com ele.
Diga ao cliente quem entra e a partir de quando, e deixe que ele aprove antes de qualquer acesso ser liberado. Na etapa 2 o cliente aprova o novo integrante e libera os acessos pelo link público, ou anota antes as condições dele.
Peça a cada desenvolvedor novo para seguir o guia ao pé da letra e anotar onde ele estava errado. Na etapa 3 o desenvolvedor anota as lacunas do guia de instalação, e na etapa 8 o líder de engenharia confere se o guia foi atualizado.
Deixe a IA verificar o que ainda está em aberto na integração e resumir, e mantenha a decisão com o líder de engenharia. Na etapa 7 o verificador de prontidão lista os pontos em aberto e escreve um resumo, e a etapa 8 é um controle de aprovação em que o líder de engenharia confirma que o desenvolvedor está pronto.
Dê a cada troca a mesma integração, com um mentor e uma verificação de prontidão, em vez de uma ligação rápida de passagem. Nas etapas 4 a 6 o mentor de integração apresenta o código ao desenvolvedor e revisa a primeira mudança dele, e a execução mostra o que foi coberto.
Execute este fluxo no OKiDO
Configure as etapas, os responsáveis e as aprovações uma vez e depois inicie uma execução para cada caso novo.