Desafio técnico e conversa com a equipe

Do enunciado à entrega: escopo, tempo, README, testes, commits, trade-offs e as perguntas que você faz à equipe.

Cerca de 15 min · Revisado em

Ao final, você vai conseguir

  • Diferenciar take-home, live coding, pareamento e revisão de código
  • Priorizar o escopo de um desafio e pedir prazo quando necessário
  • Preparar uma entrega com README, testes e histórico de commits claro
  • Explicar decisões como trade-offs
  • Fazer perguntas à equipe e reconhecer sinais de alerta

Em boa parte dos processos para vagas de entrada, em frontend, backend, dados, DevOps ou QA, chega a hora do desafio técnico: um pequeno projeto para fazer em casa ou um exercício ao vivo com a equipe. É a etapa em que você mais se parece com quem já trabalha ali, e por isso é a que mais conta. Nesta aula você aprende a ler o enunciado, cortar escopo, entregar algo que se explica sozinho e aproveitar a conversa final para avaliar a empresa também.

Desafio para casa ou ao vivo

Os formatos mais comuns de desafio técnico
FormatoComo éO que costumam avaliar
Take-home (para casa)Um enunciado e um prazo de alguns dias; você entrega um repositórioOrganização do código, testes, README e decisões
Live coding (ao vivo)Um exercício curto, resolvido em chamada, com alguém assistindoRaciocínio em voz alta, perguntas e testes
PareamentoVocê e alguém da equipe mexem juntos num código existenteColaboração, leitura de código e como você recebe sugestões
Revisão de códigoVocê lê um pull request e comenta o que mudariaAtenção a bugs, clareza e gentileza nos comentários

Na aula Raciocínio e comunicação você treinou o formato ao vivo. Aqui o foco maior é o take-home, que é onde mais gente perde pontos por coisas que não têm a ver com saber programar: escopo, prazo e documentação.

O enunciado diz “prazo de 7 dias, estimamos de 4 a 6 horas de trabalho”. Qual a melhor estratégia?

  • Planejar em torno de 6 horas, entregar o pedido bem feito e listar no README o que faria com mais tempo
  • Usar os 7 dias inteiros e adicionar o máximo de funcionalidades extras
  • Entregar em 2 horas para parecer rápida

Ler o enunciado e cuidar do tempo

Um enunciado de take-home, parecido com muitos reais

Desafio: consulta de CEP

Crie uma aplicação que recebe um CEP e mostra rua, bairro e cidade,
usando a API pública ViaCEP. Pode ser tela web, API ou script de linha
de comando, conforme a vaga.

Obrigatório:
- Validar o CEP (8 dígitos, com ou sem hífen)
- Tratar CEP inexistente e falha da API
- README explicando como rodar

Diferenciais:
- Testes automatizados
- Histórico das últimas buscas
- Docker

Prazo: 5 dias. Estimativa: 4 a 6 horas.

Como você priorizaria cada item desse desafio?

Fazer primeiro · Se sobrar tempo · Perguntar antes

  • Validação do CEP com e sem hífen
  • Mensagem clara quando a API falha
  • README com o passo a passo para rodar
  • Testes da validação e do erro da API
  • Histórico das últimas buscas
  • Dockerfile
  • Posso usar uma biblioteca de requisições ou devo usar só o fetch?
  • O histórico deve sobreviver ao recarregar a página?
  1. Leia duas vezes e reescreva

    Liste com suas palavras o que é obrigatório, o que é diferencial e o que não ficou claro.

  2. Pergunte cedo

    Mande as dúvidas no primeiro dia. Se não responderem, decida, e registre a decisão no README.

  3. Divida o tempo em blocos

    Por exemplo: 3 horas para o obrigatório com testes, 1 hora para o README, o restante para um diferencial. Um bloco de tempo com limite fixo se chama timebox.

  4. Deixe algo entregável o quanto antes

    Uma versão simples que funciona, com commit, no fim do primeiro bloco. Melhorias vêm depois, sem risco de ficar sem nada.

Pedir mais prazo com antecedência, quando algo real acontece

Olá, Marina, tudo bem?

Recebi o desafio na segunda e já comecei. Nesta semana tenho provas
na faculdade na quarta e na quinta. Seria possível entregar na segunda-feira,
dia 19, em vez de sexta, dia 16?

