7 min leitura • Guide 337 of 877
Onboarding de Desenvolvedores Efetivamente
Onboarding ruim desperdiça meses de produtividade. Bom onboarding coloca desenvolvedores contribuindo em semanas. A diferença é estrutura, documentação e suporte intencional. Este guia cobre abordagens práticas para onboarding de desenvolvedores.
Timeline de Onboarding
| Semana | Foco | Objetivo |
|---|---|---|
| Semana 1 | Setup, orientação | Primeiro commit |
| Semana 2-3 | Tarefas pequenas, aprendizado | PRs significativos |
| Semana 4-6 | Trabalho em features | Trabalho independente |
| Mês 2-3 | Velocidade total | Totalmente produtivo |
Pré-Boarding
Antes do Dia 1
PREPARAÇÃO PRÉ-BOARDING
═══════════════════════
ANTES DA DATA DE INÍCIO:
─────────────────────────────────────
Administrativo:
├── Papelada de emprego
├── Equipamento pedido/enviado
├── Contas criadas:
│ ├── Email
│ ├── Slack
│ ├── GitHub/GitLab
│ ├── GitScrum
│ ├── Provedores cloud
│ └── Outras ferramentas
└── Pronto para o Dia 1
Preparação do time:
├── Buddy atribuído
├── Primeira semana agendada
├── Time informado
├── Mensagem de boas-vindas pronta
├── Tarefas de onboarding prontas
└── Sem correria no Dia 1
CHECKLIST DE EQUIPAMENTO:
─────────────────────────────────────
├── Laptop com config padrão
├── Monitores se remoto
├── Periféricos necessários
├── Setup de segurança (VPN, etc.)
├── Ferramentas de desenvolvimento instaladas
└── Pronto para trabalhar
Dia 1
Experiência do Primeiro Dia
ESTRUTURA DO DIA 1
══════════════════
MANHÃ:
─────────────────────────────────────
9:00 - Boas-vindas com gestor
├── Intro do time
├── Overview da empresa
├── Agenda da semana 1
└── Perguntas
10:00 - Introdução do buddy
├── Conhecer seu buddy
├── Tour das ferramentas
├── Canais do Slack
├── Como fazer perguntas
└── Primeiro amigo
11:00 - Setup de contas
├── Verificar todos os acessos
├── Gerenciadores de senha
├── Setup de 2FA
├── Resolver problemas
└── Pronto para trabalhar
TARDE:
─────────────────────────────────────
13:00 - Setup de desenvolvimento
├── Clonar repos
├── Executar scripts de setup
├── Ambiente local
├── Build e rodar
├── Buddy ajuda
└── Ambiente funcionando
15:00 - Primeira tarefa
├── Tarefa pequena, alcançável
├── Label good-first-issue
├── Buddy disponível
├── Baixa pressão
└── Primeiro PR possível
16:30 - Check-in do Dia 1
├── Como foi o dia?
├── Algum blocker?
├── Perguntas?
├── O que tem amanhã?
└── Terminar positivo
Semana 1
Orientação e Setup
SEMANA 1 - FOCO EM FUNDAÇÃO
═══════════════════════════
OBJETIVOS:
─────────────────────────────────────
• Ambiente de desenvolvimento funcionando
• Codebase compilando/rodando
• Primeiro commit/PR
• Conhecer membros do time
• Entender fluxo básico de trabalho
AGENDA TÍPICA:
─────────────────────────────────────
Dia 1: Welcome, setup inicial
Dia 2: Terminar setup, walkthrough code
Dia 3: Arquitetura overview
Dia 4: Primeira tarefa (pair)
Dia 5: Primeira PR, retrospective
CHECK-INS:
─────────────────────────────────────
• Diário com buddy (30 min)
• Meio da semana com manager
• Final de semana retrospective
ARMADILHAS A EVITAR:
─────────────────────────────────────
✗ Jogar em tarefa complexa dia 1
✗ Deixar sozinho sem suporte
✗ Esperar perfeição imediata
✗ Meetings demais, código de menos
Documentação para Onboarding
O que Documentar
DOCUMENTAÇÃO ESSENCIAL:
┌─────────────────────────────────────────────────────────────┐
│ │
│ GETTING STARTED: │
│ • Setup de ambiente passo a passo │
│ • Problemas comuns e soluções │
│ • Como rodar localmente │
│ • Como rodar testes │
│ │
│ ARQUITETURA: │
│ • Diagrama high-level dos sistemas │
│ • Fluxo de dados principal │
│ • Serviços e suas responsabilidades │
│ • Decisões arquiteturais (ADRs) │
│ │
│ PROCESSOS: │
│ • Como criar PR │
│ • Code review guidelines │
│ • Definition of done │
│ • Como fazer deploy │
│ │
│ QUEM SABE O QUÊ: │
│ • Especialistas por área │
│ • Quem perguntar sobre o quê │
│ │
│ ATUALIZAR: │
│ Novos contratados devem atualizar docs quando encontram │
│ informação desatualizada ou faltando │
└─────────────────────────────────────────────────────────────┘
Sistema de Buddy
Responsabilidades do Buddy
PAPEL DO BUDDY DE ONBOARDING:
┌─────────────────────────────────────────────────────────────┐
│ │
│ SEMANA 1: │
│ ───────── │
│ • Check-ins diários de 30 min │
│ • Pair em setup de ambiente │
│ • Responder TODAS perguntas (sem "pergunta boba") │
│ • Apresentar membros do time │
│ • Review minucioso do primeiro PR │
│ │
│ SEMANA 2-4: │
│ ─────────── │
│ • Check-ins 3x por semana │
│ • Pair em tarefas complexas │
│ • Explicar contexto e história do time │
│ • Dar feedback sobre código e processo │
│ • Ajudar navegar a organização │
│ │
│ MÊS 2-3: │
│ ───────── │
│ • Check-ins semanais │
│ • Disponível para perguntas │
│ • Ajudar com desenvolvimento de carreira │
│ • Gradualmente reduzir envolvimento │
│ │
│ ALOCAÇÃO DE TEMPO DO BUDDY: │
│ Semana 1: ~50% do tempo │
│ Semana 2-4: ~25% do tempo │
│ Mês 2-3: ~10% do tempo │
└─────────────────────────────────────────────────────────────┘
Métricas de Onboarding
Medindo Sucesso
MÉTRICAS DE EFETIVIDADE:
┌─────────────────────────────────────────────────────────────┐
│ │
│ MÉTRICAS DE TEMPO: │
│ ────────────────── │
│ • Tempo até primeiro commit │
│ • Tempo até primeiro PR merged │
│ • Tempo até trabalho independente │
│ • Tempo até produtividade total │
│ │
│ ALVOS: │
│ ──────── │
│ • Primeiro commit: Dia 1-3 │
│ • Primeiro PR merged: Semana 1 │
│ • Trabalho independente: Semana 4 │
│ • Produtividade total: Mês 2-3 │
│ │
│ MÉTRICAS DE QUALIDADE: │
│ ────────────────────── │
│ • Satisfação do novo contratado (survey) │
│ • Feedback do buddy/manager │
│ • Atualização de docs de onboarding │
│ • Retenção 90 dias │
│ │
│ MELHORIA CONTÍNUA: │
│ ─────────────────── │
│ • Retrospective de onboarding (30 dias) │
│ • Melhorar docs baseado em feedback │
│ • Cada cohort melhor que anterior │
└─────────────────────────────────────────────────────────────┘
Melhores Práticas
Checklist de Implementação
CHECKLIST DE ONBOARDING
═══════════════════════
PRÉ-BOARDING:
☐ Equipamento pronto
☐ Contas criadas
☐ Acessos provisionados
☐ Buddy atribuído
☐ Primeira semana agendada
DIA 1:
☐ Welcome meeting
☐ Tour de ferramentas
☐ Setup de ambiente iniciado
☐ Primeira tarefa identificada
☐ Check-in final do dia
SEMANA 1:
☐ Ambiente funcionando
☐ Primeiro commit/PR
☐ Architecture overview
☐ Conhecer time
☐ Retrospective semana 1
MÊS 1:
☐ Contribuindo independentemente
☐ Entende processos do time
☐ Feedback regular
☐ Áreas de melhoria identificadas
Onboarding bem feito paga dividendos por toda a permanência do desenvolvedor no time.