Communitygithub.com

Tosccony/design-dna-tool

Pesquise sites de referência reconhecidos pela imprensa de design para um segmento vertical, analise-os através das quatro lentes e salve as descobertas como uma nota de pesquisa.

O que é design-dna-tool?

Esta skill permite que um agente de IA (como Claude Code, Cursor ou Codex) realize pesquisas de referências de design para um segmento vertical específico, como 'sites de escritórios de advocacia' ou 'landing pages de SaaS'. Quando um usuário precisa de inspiração ou referências iniciais para um projeto, a skill automaticamente descobre sites aclamados pela crítica de design (como Awwwards, FWA), analisa cada um usando quatro lentes (tipografia, cor, layout e movimento), identifica padrões comuns e conecta as descobertas com a biblioteca de presets do projeto. O resultado é salvo em `docs/research/` como uma nota Markdown enriquecida, que pode ser reutilizada em futuras sessões de brainstorming, especialmente quando combinada com a skill `/new-mockup`. A skill lida com casos extremos como URLs mortos, verticais muito amplos e sites renderizados por JavaScript, garantindo uma saída robusta e acionável para designers e desenvolvedores.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Tosccony/design-dna-tool/tree/HEAD/.claude/skills/website-research

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Pesquisa de Sites

A receita para preencher a lacuna de "falta de referências" antes de um brainstorming. Obtém 5 referências da imprensa de design para o segmento vertical, analisa cada uma através das mesmas quatro lentes que /analyze, identifica padrões transversais, faz a ponte com a biblioteca de presets e salva toda a sessão como uma nota Markdown que projetos futuros podem aproveitar.

A justificativa do design está em docs/plans/2026-04-29-website-research-design.md; esta skill é a receita operacional.

Quando usar

  • Embutido no Passo 1 de /new-mockup quando o usuário não tem pontos de referência (ou pede ajuda para encontrar alguns).
  • Autônomo via /research <entrada livre> para execuções de inspiração ad-hoc.
  • Quando o usuário pergunta "o que está funcionando em [segmento vertical]" ou "me dê exemplos de bons sites do tipo [tipo]" — mesmo que não diga /research, a skill se aplica.

Não use para: clonar um site específico (extraímos padrões, não ativos), pesquisa de sucesso comercial (sinal errado — veja docs/plans/2026-04-29-website-research-design.md para o motivo) ou analisar uma única referência que o usuário já forneceu (use /analyze para isso).

Pré-requisitos

Antes de executar, verifique três coisas:

  1. docs/research/ existe. Deveria — a Tarefa 1 deste plano a cria. Se o diretório estiver faltando, crie-o imediatamente com mkdir -p docs/research/ e continue. (Não pare aqui — a recuperação automática é aceitável.)
  2. A entrada tem sinal suficiente. Uma única palavra genérica como "SaaS" ou "e-commerce" é muito ampla — veja o Caso extremo #1 abaixo; peça um refinamento antes de executar.
  3. Acesso a ferramentas. WebSearch e WebFetch devem estar disponíveis. Se estiverem desabilitados, pare com: "As chamadas de ferramentas Web estão desabilitadas. /research precisa de WebSearch e WebFetch para descobrir e verificar candidatos. Habilite-as ou recorra à coleta manual de referências."

O fluxo de cinco etapas

1. Analisar a entrada

A entrada é de formato livre. Leia-a e extraia:

  • Segmento vertical — que tipo de negócio ou produto (escritório de advocacia / impressor / landing page SaaS / merch / portfólio de agência / publicação editorial / etc.).
  • Restrições — adjetivos que restringem o conjunto de candidatos (moderno / tradicional / escuro / claro / premium / lúdico / minimalista / denso / etc.).
  • Exclusões obrigatórias — qualquer coisa que o usuário explicitamente não queira (por exemplo, "mas não corporativo", "sem templates de e-commerce").

Se a extração for ambígua (por exemplo, a entrada é genuinamente apenas "SaaS"), aplique o Caso extremo #1 e faça uma pergunta esclarecedora antes de executar.

