Construtor de Portfólio
Construa um site de demonstração de página única, voltado para recrutadores, para um projeto de hackathon. O site é a entrega, mesmo quando o projeto em si não é um aplicativo web: uma construção de hardware, um modelo de ML, uma CLI ou um projeto de pesquisa, todos ganham um site que mostra o trabalho por meio de vídeo, diagramas, fotos e réplicas interativas. Busque o nível estabelecido por estes sites de estudo de caso: dispatchai.art3m1s.me, talktuah.art3m1s.me, slugloop.com e adapted.art3m1s.me. Cada um não se parece com os outros, porque cada design é extraído do mundo do próprio projeto. Essa singularidade é o ponto central, e é por isso que esta skill se apoia na skill de design de frontend, em vez de um template fixo.
Etapa 1: Disponibilize o mecanismo de design
O design vem da skill frontend-design da Anthropic, e é o que impede que o resultado pareça uma página de IA genérica. Ela deve estar disponível antes de você projetar qualquer coisa.
Isso é um pré-requisito do usuário, não algo que o agente possa fazer por si mesmo, pois o agente não pode executar comandos de barra. Se frontend-design já aparecer em suas skills disponíveis, você está pronto. Se não, peça ao usuário para instalar o plugin no Claude Code executando estes dois comandos:
/plugin marketplace add anthropics/claude-plugins-official
/plugin install frontend-design@claude-plugins-official
A primeira linha só é necessária se esse marketplace ainda não foi adicionado. O Claude também aplica frontend-design automaticamente para trabalho de frontend, então seus princípios podem já estar em ação, mas peça ao usuário para confirmar, em vez de assumir que o plugin está presente. Cada decisão de design na Etapa 3 passa por ele.
Etapa 2: Reúna os fatos
Detecte primeiro, pergunte depois. Leia AGENTS.md, PRD.md, o README, package.json e quaisquer fotos, capturas de tela ou diagramas já no repositório. Depois, pergunte apenas o que estiver faltando:
- Nome do projeto e um slogan que nomeie os riscos, não a tecnologia.
- Tipo de projeto: aplicativo web, hardware ou IoT, modelo de ML, CLI ou ferramenta de desenvolvimento, aplicativo móvel, ou pesquisa e dados. Isso decide como você o mostra na Etapa 4.
- O problema, com uma estatística real e sua fonte.
- O que ele faz: três a cinco capacidades principais.
- Como funciona: o suficiente do sistema para desenhar um diagrama de arquitetura.
- Prova: vídeo de demonstração (YouTube), URL ativa, Devpost, GitHub, cobertura da imprensa e quaisquer artefatos de código aberto (modelo, conjunto de dados, Figma).
- Mídia do evento: as fotos espontâneas e clipes do próprio hackathon, que o repositório quase nunca contém. Pergunte explicitamente por fotos da equipe e da construção em andamento, fotos do dia da demonstração ou do palco e premiações, esboços em quadro branco ou guardanapo, e o local, além de onde eles estão (um telefone, um drive compartilhado, a galeria do Devpost). Elas são o que fazem o site parecer real, então solicite-as em vez de assumir que o repositório as possui. Se nenhuma existir, recorra a capturas de tela, diagramas e ao vídeo de demonstração.
- Resultados: prêmios e colocação, nome do evento, datas, escala e classificação, tempo de construção, tamanho da equipe e quaisquer métricas (commits, latência, usuários).
- Equipe: nomes, funções, handles do GitHub, URLs do LinkedIn e fotos de rosto.
Nunca invente um prêmio, estatística, prêmio, classificação ou citação. Se um fato for desconhecido após perguntar, omita essa seção em vez de adivinhar.
Etapa 3: Projete através do frontend-design
Forneça ao frontend-design um resumo construído a partir da Etapa 2 e execute seu ciclo completo: brainstorming, explorar, planejar, criticar, construir e criticar novamente. Sua regra central se aplica aqui: derive a aparência do assunto, não de um padrão. Produza um sistema de tokens compacto específico para este projeto:
- Paleta: quatro a seis valores hexadecimais nomeados extraídos do mundo do projeto. Um despachante 911 lê-se como vermelhos e âmbares de severidade sobre preto quase total; um banco de voz lê-se como azuis de confiança; uma construção de malha de bicicleta da UCSC lê-se como uma paleta de arquivo "diário de campo" desgastado.
- Tipografia: uma face de exibição cheia de caráter usada com moderação, uma face de corpo complementar e uma face utilitária ou mono para dados, combinadas deliberadamente, em vez das mesmas famílias que todo projeto recebe.
- Layout: uma página única de storytelling com rolagem, seguindo o esqueleto da Etapa 5.
- Movimento: um momento de movimento orquestrado que serve ao assunto, como uma revelação de arquitetura acionada por rolagem ou uma repetição de telemetria. Efeitos dispersos parecem gerados por IA, então concentre o movimento em um só lugar. Isso é separado do piso de acessibilidade de movimento reduzido da Etapa 6.
- Assinatura: o elemento único pelo qual este site é lembrado, incorporando este projeto. Dispatch tem um console de operador interativo embutido rodando em dados semeados; Slugloop tem seu enquadramento de arquivo "os receptores não pingam mais"; AdaptEd tem seus loops de aprendizagem numerados.
Duas salvaguardas herdadas do frontend-design:
- Evite as aparências padrão de IA a menos que o mundo do projeto realmente as exija: (1) um fundo creme com uma serifa de alto contraste e um acento terracota, (2) preto quase total com um único acento verde-ácido ou vermelhão, (3) regras de fio de jornal com raio de borda zero e colunas densas. Se seu plano de paleta e tipografia cair em um desses por reflexo, revise-o e diga por quê.
- Estrutura é informação. Use marcadores numerados, sobrancelhas e divisores apenas quando eles codificam algo verdadeiro, como uma sequência real (os loops do AdaptEd), nunca como decoração. A numeração do esqueleto da Etapa 5 é uma lista de verificação de autoria, não um tratamento visual obrigatório.
Os rótulos das seções também são superfície de design. O esqueleto é a estrutura subjacente; renomeie seus títulos para a voz do projeto ("Diário de campo" em vez de "Mostruário", uma linha do próprio mundo em vez de "Limites honestos", numerados de 01 a 0N onde couber no assunto). Execute o portão de planejar-depois-criticar antes de construir: se alguma escolha parecer com a página que você produziria para qualquer projeto semelhante, revise-a. Construa apenas quando o plano for genuinamente específico para este resumo.
Etapa 4: Escolha como mostrar o trabalho
O site mostra o projeto independentemente do tipo de coisa que ele é. O piso universal é o vídeo de demonstração mais o artefato principal do projeto, seja ele qual for: filmagens, fotos, uma repetição de telemetria, uma figura de avaliação ou uma repetição de terminal. Em seguida, escolha o principal dispositivo de exibição por tipo de projeto:
- Aplicativo web: um widget ou console interativo embutido rodando em dados semeados (o console do operador do Dispatch), com uma visualização somente leitura como fallback apenas quando a interatividade não for viável.
- Hardware ou IoT: fotos da construção, um diagrama de fiação ou sistema, filmagens de campo e um mapa ou repetição de telemetria (Slugloop).
- Modelo de ML: um widget de inferência interativo ou um antes e depois, mais os números de avaliação e um link do Hugging Face.
- CLI ou ferramenta de desenvolvimento: uma repetição de terminal (estilo asciinema) ou uma sequência de comandos animada.
- Móvel: um vídeo emoldurado por dispositivo ou um fluxo de tela clicável.
- Pesquisa ou dados: a figura-chave, gráficos e o diagrama de metodologia.
As demonstrações podem ser várias. Ofereça dois modos de demonstração quando ajudar (um passo a passo passivo mais um modo interativo, como o TalkTuah), ou emparelhe um clipe de protótipo inicial com um clipe de campo final para mostrar iteração (Slugloop). Apenas simule uma réplica quando um backend real não puder ser executado em um site estático; quando o fizer, alimente-a com dados realistas e rotule-a claramente como uma réplica. Um site de hardware construído em filmagens de campo reais não precisa de simulação nem de tal rótulo.
Se o projeto recebeu cobertura de imprensa real, trate-a como um dispositivo de credibilidade: renderize os recortes como cartões ou logotipos de veículos com uma citação e fonte (Slugloop), não como links simples.
Etapa 5: O esqueleto do estudo de caso
Uma rolagem de página única, primeiro o recrutador. Trate-a como um menu: inclua uma seção apenas quando os fatos existirem, e renomeie seu título para a voz do projeto (veja a Etapa 3). A numeração aqui é uma lista de verificação de autoria, não um estilo visual obrigatório.
- Herói (tese): abra com a coisa mais característica do projeto, mais o slogan e os CTA primários (demonstração, Devpost, GitHub). Mantenha o principal prêmio ou credencial visível.
- Faixa de credibilidade: colocação, prêmio, classificação, tamanho do campo.
- Problema: os riscos e uma estatística com fonte.
- O que faz: as capacidades principais. Cartões de capacidade podem vincular profundamente ou ancora de rolagem para a parte correspondente da seção de arquitetura, ligando o que ao como (TalkTuah).
- Como funciona: o diagrama de arquitetura ou sistema, onde a profundidade da engenharia aparece.
- Mostruário: o dispositivo escolhido na Etapa 4 (widget interativo, vídeo ou vídeos, fotos, repetição de telemetria). Permita um bloco de vídeo duplo ou de iteração quando aplicável.
- Pelos números: uma grade de estatísticas ousada com números grandes e rótulos curtos. Pode fundir tamanho da equipe, tempo de construção, commits e classificação em um bloco de assinatura (Slugloop: 4 alunos, 36 horas, 500+ commits, Top 10). A classificação também pode aparecer na faixa de credibilidade.
- Imprensa (opcional): cobertura real como cartões de recorte ou logotipos de veículos com uma citação e fonte.
- Equipe ou tripulação: biografias com funções, GitHub e LinkedIn.
- Limites honestos: o que uma construção de fim de semana é e não é. Nomear as compensações soa como maturidade, não fraqueza.
- Links e fontes: GitHub, Devpost, YouTube, modelo ou conjunto de dados, imprensa.
- Rodapé: construído em N horas no evento, com links do repositório e do site ativo.
Etapa 6: Construa
- Construa um site de página única independente que seja exportável estaticamente e pronto para Vercel, usando Next.js (App Router) por padrão. Corresponda à pilha existente do projeto, se houver. Coloque-o em sua própria pasta (
site/ouportfolio/) ou em um repositório separado para que não se misture com o código do produto. - Use conteúdo real em todo o site; sem lorem. Siga as diretrizes de redação do frontend-design: simples, específico, escrito do lado da tela do leitor.
- Mantenha um piso de qualidade sem anunciá-lo: responsivo até dispositivos móveis, foco de teclado visível e movimento reduzido respeitado.
- Cubra o básico de SEO: um título e descrição com palavras-chave, uma URL canônica, uma imagem Open Graph, exatamente um
h1e seções semânticas. - Use capturas de tela reais, fotos e diagramas, incluindo a mídia do evento reunida na Etapa 2, colocada nas seções de mostruário, equipe e pelos números; se você enviar uma réplica simulada, rotule-a; use o pôster do YouTube para a demonstração.
- Critique novamente após a renderização, conforme orienta o frontend-design: tire uma captura de tela da página, pergunte novamente "eu teria produzido esta mesma aparência para um projeto não relacionado?" e remova um acessório cortando uma decoração que não serve ao resumo.
Verificar
frontend-designfoi realmente usado, e o resultado não parece um padrão de IA genérico ou cai em uma das três aparências padrão. Aplique sua autocrítica após a construção: você teria produzido esta mesma aparência para um projeto não relacionado?- Um
h1, títulos semânticos, responsivo para dispositivos móveis, estados de foco visíveis, movimento reduzido respeitado. - Cada prêmio e estatística são reais, qualquer réplica simulada é rotulada, cada link resolve e o vídeo ou vídeos de demonstração estão incorporados.
- Construa e visualize localmente; verifique Core Web Vitals ou uma passagem do Lighthouse, se for prático.
Saída final
- O site: caminho ou rota e como executá-lo.
- Sistema de design: a paleta, o par de tipografia, o momento de movimento e o elemento de assinatura, com uma linha sobre por que cada um se encaixa neste projeto.
- Dispositivo de mostruário: qual você usou e por que ele se adequa ao tipo de projeto.
- Fatos usados vs. omitidos: o que entrou e quais seções foram puladas por falta de fatos reais.
- Implantação: as etapas para enviá-lo para a Vercel.
- Próximos passos: por exemplo, um domínio personalizado, e vincular o site a partir do README e de uma postagem no LinkedIn.
Limites
- Disponibilize o
frontend-designprimeiro e nunca envie um padrão modelado. O design deve ser específico para este projeto. - Nunca invente prêmios, estatísticas ou imprensa, e sempre rotule réplicas simuladas.
- Mantenha-o em uma página focada. Não reconstrua o produto inteiro.
- Descreva o que realmente existe. O site reflete o projeto real, não uma versão aspiracional.