Estratégia de Portfólio
Princípio Fundamental
Seu GitHub não é um cemitério de projetos inacabados. É uma exposição curada. Cada repositório fixado deve responder a uma pergunta que um recrutador tem sobre você — e cada resposta deve fazê-lo querer agendar uma entrevista.
O Que Separa o Impressionante do Medíocre
PORTFÓLIO MEDÍOCRE PORTFÓLIO IMPRESSIONANTE
───────────────── ────────────────────
30 repositórios, a maioria forks 5 repositórios, todos originais
Sem READMEs Cada README conta uma história
Sem demonstrações ao vivo Todo projeto está implantado
Tutoriais aleatórios clonados Tema claro e progressão
Último commit: 8 meses atrás Atividade consistente e recente
Sem descrições nos repositórios Cada repositório tem uma frase de efeito
"meu-primeiro-app-react" "Ferramenta de revisão de código com IA"
A diferença não é talento. É curadoria. Os melhores portfólios parecem de alguém com um plano, não de alguém que faz commit de tudo que toca.
Qualidade sobre Quantidade
De três a cinco projetos polidos vencem trinta repositórios abandonados. Sempre.
A Matemática que Importa
| Repositórios | READMEs | Implantados | O Recrutador Pensa |
|---|---|---|---|
| 30 | 2 | 0 | "Começa coisas, não termina" |
| 15 | 5 | 1 | "Bricoleiro. Não sabe no que é bom" |
| 5 | 5 | 4 | "Focado. Entrega. Conhece o ofício" |
| 3 | 3 | 3 | "Tudo que toca é polido" |
A Regra da Limpeza
Antes de adicionar algo novo, audite o que já está lá:
1. Arquivar ou tornar privado qualquer coisa inacabada e irremediável.
2. Excluir forks que você nunca modificou.
3. Adicionar READMEs a tudo que você manter público.
4. Definir descrições em todos os repositórios visíveis.
5. O que sobrar deve valer a pena mostrar.
Se você não colocaria no seu currículo, não deveria estar no seu GitHub público.
Conte uma História Através dos Seus Repositórios
Seus repositórios fixados não são amostras aleatórias. São capítulos. Organize-os para que um visitante veja uma narrativa.
Estruturas de História que Funcionam
O Arco do Especialista:
"Vou fundo em IA/ML e posso provar."
Repo 1: LLM ajustado para tarefa específica de domínio
Repo 2: Pipeline RAG com estrutura de avaliação
Repo 3: Fluxo de trabalho agêntico com uso de ferramentas
Repo 4: Contribuição open-source para LangChain/LlamaIndex
O Arco do Construtor Full-Stack:
"Construo produtos completos, do banco de dados à implantação."
Repo 1: Aplicativo SaaS full-stack (Next.js + API + DB + Auth)
Repo 2: Ferramenta CLI com IA (mostra habilidades de backend/sistemas)
Repo 3: Biblioteca open-source (mostra pensamento de design de API)
Repo 4: Ferramenta de automação pessoal (mostra que você constrói para si mesmo)
O Arco do Desenvolvedor Nativo de IA:
"Não apenas uso IA — construo com ela e para ela."
Repo 1: Fluxo de trabalho agêntico / sistema multiagente
Repo 2: Integração de LLM em aplicativo de nível de produção
Repo 3: Ferramenta de desenvolvedor que aproveita IA (linter, revisor, gerador)
Repo 4: Contribuição a uma estrutura ou kit de ferramentas de IA
Sinais de Progressão
Recrutadores notam quando seus repositórios mostram crescimento:
| Sinal | O Que Mostra |
|---|---|
| Repo inicial: aplicativo CRUD simples | Você começou em algum lugar |
| Repo intermediário: API com testes e CI | Você aprendeu práticas de engenharia |
| Repo recente: agente de IA com avaliações | Você está construindo na fronteira |
| Contribuição a projeto OSS importante | Você trabalha em bases de código grandes |
O Que Fixar e Por Quê
Você tem seis repositórios fixados. Use-os estrategicamente.
O Layout de Fixação Ideal
| Slot | O que Fixar | Por Quê |
|---|---|---|
| 1 | Projeto full-stack | Prova que você pode construir um produto completo |
| 2 | Projeto de IA/ML | Mostra que você trabalha na fronteira |
| 3 | Contribuição open-source | Prova que você colabora em bases de código reais |
| 4 | Ferramenta de desenvolvedor ou CLI | Mostra que você resolve seus próprios problemas |
| 5 | Projeto de domínio (sua especialidade) | Sinal de profundidade para sua função alvo |
| 6 | Curinga — pessoal ou criativo | Mostra personalidade e curiosidade genuína |
Regras de Fixação
FIXE:
- Projetos com demonstrações ao vivo ou links de implantação
- Repositórios com READMEs completos e capturas de tela
- Trabalho que corresponda às funções para as quais você está se candidatando
- Seu trabalho mais recente e mais polido
NÃO FIXE:
- Fork que você não modificou significativamente
- Tutoriais seguidos (mesmo se concluídos)
- Repositórios sem README
- Qualquer coisa que você não possa explicar em uma entrevista
README como Seu Discurso de Portfólio
Cada repositório fixado precisa de um README que venda o projeto em 30 segundos. Um recrutador gastará menos tempo que isso antes de decidir se continua lendo.
Estrutura de README para Repositórios de Portfólio
# Nome do Projeto
Descrição em uma frase do que ele faz e por que é importante.
## Demonstração
[Link para demonstração ao vivo] | [Link para vídeo explicativo]
Captura de tela ou GIF mostrando o aplicativo em ação.
## O Problema
Que problema isso resolve? Quem tem esse problema?
## Como Funciona
Visão geral da arquitetura. Principais decisões técnicas.
Diagrama se o sistema tiver múltiplos componentes.
## Stack Tecnológico
Lista de tecnologias — mas apenas as significativas.
Não liste HTML/CSS. Liste suas integrações de IA, bancos de dados, alvos de implantação.
## Principais Recursos
- Recurso 1 — por que é interessante tecnicamente
- Recurso 2 — o que foi difícil ao construí-lo
- Recurso 3 — o que você melhoraria em seguida
## Começando
Instruções claras de configuração. Alguém deve ser capaz de executar isso em menos de 5 minutos.
## O Que Aprendi
Breve reflexão sobre o desafio técnico mais difícil e como você o resolveu.
Anti-Padrões de README
| README Ruim | README Melhor |
|---|---|
| "Um aplicativo React" | "Resumidor de reuniões com IA que transforma gravações em itens de ação" |
| Sem capturas de tela | Captura de tela principal ou GIF acima da dobra |
| Configuração: "clone e execute" | Configuração: passo a passo com pré-requisitos listados |
| Sem explicação da arquitetura | Diagrama do sistema mostrando como os componentes se conectam |
| Lista todos os pacotes npm | Destaca as 3-4 tecnologias que importam |
Demonstrações ao Vivo e Links de Implantação
Código é uma hipótese. Um aplicativo implantado é uma prova.
Por Que a Implantação Importa
Recrutador vê repositório sem demonstração:
"Código interessante... funciona mesmo?"
Recrutador vê repositório com link ao vivo:
"Deixe-me testar." → 2 minutos depois → "Essa pessoa entrega."
Opções de Implantação por Tipo de Projeto
| Tipo de Projeto | Implantação Gratuita | Bom Para |
|---|---|---|
| Aplicativo web full-stack | Vercel, Railway, Fly.io | Aplicativos com sensação de produção |
| API / backend | Railway, Render | Mostrar habilidades de backend |
| Site estático / documentação | GitHub Pages, Netlify | Documentação, landing pages |
| Demonstração de IA/ML | Hugging Face Spaces, Streamlit Cloud | Demonstrações de modelo, aplicativos de dados |
| Ferramenta CLI | npm publish, Homebrew tap | Sinal de distribuição |
Se Não Puder Implantar, Grave uma Demonstração
Nem tudo pode rodar na nuvem. Para ferramentas apenas locais, aplicativos CLI ou sistemas complexos:
1. Grave um vídeo explicativo de 60 a 90 segundos.
2. Envie para o YouTube (não listado é aceitável).
3. Crie um GIF da interação principal.
4. Coloque ambos no README.
Uma demonstração em vídeo é dez vezes melhor que nenhuma demonstração.
Gráfico de Contribuição
O Que a Consistência Sinaliza
Recrutadores dão uma olhada no seu gráfico de contribuição. Veja o que eles realmente leem dele:
| Padrão | Interpretação |
|---|---|
| Verde constante, na maioria dos dias | "Essa pessoa programa regularmente. Bom hábito." |
| Aglomerados em torno de projetos | "Trabalha em sprints focados. Normal." |
| Verde apenas em dias de semana | "Tem um emprego, ainda assim entrega trabalho pessoal." |
| Mistura de repositórios próprios e contribuições | "Colaborativo. Não apenas projetos solo." |
Como a Manipulação Parece
Revisores experientes podem identificar isso instantaneamente:
BANDEIRAS VERMELHAS:
- Verde perfeitamente uniforme (todos os dias, mesma intensidade)
- Commits que são apenas edições de README ou alterações de espaço em branco
- 500 commits em um dia em repositórios vazios
- Dezenas de repositórios criados em uma semana, todos com commits únicos
- Bots de commit gerados automaticamente
Manipular seu gráfico é pior do que ter lacunas. Isso sinaliza desespero e mau julgamento. Consistência real significa trabalhar em coisas que você se importa em um ritmo regular — lacunas e tudo.
Construindo um Gráfico Real
Em vez de fingir:
1. Escolha um projeto e trabalhe nele 30 minutos por dia.
2. Contribua para open-source — até documentação, testes ou relatórios de bugs contam.
3. Mantenha um repositório de aprendizado onde você faça commit de notas e experimentos.
4. Construa ferramentas que você realmente usa. Você naturalmente continuará melhorando-as.
Alinhando Seu Portfólio à Função que Você Deseja
Seu portfólio deve parecer uma prévia do trabalho que você faria se fosse contratado. Adapte-o ao seu alvo.
Funções de Desenvolvimento Nativas de IA
Essas funções querem ver que você pode construir com IA e construir para IA:
| Sinal | Exemplo de Repositório |
|---|---|
| Uso de ferramentas de IA no seu fluxo de trabalho | Projeto com configuração .claude/, commits assistidos por IA, comandos de barra do Claude Code |
| Fluxos de trabalho agênticos | Agente de múltiplas etapas que pesquisa, planeja e executa tarefas |
| Integrações de LLM | Aplicativo com saída estruturada, engenharia de prompt, roteamento de modelo |
| RAG e recuperação | Base de conhecimento com pesquisa de embeddings e métricas de avaliação |
| Avaliação e teste | Estrutura de avaliação de saída de LLM, testes de regressão de prompt |
| Desenvolvimento assistido por IA | README do projeto documentando como ferramentas de IA aceleraram o desenvolvimento |
Alvos de Portfólio Específicos por Função
| Função Alvo | Repositórios Obrigatórios | Bom Ter |
|---|---|---|
| Engenheiro de IA/ML | Modelo ajustado, estrutura de avaliação, pipeline de dados | Implementação de artigo, comparação de modelos |
| Desenvolvedor Full-Stack de IA | Aplicativo com integração de LLM, sistema RAG, SaaS implantado | Contribuição open-source, ferramenta CLI |
| Engenheiro de Plataforma / Infra | Pipeline CI/CD, repositório IaC, configuração de monitoramento | Benchmark de desempenho, contribuição OSS |
| Ferramentas de Desenvolvedor / DX | Ferramenta CLI, SDK/biblioteca, extensão VS Code | Site de documentação, ferramenta de comunidade de desenvolvedores |
Lista de Verificação de Revisão de Portfólio
Execute esta auditoria antes de cada busca de emprego. Seja honesto.
Primeiras Impressões (30 segundos)
- Foto de perfil é profissional (ou intencionalmente distinta)
- Biografia declara o que você faz e o que está procurando
- Repositórios fixados têm descrições que fazem sentido para um estranho
- Pelo menos 3 repositórios fixados têm capturas de tela ou links de demonstração no README
- Nenhum nome de repositório embaraçoso visível na primeira página
Verificação de Profundidade (2 minutos)
- Cada repositório fixado tem um README que explica o quê, por quê e como
- Pelo menos um projeto tem uma demonstração ao vivo ou link de implantação
- A qualidade do código nos repositórios fixados reflete seu nível de habilidade atual
- O histórico de commits mostra desenvolvimento real (não um único bloco de "commit inicial")
- Pelo menos um repositório demonstra teste ou CI/CD
Verificação de História (5 minutos)
- Seus repositórios fixados contam uma história coerente sobre suas habilidades
- Há progressão visível de projetos mais antigos para mais novos
- Seu portfólio está alinhado com as funções que você está mirando
- Você pode explicar cada repositório fixado em um discurso de elevador de 60 segundos
- Você se contrataria com base neste GitHub
O Teste Supremo
Abra seu GitHub em uma janela anônima. Finja que é um recrutador que nunca te conheceu. Gaste 60 segundos. Você moveria este candidato para a próxima rodada?
Se a resposta não for um sim imediato, continue iterando.
Anti-Padrões
| Anti-Padrão | Por Que Prejudica | Correção |
|---|---|---|
| Fork sem alterações | Parece enchimento | Excluir ou tornar privado |
| Clones de tutorial ("todo-app", "weather-app") | Sinaliza que você seguiu instruções, não que sabe construir | Faça um fork e depois estenda muito além do tutorial |
| Repositórios vazios ou com apenas um README | Sinaliza ideias abandonadas | Arquivar ou excluir |
| Sem READMEs em repositórios públicos | "Não me comunico sobre meu trabalho" | Adicionar READMEs a tudo que você mantiver público |
| 50+ repositórios visíveis sem curadoria | Ruído avassalador, sem sinal | Arquivar agressivamente, fixar estrategicamente |
| Repositórios fixados desatualizados (2+ anos) | "Não construíram nada recentemente" | Rotacionar pins para mostrar trabalho recente |
| README de perfil apenas com estatísticas geradas automaticamente | Impessoal, baixo esforço | Escrever uma biografia real com seu foco e objetivos |
| Repositórios chamados "teste", "temp", "asdf" | Descuidado | Renomear ou remover |
Jogada de Poder
"Revise meu portfólio do GitHub em [sua URL do GitHub]. Avalie como se você fosse um recrutador para uma função de desenvolvimento nativa de IA. Pontue cada repositório fixado em qualidade do README, profundidade técnica, status de implantação e relevância para funções de IA/ML. Depois me dê um plano de ação priorizado: o que arquivar, o que melhorar, o que está faltando e qual novo projeto faria a maior diferença."
O agente se torna seu crítico de portfólio — dando a você o feedback honesto e específico de que precisa para transformar seu GitHub de um cemitério de códigos em um ativo de carreira.
Habilidades Relacionadas
| Skill | Quando usar |
|---|---|
github-profile | Implementar mecânicas da plataforma GitHub — README de perfil, fixação de repositórios, tópicos, gráfico de atividade |
career-resume | Ciclo de vida completo da carreira — busca de emprego, entrevistas, integração, avaliações de desempenho |