Consulta a pesquisas anteriores: antes da descoberta, liste docs/research/*.md e verifique nomes de arquivo + tópicos da primeira linha por correspondências com o segmento vertical analisado. Se uma nota recente cobrir o mesmo segmento vertical (tipicamente < 3 meses para categorias de movimento rápido como landing pages SaaS ou ferramentas de IA, < 6 meses para categorias de movimento mais lento como escritórios de advocacia — baseie-se em se o cânone da imprensa de design para o segmento vertical mudou visivelmente, não no calendário), destaque-a: "Encontrado <filename> de sobre o mesmo segmento vertical. Reutilizar, executar nova pesquisa ou aumentar com novas opções?" Reutilizar pula a descoberta; nova pesquisa começa do zero; aumentar usa os candidatos da nota anterior como semente e encontra sites adicionais.

2. Descoberta (híbrida)

Duas passagens alimentam uma lista unificada de candidatos.

Passagem A — Conhecimento geral do LLM. Proponha 5–10 sites a partir dos seus dados de treinamento. Filtre com esta estrutura de prompt:

"Liste sites em [segmento vertical] que são amplamente reconhecidos como exemplares pela imprensa de design (Awwwards, FWA, Land-book, Site Inspire, Brutalist Websites) ou referenciados por profissionais. Filtre por [restrições]. Saída como nome | url | uma linha do porquê é reconhecido."

Critérios para "estar indo muito bem":

  • Primário: reconhecimento pela imprensa de design (prêmios, posições em destaque) + habilidade estética (aparência excelente, tipografia bem pensada, layout original, movimento preciso).
  • Secundário: reputação entre profissionais (referenciado no discurso de design).
  • Ignorado: proxies de sucesso comercial (marcas bem financiadas podem ter sites medíocres — sinal errado).

Limiar de reconhecimento pela imprensa de design. Um único SOTD do Awwwards por si só não é suficiente — muitos sites os recebem. Exija pelo menos um de: (a) SOTM/SOTY no Awwwards/FWA/CSS Design Awards, (b) escolha do editor no Land-book / Site Inspire / Brutalist Websites / Page Collective, OU (c) referência de profissional no discurso de design (citado em newsletters de design como Sidebar.io, Hover States, Frontend Focus; ou referenciado em estudos de caso de agências / threads de designers no Twitter/Bluesky). Financiamento e sucesso comercial não dizem nada sobre qualidade de design, mesmo quando correlacionados.

Passagem B — Complemento WebSearch. Componha 1–2 consultas com base na entrada, por exemplo, "best law firm websites 2025 awwwards", "premium printmaker website inspiration". Trie os resultados: mantenha publicações de design (Awwwards, FWA, Site Inspire, Land-book, Brutalist Websites, Sidebar.io, Typewolf, Page Collective), páginas de estudos de caso de agências e posts de profissionais. Descarte listas orientadas por SEO ("top 10 X websites in 2025"), galerias de marketplaces de templates (páginas de showcase de templates Wix/Squarespace/Webflow, não sites reais) e fazendas de conteúdo geradas por IA.

(Se uma fonte nomeada retornar 404 ou tiver claramente encerrado, descarte-a silenciosamente e apoie-se nas outras — não apresente relatórios de fontes mortas como parte da saída da descoberta.)

Obtenha 3–5 candidatos adicionais.

Dedup + verificação. Combine ambas as listas. Remova duplicatas. Para cada candidato restante, execute WebFetch (GET único, leve) para confirmar que a URL está ativa. Descarte URLs mortas. Limite a lista verificada a 5 sites por padrão; o usuário pode sobrescrever via prompt da skill (--count 8 ou linguagem natural "encontre 8 sites").

3. Análise por site

Para cada site verificado, execute o fluxo de trabalho existente de /analyze embutido (não invoque o comando de barra — aplique o padrão das quatro lentes diretamente):

  • Tipografia: características da família, contraste de peso, proporção de escala, tracking.
  • Cor: modo, a lógica (não hexadecimais), onde o destaque ganha seu lugar.
  • Layout: padrão do hero, assimetria, densidade, ritmo vertical.
  • Movimento: personalidades de easing, onde o movimento vive, densidade.

3–4 marcadores por categoria, breves e concretos. Em seguida, um parágrafo de "Por que funciona" sintetizando os pontos fortes do design.

Frases proibidas em "Por que funciona": "moderno e limpo", "tipografia ousada", "design elegante", "equilíbrio perfeito", "visuais impressionantes" — estas são vazias de conteúdo. O parágrafo deve nomear uma troca específica ou uma escolha não óbvia (por exemplo, "A display condensada faz o trabalho pesado para que o corpo possa permanecer quieto — permitindo usar um único peso no corpo sem perder hierarquia").

Lembrete ético: padrões sim, ativos não. A saída nunca propõe copiar um site literalmente — extraímos linguagem de design, não layouts ou imagens específicas.

4. Agregar padrões transversais

Depois que todos os sites forem analisados, resuma o que é comum no conjunto:

  • Tipografia: "4 de 5 usam um sistema de família única, hierarquia liderada por peso."
  • Cor: "Todos os 5 são modo escuro padrão; 3 usam monocromático com um destaque."
  • Layout: "Heros assimétricos dominam; 4 de 5 evitam divisões 6/6."
  • Movimento: "Entrada Expo-out domina; 3 de 5 usam revelações acionadas por rolagem."

Faça a ponte com a biblioteca de presets: leia presets.ts, identifique os presets existentes mais próximos para cada categoria de preset presente no arquivo e sinalize lacunas explicitamente — padrões que nenhum preset atual cobre. Se presets.ts ganhou uma nova categoria de preset desde que esta skill foi escrita (por exemplo, primitivas de interação, presets de exibição de dados), inclua-a na ponte — não a pule só porque as quatro lentes não a anteciparam. Melhor sinalizar a lacuna do que forçar um encaixe inadequado.

Se os padrões forem fracos ("3 de 5 usam sans-serif" — verdade para 95% da web, inútil), diga isso explicitamente. Não revista descobertas genéricas.

5. Salvar a nota de pesquisa

Escreva em docs/research/<slug>-<YYYY-MM-DD>.md onde slug é uma palavra-chave em kebab-case. Se o caminho já existir (mesmo segmento vertical, mesmo dia), anexe -v2, -v3, etc., até que o caminho esteja livre. Use esta estrutura literalmente:

# Pesquisa: <tópico / segmento vertical>
**Data:** YYYY-MM-DD · **Brief:** <entrada do usuário literal>

## Candidatos analisados
1. <Nome do Site> — <url> · <uma linha do porquê reconhecido>
2. ...
(+ lista de quaisquer candidatos descartados, com motivo)

## Análise por site
### 1. <Nome do Site>
[análise das quatro lentes: 3–4 marcadores por categoria]
**Por que funciona:** <1–2 frases sintetizando os pontos fortes do design>

### 2. <Nome do Site>
...

## Padrões transversais
- **Tipografia:** ...
- **Cor:** ...
- **Layout:** ...
- **Movimento:** ...

## Ponte para a biblioteca de presets
- **Presets existentes mais próximos:** ...
- **Lacunas:** ... (ou "nenhuma — os presets atuais cobrem os padrões")

## Direção de DNA recomendada
<2–3 frases sobre qual direção de design faz sentido dados os padrões e lacunas — formuladas como um ponto de partida para uma futura proposta de DNA, não uma escolha final. Não reutilize a palavra "brief" aqui, já que execuções autônomas de /research podem não ter um.>

Após escrever, publique um resumo curto no chat (não a nota completa — isso está salvo). Se invocado a partir de /new-mockup, passe para a etapa de brainstorming com os padrões + lacunas como contexto. Se autônomo, termine aqui.

Casos extremos

  1. Segmento vertical muito amplo. Se a entrada for um ou dois substantivos genéricos ("e-commerce", "SaaS"), pare antes da descoberta e peça um refinamento: "E-commerce é amplo — qual é o posicionamento da marca (premium / lúdico / utilitário)? E a categoria do produto? Isso vai afinar a lista." Retome após o usuário responder.
  2. Todas as URLs propostas pelo LLM mortas. O corte de treinamento significa que ~10–20% das URLs propostas pelo LLM podem ter sido movidas ou estar mortas. Se a verificação reduzir a lista para menos de 3 sites, volte para uma passagem apenas com WebSearch. Se ainda assim ficar abaixo de 3 sites, admita a lacuna: "Não foi possível encontrar de forma confiável 5 referências da imprensa de design para este brief. Obtive candidatos analisados; deseja prosseguir com estes, ou tem algum ponto de partida próprio?"
  3. Sites renderizados por JS. WebFetch retorna HTML não renderizado; SPAs modernos podem mostrar marcação vazia (tags de script + <div id="root"> vazia). Detecte (nenhum conteúdo significativo extraído), sinalize o site como "não foi possível analisar sem uma visualização renderizada — URL registrada para revisão manual", continue com o restante. Não tente analisar o DOM vazio como se tivesse conteúdo.
  4. Padrões muito genéricos. Quando os padrões extraídos forem fracos, diga isso explicitamente em vez de revestir as descobertas: "Os padrões entre esses 5 sites são principalmente genéricos — o segmento vertical pode ser muito amplo, ou o cânone da imprensa de design para este nicho é fino. Recomendo puxar referências adicionais manualmente ou refinar o brief."
  5. Modo de aumento. Se o usuário tiver 1–2 referências e quiser que a pesquisa encontre mais ("Eu tenho o site X, encontre mais alguns parecidos com este"), aceite URLs existentes como entrada semente. Deduplique contra a lista de candidatos. Execute a análise na união. Referências existentes não são ignoradas.

Fora do escopo

Esta skill não lida com:

  • Análise multimodal baseada em captura de tela. WebFetch funciona apenas com HTML; SPAs renderizados por JS podem precisar de uma visualização renderizada que esta skill não captura.
  • Pesquisa em cache entre sessões. Cada execução de /research é nova.
  • Marcação automatizada / pesquisa de arquivo. Nome de arquivo + grep é a história de busca.
  • Raspagem direta de galerias (Awwwards, Land-book). Sem APIs públicas; sensível a Termos de Serviço.
  • Métricas de sucesso comercial ou dados de tráfego. Sinal errado — pesquisamos linguagem de design, não estratégia de negócios.

Como é o sucesso

Após uma sessão de /research, o usuário tem uma nota Markdown salva com 5 sites de referência verificados e de qualidade de imprensa de design, analisados através das mesmas lentes de todo o resto na ferramenta, com padrões extraídos e lacunas na biblioteca de presets sinalizadas. Projetos futuros no mesmo segmento vertical encontrarão a nota através da consulta a pesquisas anteriores, para que nenhum esforço de pesquisa seja desperdiçado.

Habilidades Relacionadas