Pesquisa de design: o loop de especialização
Ferramentas:
ddr <comando>após instalação (python tools/ddr.py install), senãopython <repo>/tools/ddr.py <comando>, onde<repo>fica duas pastas acima da pasta real (com resolução de symlink) desta skill.
Você projeta bem onde olhou com atenção, e mal em todo o resto. Esta skill é como se tornar um especialista numa área antes de projetar para ela, e como essa especialização se mantém verdadeira ao longo do tempo. O resultado não é um moodboard. É um domínio: um dossiê do que você agora entende, uma biblioteca de referências que você realmente viu, e uma pontuação de confiança calculada a partir dessa evidência.
Pesquisa que não muda uma decisão é navegação. Pesquisa que você não registrou está perdida. Faça ambas corretamente ou não afirme que pesquisou.
0. Onde você está
ddr domain match "<o brief em uma frase>"
Retorna o setor (o tipo de negócio ou público) e o padrão (o fluxo ou superfície: onboarding, checkout, reserva, precificação, dashboard) com uma confiança para cada. Em seguida, ddr domain plan <slug> --stakes baixo|médio|alto:
| Stakes | Quando | Alvo |
|---|---|---|
| baixo | um componente ou um ajuste dentro de um sistema existente | 35 |
| médio | uma página, um fluxo, um redesign de uma superfície | 55 |
| alto | um novo site, uma marca, um lançamento, qualquer coisa pela qual um negócio será julgado | 70 |
Se o alvo for atingido, leia ddr domain brief <setor> <padrão> e volte para o diretor-de-design. Caso contrário, execute o loop abaixo até atingi-lo, ou até ter feito o que o tempo permite e poder dizer claramente o quanto avançou. Não espere ser perguntado. Diga ao usuário uma linha: "A confiança em estadias independentes é 12, então estou pesquisando a categoria primeiro (cerca de 20 referências)."
Território novo
Quando nenhum domínio corresponde, crie um. Escolha o nível no qual as referências se transferem: casas de repouso e consultórios dentários são ambos "saúde" mas seus sites compartilham quase nada, então são setores separados. Dois domínios cujas melhores referências seriam a mesma lista são um domínio.
ddr domain new estadias-independentes --kind setor --title "Estadias independentes" \
--summary "Cottages, guesthouses e pequenos hotéis que vendem direto" \
--keywords "self catering,cottage,guesthouse,b&b,boutique hotel,aluguel de temporada" \
--aliases "acomodação de curta duração,aluguel de férias"
Palavras-chave são as palavras que um cliente usaria, não palavras de design. Um padrão é algo que recorre entre setores com suas próprias melhores práticas; crie um quando o brief se centrar nele. Relacione domínios que se informam mutuamente (ddr domain relate estadias-independentes reserva --how "disponibilidade antes do preço"), mescle dois que acabam sendo um (ddr domain merge <de> <para>, nada é deletado), e divida um que cresceu dois públicos criando o segundo e movendo as referências que pertencem a ele.
Seus instrumentos
Use o melhor que você tem, nesta ordem, e diga qual usou:
| Trabalho | Melhor | Alternativa |
|---|---|---|
| Encontrar candidatos por descrição | Exa MCP (ddr mcp --research mostra a configuração) | sua própria pesquisa na web, o catálogo |
| Encontrar os melhores independentes num lugar ou comércio | Brave Search MCP pesquisa local e de lugar | pesquisa web por "melhor <comércio> em ", sites de avaliação, listas de premiações |
| Capturas de tela e fluxos de produtos reais | Mobbin ou Refero MCP (pago) | análises públicas, percorrer o fluxo você mesmo |
| Olhar uma referência e medi-la | ddr teardown <url> --into <slug> | Playwright ou Chrome DevTools MCP, depois capturas de tela |
| Percorrer uma jornada com segurança | ddr teardown <url> --walk "Reserve agora>Verificar disponibilidade" | Playwright MCP, nunca enviando nada |
| Ver quão antigo é um design | ddr history <url>, depois desmonte uma versão arquivada | as próprias notícias ou posts de lançamento do site |
| Comparar lado a lado | ddr sheet --domain <slug> --with seu.png | ddr sheet a.png b.png c.png |
| Extrair tokens de uma marca | Firecrawl MCP formato branding | tipo e paleta medidos pelo ddr teardown |
ddr teardown salva as dobras do desktop e do celular, uma página inteira e uma faixa de quadros de parada de rolagem, e mede a página ao vivo: as faces e tamanhos por quanto texto elas definem, a paleta por área pintada, cores de controle, raios, sombras, padding de seção, largura de parágrafo, movimento (timings de transição, bibliotecas de rolagem, vídeo, canvas, regras de movimento reduzido), a stack em que foi construído, a navegação, as chamadas para ação e se alguma está acima da dobra, e os sinais de design gerado (texto padrão, sobrancelhas, texto gradiente, vidro, tríades de cartão com ícone). Os números tornam suas observações específicas. Eles nunca substituem olhar: abra as imagens.
1. Mapeie o território
Escreva quem são os melhores de verdade antes de abrir uma galeria. Os melhores numa categoria são os negócios que as pessoas naquele comércio admiram, os que vencem por reputação, e aqueles cujos sites a categoria copia. Encontre-os de três maneiras:
- Direto (
--angle direto): os 6 a 12 mais fortes nesta categoria exata, no topo do mercado e entre os pequenos independentes que claramente estão fazendo bem. Use pesquisa na web, imprensa especializada, listas de premiações na categoria e o catálogo (ddr sources search "<categoria>" -v). - Líder (
--angle líder): o melhor trabalho numa categoria adjacente que resolve o mesmo problema para um cliente mais exigente (um grupo de hotéis boutique para um cottage, um banco privado para uma cooperativa de crédito). - Externo (
--angle externo): pelo menos duas referências de outra disciplina completamente, escolhidas pelo mundo do assunto (guias impressos, monografias de arquitetura, menus, títulos de filmes, sinalização).ddr sources shuffle -n 4dá uma seleção.
Galérias (Awwwards, recent.design, Land-book) são pistas, nunca evidência. Prefira prêmios de ano e mês em vez de seleções diárias.
2. Olhe adequadamente
Uma referência só conta tanto quanto você realmente viu:
--evidence | O que significa | Peso |
|---|---|---|
search | Você leu sobre ela ou viu uma miniatura | um quarto |
visited | Você carregou o site ao vivo e o leu | um |
screenshot | Você o renderizou e olhou os pixels no desktop e celular | mais |
flow | Você percorreu a jornada real (reservar, inscrever-se, finalizar compra) | o máximo |
Desmonte cada candidato sério e abra as imagens:
ddr teardown https://a.exemplo https://b.exemplo --into <slug>
Olhe as dobras e os quadros de rolagem, não apenas os números. Para os dois ou três melhores, execute também ddr history <url>: uma referência "fresca" cuja aparência data de 2019 é agora um template, e uma versão arquivada mostra quais movimentos são novos. Percorra a jornada que corresponde ao brief até onde for possível sem pagar ou enviar nada. Uma tela de carregamento ou um aviso de cookies não é o design; anote-o e olhe além dele.
Se os termos de um site proibirem acesso automatizado (agent_access = "scrape-no" no catálogo), navegue como uma pessoa faria e registre visited. Nunca copie telas protegidas por paywall ou fotografias de ninguém para um repositório público; capturas de tela ficam no seu diretório do domínio, que nunca é publicado.
3. Desmonte e registre
Para cada referência que mereceu seu lugar, registre-a imediatamente, usando os valores medidos do seu teardown.md:
ddr domain ref add <slug> --name "Nome" --url https://... --verdict exemplar \
--angle direto --evidence screenshot --score 4 --shots shots/<host> \
--take "Calendário de disponibilidade é o hero, preços mostrados por noite ao lado de cada data, configurado em uma serifa condensada a 15px" \
--avoid "Vídeo de drone em reprodução automática atrasa a primeira tela útil em 4s" \
--tags layout:calendario-hero,tipo:serifa-condensada
--take é o movimento específico, com valores quando você os tiver (tamanhos, cores, timings, as palavras reais). "Limpo e moderno" não é um take. Pontue honestamente: 5 muda como você projetaria isso, 3 é sólido e típico, qualquer coisa que você pontuaria 2 não é um exemplar.
4. Cace o slop
Encontre 3 a 5 contraexemplos (--verdict contra --avoid "..."): os sites template, os que parecem gerados, os desatualizados nesta categoria. Eles são tão valiosos quanto os exemplares, porque mostram como é o slop específico desta categoria, que o SLOP.md no diretor-de-design só pode descrever em geral. Escreva o padrão na seção Slop da categoria do dossiê. A confiança é limitada a 60 até que essa seção exista.
5. Escreva o dossiê
Abra $(ddr domain path <slug>)/dossier.md e escreva cada seção a partir do que viu, nomeando as referências. Seja concreto e opinativo:
- Para quem é: quem usa, com o que se preocupa, com o que compara.
- O que os melhores fazem: os movimentos que os melhores compartilham, com valores.
- Convenções a manter: em que os usuários confiam. Faça-as excepcionalmente bem.
- Convenções a quebrar: o que é preguiçoso ou desatualizado aqui, e o que o substitui.
- Slop da categoria: como o trabalho gerado e template se parece nesta categoria.
- Linguagem: tipo, cor, imagética, voz e movimento que pertencem a este mundo, e por quê.
- Perguntas em aberto: o que você ainda não sabe e o que o responderia.
6. Curadoria
ddr domain audit <slug> --online
Ele sinaliza referências que estão obsoletas (não vistas em um ano), fracas (apenas pesquisa), contraditórias (um exemplar que você pontuou 2), mortas, movidas, ou todas de um único ângulo ou fonte. Aja em cada descoberta: olhe novamente (ddr domain ref seen), repontue, ou aposente com um motivo (ddr domain ref retire <slug> <id> --reason "redesenhado como template em 2026"). Referências aposentadas permanecem no cemitério para que nunca sejam readicionadas silenciosamente. Uma biblioteca só é tão boa quanto o que você está disposto a descartar.
7. Compare, depois repontue
Faça uma folha de contato dos melhores do domínio (ddr sheet --domain <slug> --n 6) e olhe para ela como um conjunto. Se todos parecem iguais, a biblioteca convergiu para uma ideia e a próxima busca deve procurar a referência que os contradiz.
8. Repontue e decida
ddr domain status <slug>
Mostra a pontuação, cada parte dela, qualquer limite e o que o elevaria. Repita o loop nas maiores lacunas até que o alvo dos stakes seja atingido. Depois diga ao usuário onde você parou em uma linha ("Estadias independentes está agora em 58: 14 sites visitados, 4 contraexemplos, o slop escrito") e volte ao Passo 1 do diretor-de-design.
Profundidade
Escalone o esforço para os stakes e diga o que fez:
- baixo: 4 a 6 referências, um contraexemplo, a linha de slop escrita. Minutos.
- médio: 8 a 12 referências em todos os três ângulos, 3 contraexemplos, todas as seções do dossiê. Menos de uma hora.
- alto: 15 a 25 referências, fluxos percorridos nos melhores 3, 4 ou mais contraexemplos, duas referências externas, uma passagem de auditoria. O tempo que levar.
O projeto ainda mantém seu próprio livro-razão curto em .design/referencias.md: as 5 a 10 referências que mudaram uma decisão neste trabalho, uma linha cada, com a decisão que mudaram. O domínio é o que você sabe; o livro-razão do projeto é o que você usou.
Regras
- Empreste técnicas e princípios, nunca um logotipo reconhecível, fotografia, fonte paga ou ilustração proprietária.
- Registre acesso falho (paywall, bloqueio de bot, link morto) em vez de adivinhar o que estava por trás:
ddr domain log <slug> note "O Revolut bloqueou o renderizador e requisições simples". - Nunca registre uma referência como vista que você não viu. A pontuação existe para impedi-lo de reivindicar especialização que não conquistou; inflá-la derrota a única coisa para a qual serve.
- Quando uma entrada do catálogo estiver morta ou errada, corrija-a com
ddr sources add, e adicione também ótimas fontes novas lá, para que a próxima pessoa comece à frente.