<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

GitHub como portfólio: o que o recrutador olha

DA

7 min

GitHub como portfólio: o que o recrutador olha

GitHub como portfólio: o que o recrutador olha, os sinais de um repositório bom e como fazer o perfil contar sua história.

Neste artigo

O seu GitHub é lido por recrutador mesmo sem você junto, e os sinais que ele procura são visíveis no perfil em segundos. Um repositório arrumado fala de método; um conjunto de repositórios sem README fala de improviso. Este guia mostra o que ajustar para o perfil contar a sua história.

O recrutador olha o README, o histórico de commits e se o código roda. Um repositório com README claro, commits pequenos e um projeto de destaque transmite profissionalismo. O passo a passo para começar está no guia de Git.

O que o recrutador olha primeiro

A ordem típica é o perfil, o repositório em destaque e o README. O perfil precisa dizer quem você é e o que busca. O repositório destacado é o seu cartão de visita, e o README é o texto que faz o recrutador decidir se vale clicar mais fundo.

Os sinais de um repositório bem arrumado

Um bom repositório tem README, commits de tamanho razoável e um código que outro dev consegue rodar. O commit pequeno com mensagem descritiva conta o avanço do projeto, e o recrutador lê isso como sinais de método de trabalho, não só de habilidade.

💡 Dica: fixe um projeto no perfil que represente o seu melhor trabalho. É a primeira coisa que o recrutador vê, e um projeto bom na vitrine vale mais que dez soterrados na lista.

Como o perfil conta a sua história

O GitHub fala pela sequência dos seus projetos e pela constância dos commits. Um gráfico de atividade consistente, mesmo que suave, sinaliza trabalho contínuo. Um perfil com um pico isolado e silêncio depois não conta a mesma história de quem constrói com regularidade.

ℹ️ Info: constância vale mais que intensidade. Fazer um commit por semana em um projeto real supera um fim de semana de atividade intensa seguido de meses parado.

GitHub na sua carreira

O GitHub é o portfólio vivo que o currículo aponta. Ele se conecta com o portfólio e com a busca, porque o recrutador passa do documento para o perfil para confirmar o que leu. Um repositório limpo converte essa checagem em aprovação.

Checklist do repositório bem arrumado

Um repositório profissional se constrói em poucos passos, e a ordem importa menos que a completude. Confira item por item antes de enviar o perfil para um recrutador.

  1. Nome que já se explica: o nome do repositório descreve o projeto, não é um apelido interno.
  2. README na raiz: o que o projeto faz, como rodar e a decisão principal.
  3. Commits pequenos e descritivos: uma mudança por commit, com mensagem que conta o porquê.
  4. Projeto destacado: fixe no perfil o trabalho que melhor representa você.
  5. Instrução de execução: dependências, comando de subida e variáveis necessárias.
  6. Licença e autor: uma linha que indica quem fez e sob que termos.

💡 Dica: abra o seu perfil em uma aba anônima e tente entender cada repositório só pela listagem. O que não se explica sozinho é candidato a ganhar um README melhor ou sair da vitrine.

Os sinais que afastam o recrutador

O primeiro sinal ruim é o repositório sem descrição: o recrutador abre e não faz ideia do que é aquilo. O segundo é o commit gigante e único, com mensagem de up ou ajustes, que não conta a história do trabalho. Esses dois sozinhos passam a impressão de improviso, mesmo que o código seja bom.

Outro afastador é o código que não roda por falta de instrução. Um projeto que exige adivinhar dependência e comando transfere o esforço para quem lê, e o recrutador não vai resolver isso por você. Facilidade de execução é parte do que se avalia em um perfil público.

Por fim, o perfil que mistura projeto pessoal com exercício de tutorial, sem separar os dois, também confunde. O recrutador precisa identificar rápido qual é o seu trabalho principal. Uma organização por destaque, com os projetos fortes no topo, resolve essa leitura sem apagar o histórico.

ℹ️ Info: o recrutador raramente lê o código inteiro; ele checa amostras. O README, o histórico de commit e um trecho do código principal bastam para a primeira impressão, então esses três merecem atenção dobrada.

Esqueleto de um README que funciona

Um README eficiente responde às perguntas do visitante em uma ordem previsível, sem se alongar. O esqueleto abaixo serve como base para quase todo projeto de portfólio.

# Nome do projeto
O que o projeto resolve, em uma frase.

## O problema
Contexto de por que ele existe e quem ele atende.

## Funcionalidades
O que o sistema entrega, em itens curtos.

## Stack
Linguagem, framework e banco usados.

## Como rodar
Dependências e comandos de instalação, subida e teste.

## Decisões
A escolha de arquitetura mais importante e o porquê.

## Autor
Seu nome e o link do perfil.

O esqueleto não é para copiar à risca, e sim para lembrar que o README é uma página de entrada. Ele responde o que é, por que existe e como rodar antes de qualquer outra coisa, e é isso que o recrutador quer saber em segundos quando abre o repositório.

README claro entra na mesma conta dos commits: são ambos sinais de método que o recrutador usa para inferir como você trabalharia no time. Quem documenta a própria entrega demonstra, sem dizer, a capacidade de comunicar que o trabalho em equipe exige de todo dev.

Portfólio e preparação se encontram na entrevista: quem documenta bem chega com roteiro pronto, e o guia de entrevista técnica sem decoreba usa exatamente esse material como base.

Perguntas frequentes

Todo projeto meu precisa estar no GitHub?

Não. Só os que representam bem o seu trabalho. O perfil é uma vitrine, não um depósito de rascunho. Curadoria importa mais que volume.

Commits pequenos fazem diferença?

Sim. Commit pequeno com mensagem clara mostra como você trabalha. O recrutador lê o histórico como evidência de método.

Devo escrever README em português ou inglês?

Depende do mercado que você mira. Para vaga internacional, inglês. Para vaga local, português resolve. O essencial é existir README claro em qualquer idioma.

GitHub vazio atrapalha?

Atrapalha se você tem projetos fora dele, porque o recrutador não acha a evidência. Mesmo projetos antigos bem organizados valem mais que perfil vazio.

Devo apagar os repositórios antigos e ruins?

Pode arquivar ou tornar privado o que não representa o seu nível atual, em vez de deixar exposto. O perfil é uma vitrine, e curadoria vale mais que volume. Manter só o que agrega deixa a visita do recrutador mais direta e o seu melhor trabalho mais fácil de achar no meio da lista.

Nomes de commit em português ou inglês?

Acompanhe o idioma do seu projeto e do mercado que você mira. Para vaga internacional, o inglês ajuda; para projeto local, o português resolve. O essencial é a mensagem descrever o porquê da mudança, em qualquer idioma, porque é o histórico que o recrutador lê como evidência de método.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja todas as vagas em TI →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar

Atualizado em 06/10/2026 •

Ver perfil do autor

COMPARTILHAR