Portfólio, carreira e IA
Mostrar o que você sabe fazer, procurar a primeira oportunidade e usar IA sem terceirizar o aprendizado.
Cerca de 12 min · Revisado em
Ao final, você vai conseguir
- Escrever um README que explica problema, decisões e limites
- Ler uma vaga e escolher a próxima lacuna para estudar
- Usar IA para explicar e revisar, conferindo cada resposta
Saber fazer e conseguir mostrar que sabe fazer são habilidades diferentes, e a segunda também se aprende. Quem avalia uma pessoa iniciante tem poucos minutos e quer ver uma coisa: se ela consegue construir algo, explicar o que construiu e continuar aprendendo. Nesta aula você prepara essa vitrine, aprende a ler vagas sem se assustar e a usar IA como colega de estudo, não como atalho que esvazia o aprendizado.
Um projeto que se explica sozinho
O README é o arquivo README.md na raiz do repositório, que o GitHub mostra logo abaixo da lista de arquivos. É a primeira coisa que alguém lê. Um bom README responde: que problema isto resolve, onde vejo funcionando, como rodo, que decisões você tomou, como testou e o que ainda falta.
Um README de portfólio, escrito em Markdown.
# Catálogo da Feira
Catálogo com busca e favoritos para bancas de uma feira de bairro.
Demonstração: https://seu-usuario.github.io/catalogo-feira
## Problema
As bancas anunciam produtos só no grupo de mensagens e as fotos se perdem.
## Como rodar
npm install
npm run dev
## Decisões
- Vue com TypeScript, para tipar os dados da API.
- Favoritos na página do catálogo, porque cabeçalho e lista usam.
## Testes
npm test: busca, falha da API e formulário inválido.
## Limites e próximos passos
- Sem login: os favoritos somem ao limpar o navegador.
- LCP de 3,1 s no celular; próximo passo é reduzir o banner.- Título e resumo: Uma frase que diz o que é e para quem. Quem lê decide em segundos se continua.
- Link da demonstração: O item mais importante. Muita gente não vai clonar nada: vai clicar, testar no celular e voltar. Confira que o link funciona.
- Problema: Um problema real, mesmo que pequeno, mostra que você pensa em quem usa, e não só em tecnologia.
- Como rodar: Comandos que funcionam numa máquina limpa. Peça para alguém seguir e veja se trava em algum passo.
- Decisões: O que você escolheu e por quê. É aqui que a pessoa vê raciocínio, e é daqui que saem as perguntas da entrevista.
- Testes: Dizer o que está testado, e não só que existem testes, mostra que você sabe o que importa proteger.
- Limites: Admitir o que falta não é fraqueza: é sinal de maturidade. Toda equipe trabalha com limites conhecidos.
Seu catálogo não tem login e os favoritos somem quando a pessoa limpa o navegador. Você menciona isso no README?
- Sim, na seção de limites, com uma ideia de como resolveria
- Não, porque chama atenção para um defeito
- Só se perguntarem na entrevista
O que quem contrata observa
Ninguém espera que uma pessoa júnior saiba tudo. O que se procura é evidência: de que você termina o que começa, de que entende o que fez e de que trabalha de um jeito que outras pessoas conseguem acompanhar.
Quais sinais fortalecem uma candidatura e quais quase não dizem nada?
Sinal forte · Sinal fraco
- Link de demonstração que abre e funciona no celular
- README que explica problema, decisões e limites
- Commits pequenos com mensagens que dizem o porquê
- Testes rodando na CI do repositório
- Vinte projetos copiados de tutoriais, todos parecidos
- Quinze tecnologias no currículo sem projeto que use nenhuma
- Repositório com um único commit chamado “final”
Lendo uma vaga sem se assustar
Muitas vagas de entrada pedem mais do que a pessoa contratada vai usar. Às vezes a descrição foi copiada de uma vaga mais sênior; às vezes é uma lista de desejos. Aprender a separar o essencial do resto evita que você desista de vagas que poderia conseguir.
Uma vaga fictícia, parecida com muitas reais
Pessoa Desenvolvedora Frontend Júnior
Requisitos:
- HTML, CSS e JavaScript
- React
- Git
- Consumo de APIs REST
- 3 anos de experiência com React
Diferenciais:
- TypeScript
- Testes automatizados
- Docker e KubernetesSepare o que é base da vaga, o que é diferencial e o que é lista de desejos.
Obrigatório de verdade · Desejável · Lista de desejos
- HTML, CSS e JavaScript
- React
- Git
- Consumo de APIs REST
- TypeScript
- Testes automatizados
- 3 anos de experiência numa vaga júnior
- Docker e Kubernetes numa vaga de frontend júnior
Você tem a base da vaga e um dos diferenciais, mas não tem os três anos de experiência. O que fazer?
- Candidatar-se, com o portfólio em destaque, e anotar o diferencial que falta como próximo estudo
- Esperar até cumprir todos os itens
- Fazer um curso de Docker e Kubernetes antes de se candidatar
Estágio
Para quem está estudando em curso técnico ou superior. Costuma ter mentoria e é feito para aprender trabalhando.
Vagas júnior
Esperam autonomia em tarefas pequenas e vontade de aprender. Projetos completos no portfólio pesam muito aqui.
Freelas pequenos
A página de um pequeno negócio do bairro ou de uma ONG. Combine escopo e prazo por escrito e comece por algo que você consegue entregar.
Código aberto e comunidades
Corrigir documentação ou uma issue marcada para iniciantes gera pull requests revisados. Comunidades e eventos locais trazem indicações e mentoria.
IA no fluxo de trabalho
Assistentes de IA geram texto e código prevendo o que parece uma boa resposta. Por isso acertam muito e também inventam: funções que não existem, opções de versões antigas, explicações convincentes e erradas. A ferramenta é ótima; a responsabilidade pelo código continua sendo sua.
Quais usos de IA ajudam a aprender e trabalhar, e quais são riscos?
Bom uso · Risco
- Pedir para explicar uma mensagem de erro
- Pedir sugestões de casos de teste para uma função
- Pedir explicação linha a linha de um código desconhecido
- Pedir crítica à sua hipótese sobre um bug
- Colar o arquivo
.envcom as chaves para ela achar o erro - Usar uma função sugerida sem conferir se ela existe
- Entregar a solução do exercício sem conseguir explicá-la
- Confiar na versão de biblioteca citada sem ver a documentação
Qual pedido tende a gerar uma resposta que ensina e que você consegue verificar?
- “Estou aprendendo JavaScript. Esta função deveria filtrar produtos pelo nome, mas devolve lista vazia quando digito Cam. Segue o código e um exemplo de entrada. Me ajude a achar o erro e explique o porquê, sem reescrever tudo.”
- “Meu código não funciona, conserta.”
- “Faça um catálogo completo em React com busca, favoritos e testes.”
O ciclo de verificação
Veja um caso típico. Você pediu um jeito de tirar tags repetidas de uma lista, e a resposta veio confiante.
A sugestão da IA, rodada no console
const tags = ['promo', 'novo', 'promo'];
const unicas = tags.unique();TypeError: tags.unique is not a functionO que aconteceu, e como você confirmaria a solução certa?
Arrays em JavaScript não têm o método unique: a ferramenta misturou com outra linguagem ou biblioteca. Na documentação da MDN você confirma que um Set guarda valores sem repetição, então [...new Set(tags)] resolve. Rodar o código e conferir a fonte transformou uma resposta errada em aprendizado.
Coloque em ordem o ciclo para usar uma resposta de IA com segurança.
- Perguntar com contexto, dizendo o que você já tentou
- Ler a resposta inteira, linha por linha
- Testar no seu código, incluindo um caso que deveria falhar
- Conferir na documentação oficial
- Explicar a solução com suas palavras
Entrevistas e uma rotina que dura
Em entrevistas para vagas de entrada, é muito comum pedirem que você apresente um projeto seu. Ninguém espera código perfeito: espera que você saiba por que ele é como é.
Que problema o projeto resolve?
Uma ou duas frases, sem tecnologia. Pratique em voz alta até sair natural.
Por que essas escolhas?
Por que esse framework, onde mora cada estado, por que essa divisão de componentes. O README já tem as respostas.
Como você sabe que funciona?
Que testes existem, o que eles cobrem e o que você mediu de desempenho e acessibilidade.
O que você faria diferente?
Os limites e próximos passos. Uma resposta honesta aqui mostra que você continua aprendendo.
Na entrevista, perguntam sobre uma parte do código que a IA sugeriu e você não entende bem. Qual a melhor resposta?
- Falar com honestidade, explicar o que você entende, dizer que usou IA nessa parte e como verificaria o restante
- Inventar uma explicação confiante
- Dizer que não lembra porque fez há muito tempo
- Pouco todo dia vence muito de vez em quando. Uma hora por dia rende mais que oito horas num sábado e nada na semana.
- Construa mais do que assiste. Para cada aula ou vídeo, escreva algum código que não estava no exemplo.
- Revise com espaçamento. Os cartões de revisão desta plataforma existem para isso: rever um pouco depois de alguns dias fixa melhor que reler tudo de uma vez.
- Descanse. Dormir faz parte de aprender, e um problema travado à noite muitas vezes se resolve na manhã seguinte.
Fechamento
- Um bom README mostra o problema, a demonstração, como rodar, as decisões, os testes e os limites do projeto.
- Quem contrata procura evidência: projeto completo e publicado, histórico de commits claro e capacidade de explicar o que foi feito.
- Em uma vaga, separe o obrigatório do desejável e da lista de desejos; se você atende à maior parte, candidate-se e estude a lacuna que mais se repete.
- IA é ótima para explicar e revisar, mas inventa: pergunte com contexto, teste, confira na documentação e explique com suas palavras.
- Nunca cole segredos ou dados privados numa ferramenta de IA, e estude cada trecho do seu portfólio antes de apresentá-lo.
Coloque seu projeto na vitrine
Pegue o projeto de catálogo da trilha e transforme em algo que você apresentaria amanhã numa entrevista. O objetivo é sair desta missão com um link para mandar e uma lacuna clara para estudar.
- Publique o projeto e escreva o README com problema, demonstração, decisões, testes e limites
- Peça feedback a alguém que use o projeto no celular e registre uma issue com o que ouvir
- Corrija essa issue com ajuda de IA, escrevendo um teste que prove a correção
- Compare três vagas de entrada da sua região ou remotas e marque o que se repete
- Escolha uma lacuna concreta e planeje duas semanas de estudo para ela