Se não for possível, entrego na sexta o obrigatório completo e deixo no
README o que faria com mais tempo.

Obrigada,
Joana

O que torna esse pedido de prazo um bom pedido?

  • Foi feito cedo, dá o motivo em uma frase, propõe uma data e oferece uma alternativa
  • Pede desculpas várias vezes e explica toda a semana em detalhes
  • Foi enviado no dia do prazo, para não incomodar antes

Uma entrega que se explica

Na aula Portfólio, carreira e IA você montou um README de projeto. O README de um desafio tem um papel a mais: responder antes as perguntas que a pessoa avaliadora faria. Ela pode ter dez desafios para corrigir na mesma tarde.

As partes que fazem diferença no README de um desafio

## Como rodar
npm install
npm test
npm run dev

## Decisões
- Validação separada da tela, em `validarCep`, para testar sem navegador.
- Sem biblioteca de requisições: o `fetch` resolve e evita dependência.

## Testes
8 testes: CEP com e sem hífen, CEP com letras, CEP inexistente e API fora do ar.

## O que ficou de fora
- Histórico de buscas: priorizei os testes do tratamento de erro.
- Com mais tempo: cache das buscas repetidas.

## Uso de IA
Usei um assistente para revisar as mensagens de erro e sugerir casos de teste. Todo o código foi lido e testado por mim.
  • Como rodar: Comandos que funcionam numa máquina limpa. Teste clonando o repositório em outra pasta antes de enviar.
  • Decisões: O que você escolheu e por quê. É daqui que sai a conversa da próxima etapa.
  • Testes: Diga o que está coberto, não só que existem testes. Mostra que você sabe o que precisava proteger.
  • Limites: O que você escolheu não fazer, e por quê. Transforma falta de tempo em prova de que você sabe priorizar.
  • Uso de IA: Muitas empresas aceitam IA e querem saber como você usou. Seja transparente e confira se o enunciado proíbe.

Qual histórico de commits ajuda mais a pessoa avaliadora a entender o seu trabalho?

  • Commits pequenos, como “feat: busca endereço pelo CEP” e “test: cobre CEP inválido”
  • Um único commit chamado “desafio pronto”
  • Vinte commits chamados “ajustes”

Prepare a entrega

Faltam duas horas para o prazo. Você terminou o README e um arquivo de testes. Confira tudo e envie.

  1. Veja quais arquivos mudaram desde o último commit.

    git status
    On branch main
    Changes not staged for commit:
      (use "git add <file>..." to update what will be committed)
    	modified:   README.md
    
    Untracked files:
      (use "git add <file>..." to include in what will be committed)
    	src/cep.test.ts
    
    no changes added to commit (use "git add" and/or "git commit -a")
  2. Rode os testes antes de salvar qualquer coisa.

    npm test
    > desafio-cep@1.0.0 test
    > vitest run
    
     ✓ src/cep.test.ts (5 tests) 12ms
     ✓ src/formatar.test.ts (3 tests) 4ms
    
     Test Files  2 passed (2)
          Tests  8 passed (8)
       Duration  640ms
  3. Adicione o README e o arquivo de testes ao próximo commit.

    git add README.md src/cep.test.ts
  4. Crie um commit com a mensagem test: cobre CEP inválido e documenta limites.

    git commit -m "test: cobre CEP inválido e documenta limites"
    [main 4e1a2c9] test: cobre CEP inválido e documenta limites
     2 files changed, 48 insertions(+), 3 deletions(-)
     create mode 100644 src/cep.test.ts
  5. Veja o histórico resumido, um commit por linha, como a pessoa avaliadora verá.

    git log --oneline
    4e1a2c9 (HEAD -> main) test: cobre CEP inválido e documenta limites
    b71d0e3 feat: mostra mensagem quando a API de CEP falha
    9c3f5a1 feat: busca endereço pelo CEP
    5d20b88 feat: valida CEP com e sem hífen
    2a8e6d4 chore: cria projeto com Vite e Vitest
  6. Envie os commits para o GitHub.

    git push
    To github.com:seu-usuario/desafio-cep.git
       b71d0e3..4e1a2c9  main -> main
Lendo só o git log acima, o que a pessoa avaliadora já descobre sobre você?

