Portfolio build
Um portfólio tem cerca de 30 segundos na primeira visita. Esta skill constrói um que usa bem esses segundos: quem você é e o que faz na primeira tela, trabalho real ao lado, sua parte em cada projeto indicada e uma forma clara de entrar em contato.
Ela corrige a estrutura e deixa a aparência para a pessoa. Os três grids decidem onde as coisas vão e em que ordem. Tipo de letra, cor, raio do canto e espaçamento são dela, definidos em um bloco pequeno. Dois portfólios construídos com esta skill devem ter a mesma estrutura de leitura e parecer completamente diferentes.
Os caminhos abaixo são relativos à pasta desta skill.
Como funciona
Um arquivo, portfolio.json, contém tudo: quem é a pessoa, os projetos, o grid escolhido e a aparência.
Um comando transforma isso em um site estático (HTML e CSS puros, sem framework, nada para instalar):
python3 scripts/build.py caminho/para/o-site-do-designer/portfolio.json
O site é gerado ao lado do arquivo de conteúdo. Em seguida, o script imprime duas listas: o que uma auditoria
de 30 segundos ainda sinalizaria, cada linha vinculada a um número de regra (references/rules.md tem as dezessete
em uma linha cada), e cada [slot] aguardando um fato. Trate ambas como a lista de tarefas.
Etapas
1. Descubra para que serve o portfólio
Pergunte ou deduza a partir do que foi fornecido:
- O alvo. O cargo ou cliente a que se destina. Define o título principal, a ordem e o que é omitido.
- O trabalho. Quais projetos e, para cada um: o que era, a parte da pessoa, para quem era, o ano, uma decisão que ela tomou e o que aconteceu como resultado.
- O material. Onde estão as imagens e vídeos.
Se a pessoa já tem um site existente, leia-o primeiro e transfira o que já está lá. Se a skill portfolio-audit estiver
disponível e houver um site ativo, executá-la primeiro informa exatamente o que mudar.
Pergunte apenas o que você não consegue encontrar. Uma pessoa com uma pasta de imagens e uma página no LinkedIn já lhe deu a maior parte. Se ninguém estiver disponível para responder, continue com o que você tem e use slots (etapa 3).
Material sobre o qual a pessoa está insegura (um caderno de esboços, um projeto de estudante, algo antigo) fica de fora. Ela duvidou por um motivo, e um portfólio é julgado pelo seu ponto mais fraco. Diga o que foi omitido e por quê. Três projetos fortes são um portfólio completo; não adicione itens apenas para chegar a quatro.
2. Deixe a pessoa escolher o grid
Leia references/grids.md. Ele descreve os três grids e para quem cada um é adequado. O grid decide como todo o
site será lido, então é a escolha da pessoa, não sua. Sua parte é tornar essa escolha fácil.
Antes de construir, nomeie os três em uma mensagem curta, uma linha cada, diga qual você recomenda para o trabalho e alvo dela e por quê, e pergunte qual ela quer. Junte isso com qualquer outra pergunta necessária da etapa 1, para que haja apenas uma rodada de perguntas, não duas.
- Se ela já nomeou um grid, use-o e não reabra a questão.
- Se ela escolher um diferente da sua recomendação, construa o dela. Diga uma vez o que isso custa, se for relevante
(por exemplo,
indexnão tem espaço para uma decisão e um resultado), e então deixe de lado. - Se ela estiver insegura, ou ninguém estiver lá para responder, siga com sua recomendação e construa com
--comparena etapa 5, para que todos os três estejam disponíveis para abrir lado a lado.
Mudar depois é uma palavra no arquivo, então ninguém fica preso. Isso é um motivo para oferecer a escolha de forma leve, não um motivo para pulá-la.
3. Escreva o arquivo de conteúdo
Copie assets/example/portfolio.json como ponto de partida e leia references/content.md para cada campo.
Coloque-o na pasta que se tornará o site, com as imagens ao lado. O exemplo usa o grid case;
para index e columns, decision e result são opcionais e linhas de antes/depois raramente são necessárias.
Como escrever as partes mais importantes:
- Título: uma frase que diz o que a pessoa faz e para quem, com um fato incluído. Não deve servir para o site de mais ninguém. "Designer de produto para aplicativos fintech. Oito anos, mais recentemente líder do fluxo de savings na Ledger." Não "Profissional multidisciplinar apaixonado por criar experiências."
- Prova: os três ou quatro nomes ou números mais fortes, logo após o título.
- Ordem: o projeto que melhor se encaixa no alvo vai primeiro, independentemente da data. Quatro a oito projetos. Disciplinas secundárias (filme para um diretor de arte, ilustração para um designer de produto) são melhor como um segundo site com seu próprio arquivo de conteúdo do que misturadas.
- Cada projeto: um resumo de uma linha, a função desempenhada e se foi para um cliente, um empregador ou um conceito pessoal. Para alvos de produto e liderança, adicione a decisão e o resultado.
- Função: o cargo atual da pessoa como é, não o que ela está pleiteando.
- Pedido: uma frase acima do e-mail que diz sobre o que escrever.
- Idioma: escreva no idioma do público da pessoa e defina
site.lang. As palavras do próprio template (Index, Facts, Next…) seguem para inglês e espanhol; para qualquer outro idioma, defina-as emlabels.
Use apenas fatos que a pessoa forneceu ou que estão em suas páginas existentes. Um fato que você deduziu, como um nome de cliente lido de um nome de arquivo, pode ser usado, mas informe a pessoa que foi inferido para que ela confirme.
Onde um fato estiver faltando, escreva um slot entre colchetes ([ano], [tamanho da equipe], [o que foi lançado]). Slots
aparecem no site exatamente como escritos e a build lista cada um, então:
- Mantenha o título livre de slots: escreva-o com o que você sabe. Um slot na primeira frase é a primeira coisa que um visitante lê.
- Se um campo inteiro for desconhecido e opcional (
cidade,equipe,site.url), omita o campo. - Para trabalho sem resultado, diga a verdade: "Lançado em 2024; não tenho os números", "Conceito, não implementado". Isso é um resultado. Uma promessa vazia de impacto não é.
- Um site com slots é um rascunho. Diga isso claramente na entrega.
Um portfólio com uma lacuna honesta é aceitável. Um portfólio com um cliente inventado é um problema em uma entrevista.
4. Defina a aparência
No bloco theme: claro ou escuro, uma cor de destaque, o tipo de letra, raio do canto, espaçamento entre imagens. Se
a pessoa tem uma marca ou um site existente, tire-os daí. Se ela não tem nada, escolha um tipo de letra e uma cor
de destaque que combinem com o trabalho dela e diga o que escolheu. Não copie a aparência do exemplo ou de qualquer outro
site de designer.
Um tipo de letra que não está em todos os dispositivos precisa de font_url para carregá-lo; nomeá-lo apenas em font faz
com que a maioria dos visitantes use a fonte do sistema. Forneça ambos ou escolha uma pilha de fontes do sistema.
5. Construa, veja, corrija
Execute a build. Se a pessoa não escolheu um grid, adicione --compare:
python3 scripts/build.py caminho/para/o-site-do-designer/portfolio.json --compare
Isso também escreve o mesmo conteúdo em todos os três grids em uma pasta compare/, com uma página que os vincula.
Mostre essa página para a pessoa e deixe-a escolher. compare/ é apenas para escolha: exclua-a antes de publicar.
Em seguida, visualize em um navegador em largura de desktop e celular, se possível: inicie
python3 -m http.server na pasta do site (o grid case vincula a pastas de projeto, que precisam de um servidor)
e verifique a primeira tela você mesmo: nome, o que faz, prova, uma forma de contato e um trabalho real,
sem rolagem.
Se não puder abrir um navegador, informe isso na entrega e, pelo menos, mantenha o título e a prova juntos em cerca de 45 palavras, o que cabe acima da primeira imagem em um celular.
Percorra a lista que o script imprimiu. Corrija o que puder pelo conteúdo (uma linha de função ausente, uma imagem pesada, um título longo). Passe o restante para a pessoa como uma lista curta do que só ela pode fornecer.
6. Entrega
Diga a ela: qual grid e se ela escolheu ou você (e que os outros dois estão a uma palavra de distância, ou em
compare/ se você construiu), o que você escreveu para o título, o que foi omitido, qualquer coisa que foi inferida, os
slots ainda a preencher, o que a lista de auditoria ainda mostra e como fazer alterações (editar portfolio.json, executar a
build novamente). A pasta é um site estático completo: pode ser publicado em qualquer host estático enviando-o como está.
Duas coisas que só ela pode fornecer, então peça-as aqui: o endereço onde o site ficará (site.url) e uma
imagem de 1200×630 para prévias de links (site.share_image); um recorte da melhor imagem do primeiro projeto funciona.
Imagens
- Exporte no máximo 2000 px de largura, como AVIF ou WebP, com cerca de 500 KB cada. A build avisa sobre imagens mais pesadas. JPEG, PNG e SVG também funcionam.
- Uma cópia menor para celulares é usada automaticamente quando os arquivos são nomeados como um par:
shot-lg.jpgno arquivo de conteúdo eshot-sm.jpgao lado. Um.avifcom os mesmos nomes é oferecido primeiro para navegadores que o leem. - Dê a cada imagem um
altque diga o que mostra. Sem ele, o título do projeto é usado, o que diz a um mecanismo de busca ou assistente de IA muito pouco. Se você não viu as imagens, diga qual peça cada uma é e peça à pessoa que as descreva. - Vídeos curtos em loop (
.mp4,.webm) funcionam como blocos. Eles são reproduzidos sem som, apenas enquanto estão na tela. Dê a eles umratio.
O que não fazer
- Não adicione animação de introdução, carregador, cursor personalizado ou efeitos de rolagem que atrasem o conteúdo. O template mostra a primeira tela imediatamente de propósito.
- Não oculte títulos de projeto atrás de hover. Celulares não têm hover.
- Não remova a barra de ancoragem, a pequena barra com o nome e o e-mail que aparece quando o bloco de contato foi rolado para fora. Um revisor decide escrever no meio de um projeto, não no final da página.
- Não preencha trabalho ralo com imagens de processo (post-its, personas). Uma decisão, dita claramente, vale mais.
- Não edite o HTML gerado manualmente: a próxima build o sobrescreve. Altere o arquivo de conteúdo, ou o
template em
assets/template/se a própria estrutura precisar mudar.