Estratégia de Portfólio
Princípio Central
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 gerente de contratação tem sobre você — e cada resposta deve fazê-lo querer agendar uma entrevista.
O Que Separa Impressionante de Medíocre
PORTFÓLIO MEDÍOCRE PORTFÓLIO IMPRESSIONANTE
───────────────── ────────────────────
30 repositórios, a maioria forks 5 repositórios, todos originais
Nenhum README Cada README conta uma história
Nenhuma demo 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
Nenhuma descrição nos repositórios Cada repositório tem uma frase
"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 commitou tudo que tocou.
Qualidade em vez de Quantidade
Três a cinco projetos refinados superam trinta repositórios abandonados. Sempre.
A Matemática Que Importa
| Repositórios | READMEs | Implantados | O Gerente de Contratação Pensa |
|---|---|---|---|
| 30 | 2 | 0 | "Começa coisas, não termina" |
| 15 | 5 | 1 | "Experimenta. Não fica claro no que é bom" |
| 5 | 5 | 4 | "Focado. Entrega. Conhece seu ofício" |
| 3 | 3 | 3 | "Tudo que toca é polido" |
A Regra da Limpeza
Antes de adicionar algo novo, audite o que já existe:
1. Arquive ou torne privado qualquer coisa inacabada e irrecuperável.
2. Apague forks que você nunca modificou.
3. Adicione READMEs a tudo que você mantiver público.
4. Defina 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."
Repositório 1: LLM ajustado para tarefa específica de domínio
Repositório 2: Pipeline RAG com estrutura de avaliação
Repositório 3: Fluxo de trabalho agêntico com uso de ferramentas
Repositório 4: Contribuição open-source para LangChain/LlamaIndex
O Arco do Construtor Full-Stack:
"Construo produtos completos, do banco de dados à implantação."
Repositório 1: App SaaS full-stack (Next.js + API + BD + Autenticação)
Repositório 2: Ferramenta CLI com IA (mostra habilidades de backend/sistemas)
Repositório 3: Biblioteca open-source (mostra pensamento de design de API)
Repositório 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."
Repositório 1: Fluxo agêntico / sistema multiagente
Repositório 2: Integração de LLM em um aplicativo de nível de produção
Repositório 3: Ferramenta de desenvolvedor que aproveita IA (linter, revisor, gerador)
Repositório 4: Contribuição para um framework ou ferramenta de IA
Sinais de Progressão
Gerentes de contratação notam quando seus repositórios mostram crescimento:
| Sinal | O Que Mostra |
|---|---|
| Repositório antigo: app CRUD simples | Você começou em algum lugar |
| Repositório intermediário: API com testes e CI | Você aprendeu práticas de engenharia |
| Repositório recente: agente de IA com avaliações | Você está construindo na fronteira |
| Contribuição para projeto OSS importante | Você trabalha em bases de código grandes |
O Que Fixar e Por Quê
Você pode fixar até seis repositórios. Use-os estrategicamente.
O Layout Ideal de Pinagem
| 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 seu cargo alvo |
| 6 | Curinga — pessoal ou criativo | Mostra personalidade e curiosidade genuína |
Regras de Pinagem
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 vagas para as quais você está se candidatando
- Seu trabalho mais recente e mais polido
NÃO FIXE:
- Repositórios forkados que você não modificou significativamente
- Tutoriais seguidos passo a passo (mesmo se concluídos)
- Repositórios sem README
- Qualquer coisa que você não consiga 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 gerente de contratação 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 de uma frase do que ele faz e por que é importante.
## Demonstração
[Link para demo ao vivo] | [Link para vídeo de demonstração]
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 vários componentes.
## Stack Tecnológica
Lista de tecnologias — mas apenas as significativas.
Não liste HTML/CSS. Liste suas integrações de IA, bancos de dados, destinos de implantação.
## Principais Funcionalidades
- Funcionalidade 1 — por que é interessante tecnicamente
- Funcionalidade 2 — o que foi difícil ao construí-la
- Funcionalidade 3 — o que você melhoraria em seguida
## Primeiros Passos
Instruções claras de configuração. Alguém deve conseguir 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 app 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
Gerente de contratação vê repositório sem demo:
"Código interessante... mas funciona mesmo?"
Gerente de contratação 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 | Ideal Para |
|---|---|---|
| Aplicativo web full-stack | Vercel, Railway, Fly.io | Apps 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 | Demos de modelo, apps 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 locais, aplicativos CLI ou sistemas complexos:
1. Grave um vídeo de demonstração 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ções
O Que a Consistência Sinaliza
Gerentes de contratação dão uma olhada no seu gráfico de contribuições. Veja o que eles realmente interpretam:
| Padrão | Interpretação |
|---|---|
| Verde constante, na maioria dos dias | "Essa pessoa programa regularmente. Bom hábito." |
| Agrupado em torno de projetos | "Trabalha em sprints focados. Normal." |
| Verde apenas em dias úteis | "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 identificam isso instantaneamente:
BANDEIRAS VERMELHAS:
- Verde perfeitamente uniforme (todos os dias, mesma intensidade)
- Commits que são apenas edições de README ou mudanças de espaços 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ê gosta 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ê commit notas e experimentos.
4. Construa ferramentas que você realmente usa. Você naturalmente continuará melhorando-as.
Alinhando Seu Portfólio à Vaga que Você Quer
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 Nativo de IA
Essas funções querem ver que você consegue 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 do Claude Code |
| Fluxos agênticos | Agente de várias etapas que pesquisa, planeja e executa tarefas |
| Integrações de LLM | App com saída estruturada, engenharia de prompt, roteamento de modelos |
| RAG e recuperação | Base de conhecimento com busca por embeddings e métricas de avaliação |
| Avaliação e testes | Estrutura de avaliação de saída de LLM, testes de regressão de prompt |
| Desenvolvimento assistido por IA | README do projeto documentando como as ferramentas de IA aceleraram o desenvolvimento |
Alvos de Portfólio Específicos para a 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 | App integrado a 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 para Desenvolvedores / 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 do 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
- Qualidade do código nos repositórios fixados reflete seu nível de habilidade atual
- Histórico de commits mostra desenvolvimento real (não um único "commit inicial" como bloco)
- Pelo menos um repositório demonstra testes 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 antigos para novos
- Seu portfólio está alinhado com as funções que você está almejando
- Você consegue explicar cada repositório fixado em um discurso de elevador de 60 segundos
- Você se contrataria com base neste GitHub
O Teste Final
Abra seu GitHub em uma janela anônima. Finja que é um gerente de contratação que nunca te conheceu. Gaste 60 segundos. Você passaria 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 Machuca | Conserto |
|---|---|---|
| Repositórios forkados sem alterações | Parece enchimento | Apague ou torne privado |
| Clones de tutorial ("todo-app", "weather-app") | Sinaliza que você seguiu instruções, não que sabe construir | Faça um fork e estenda-o muito além do tutorial |
| Repositórios vazios ou com apenas um README | Sinaliza ideias abandonadas | Arquive ou apague |
| Nenhum README em repositórios públicos | "Não me comunico sobre meu trabalho" | Adicione READMEs a tudo que você manter público |
| 50+ repositórios visíveis sem curadoria | Ruído esmagador, nenhum sinal | Arquive agressivamente, fixe estrategicamente |
| Repositórios fixados desatualizados (2+ anos) | "Não construíram nada recentemente" | Alterne os fixos para mostrar trabalho recente |
| README do perfil com apenas estatísticas geradas automaticamente | Impessoal, baixo esforço | Escreva uma biografia real com seu foco e objetivos |
| Repositórios chamados "teste", "temp", "asdf" | Descuido | Renomeie ou remova |
Movimento Poderoso
"Revise meu portfólio do GitHub em [sua URL do GitHub]. Avalie como se você fosse um gerente de contratação para uma função de desenvolvimento nativo 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 que novo projeto faria a maior diferença."
O agente se torna seu crítico de portfólio — fornecendo o feedback honesto e específico que você precisa para transformar seu GitHub de um cemitério de código em um ativo de carreira.
Habilidades Relacionadas
| Habilidade | Quando usar |
|---|---|
github-profile | Implementar mecanismos da plataforma GitHub — README do perfil, fixação de repositórios, tópicos, gráfico de atividade |
career-resume | Ciclo de carreira completo — busca de emprego, entrevistas, integração, avaliações de desempenho |