Que você começou pela estrutura, fez a validação antes da busca, tratou o erro da API e terminou com testes e documentação. É uma ordem que faz sentido, em passos pequenos. Ela entende seu processo sem abrir uma linha de código.

Apresentar decisões e trade-offs

Trade-off é exatamente essa troca: o que você ganha e o que paga com uma escolha. Na conversa sobre o desafio, uma frase com quatro partes resolve quase tudo: o que escolhi, por quê, qual é o custo e quando eu mudaria.

Um trade-off explicado em voz alta

Guardei o histórico de buscas no localStorage porque não precisava de servidor
e cabia no tempo do desafio. O custo é que o histórico não aparece em outro
aparelho. Se a pessoa precisasse disso, eu salvaria num banco, junto do login.

Na conversa, perguntam: “por que você não usou uma biblioteca de gerenciamento de estado?”. Qual resposta mostra mais maturidade?

  • “O estado era só o CEP e o resultado, então um estado local resolvia sem dependência extra. Se a aplicação crescesse para várias telas compartilhando dados, eu reavaliaria.”
  • “Porque essas bibliotecas são ruins.”
  • “Desculpa, eu deveria ter usado. Posso refazer.”

Coloque em ordem uma apresentação de cinco minutos do seu desafio.

  • O problema, em uma frase
  • Uma demonstração rápida, incluindo um caso de erro
  • As principais decisões e o porquê
  • Um trade-off ou uma falha que você encontrou
  • O que faria com mais tempo

A conversa com a equipe

Quase toda entrevista termina com “você tem alguma pergunta?”. Responda que sim. A entrevista também é a sua chance de avaliar a empresa: como ela recebe pessoas iniciantes, se existe mentoria e como é a rotina.

  • Mentoria: “Como é o acompanhamento de uma pessoa júnior nos primeiros meses?”
  • Expectativas: “O que vocês esperam de mim nos primeiros três meses?”
  • Rotina: “Como é uma semana típica da equipe?”
  • Qualidade: “Como funciona a revisão de código e os testes antes de ir para produção?”
  • Feedback: “Com que frequência as pessoas recebem feedback?”

Que respostas da empresa são bons sinais e quais são sinais de alerta?

Bom sinal · Sinal de alerta

  • “Toda pessoa nova tem alguém de referência nas primeiras semanas”
  • “Todo pull request é revisado antes de ir para produção”
  • “Fazemos conversas de feedback todo mês”
  • “Nos primeiros meses, esperamos que você aprenda o sistema com tarefas pequenas”
  • “Aqui cada um se vira sozinho desde o primeiro dia”
  • “Trabalhar no fim de semana é normal, faz parte da cultura”
  • “Não temos testes; quando quebra, corrigimos direto em produção”
  • O desafio é construir uma funcionalidade inteira do produto real, sem pagamento

Uma semana depois, chega o e-mail: você não seguiu no processo. Qual a melhor próxima ação?

  • Agradecer, pedir com educação um retorno sobre o desafio e anotar o que ouvir no seu plano de estudo
  • Responder questionando a decisão
  • Apagar o repositório do desafio

Fechamento

  • Take-home avalia organização, testes e documentação; ao vivo, raciocínio e comunicação.
  • Leia o enunciado separando obrigatório, diferencial e dúvidas, pergunte cedo e respeite a estimativa de tempo.
  • O README do desafio diz como rodar, as decisões, o que está testado, o que ficou de fora e como você usou IA.
  • Commits pequenos com mensagens claras contam o seu processo; rode os testes antes de enviar.
  • Explique escolhas como trade-offs e use as perguntas finais para avaliar mentoria, rotina e expectativas da equipe.

Entregue um desafio como se fosse valer

Pegue um enunciado de desafio da sua carreira, como o da consulta de CEP, ou um que você recebeu, e faça em um timebox de no máximo seis horas. O objetivo é praticar a entrega inteira, não só o código.

  1. Separe o enunciado em obrigatório, diferencial e dúvidas, e decida as premissas
  2. Faça o obrigatório com testes, em commits pequenos com mensagens claras
  3. Escreva o README com execução, testes, decisões, o que ficou de fora e uso de IA
  4. Clone o repositório em outra pasta e confira se roda seguindo só o README
  5. Apresente em cinco minutos para alguém e registre o feedback no seu plano de estudo

Referências

Cursos relacionados