Craft UI
Imagem de referência fornecida, layout funcional gerado — mas apenas depois que o produto e a solicitação forem compreendidos.
A falha que esta skill existe para prevenir: uma página de aparência plausível feita de seções aleatórias, texto placeholder, gradientes padrão e faixas vazias. Isso acontece quando um agente projeta com base em hábitos de gênero em vez de evidências. Aqui, toda decisão estrutural e visual deve ser rastreável a uma de três fontes: o produto ao vivo, o briefing do usuário ou uma referência realmente vista. Se uma fonte estiver faltando, colete-a ou peça por ela. Nunca preencha a lacuna com um padrão.
Regras inegociáveis
- Nenhum código antes do Contrato de Design (etapa 2). Sem exceção para páginas "rápidas":
discovery: liteencurta o contrato, não o remove. A economia é gerenciada pelo roteador, não pulando contexto. - Evidências sobre padrões. Cada token, seção e linha de copy cita de onde veio. "Típico para landing pages" não é uma fonte.
- Estrutura é uma espinha dorsal, não um bufê. As seções existem apenas se respondem a uma pergunta do visitante ou a um objetivo do briefing. Veja
references/anti-ai-slop.md. - Conteúdo real. Nome do produto, rótulos, dados e idioma vêm do site/briefing. Sem lorem, sem logotipos falsos, sem métricas inventadas, sem "Seu produto aqui" a menos que o usuário aprove um placeholder.
- Responda no idioma do usuário e construa a IU no idioma do produto (um produto pt-BR recebe copy pt-BR).
- Um movimento memorável, não um fade-up em cada seção.
- Tokens antes de componentes. Cores, raios, tipografia, espaçamento, sombras e easing vivem em variáveis CSS; os componentes leem apenas essas.
- Economia é uma decisão. O roteador define a verbosidade e quais skills são executadas. Leia apenas as seções de referência que se aplicam.
- Padrão de qualidade profissional.
references/quality-bar.mdé a definição de pronto — conteúdo, fidelidade visual, responsivo, WCAG AA, desempenho e entrega.terseo verifica silenciosamente; nunca é pulado.
Fluxo de Trabalho
0. Triagem (agente principal, segundos)
- Capture a solicitação do usuário textualmente; anote qualquer URL, anexo, restrição "não quero" e dicas de verbosidade ("só o código", "rápido", "me explica").
- Verifique o que está disponível: ferramenta subagent/Task, navegador ou web fetch, repositório local, lista de skills/MCP.
- Se a solicitação for um pequeno ajuste em um arquivo existente (uma cor, um valor de espaçamento), informe ao roteador — ele pode definir
discovery: lite. Uma nova página ou um redesign sempre recebediscovery: full. - Se o usuário disser que o layout existente está "amador", "precisa melhorar", "conserta essa landing" ou apontar para um site ao vivo com código, leia
references/polish-existing-site.mde siga esse caminho: polimento aditivo da base de código real, não uma reconstrução. Executegit statusantes de tocar nos arquivos.
1. Três agentes de descoberta (executados em paralelo)
Use sua ferramenta de subagente — OpenCode subagent, Claude Code Task/Agent, Codex spawn_agent, Cursor background agent. Se não houver ferramenta de subagente, execute as três passagens sequencialmente no agente principal e rotule cada uma com seu título. Agentes de descoberta não escrevem código.
| Agente | Missão | Alimenta o contrato com |
|---|---|---|
| A — Analista do Site de Produção | Entender o site como ele existe em produção: produto, público, copy real, estrutura atual, tokens da marca, restrições. | BRIEF DE CONTEXTO DO SITE |
| B — Analista de Solicitação e Referência | Decodificar a solicitação real e extrair o DNA estilístico apenas de referências realmente vistas; pesquisar referências quando nenhuma for fornecida. | BRIEF DE SOLICITAÇÃO + DNA ESTILÍSTICO |
| C — Roteador de Skill / Economia | Selecionar o conjunto mínimo de skills/ferramentas extras para esta execução e definir a verbosidade. | DECISÃO DE ROTEAMENTO |
Especificações completas, esquemas de saída e orçamentos de palavras: references/agents.md. Passe para cada agente o caminho absoluto da raiz da skill, sua especificação de função, a solicitação bruta do usuário e os URLs/anexos. Limite as respostas aos seus orçamentos de palavras.
Quando uma imagem de referência estiver envolvida, leia também references/pattern-transfer.md. Tokens estilísticos viajam; receitas de composição não. Nunca adote um padrão de herói ou seção apenas da referência — ele deve ser justificado pelo produto (A) e pela solicitação (B).
2. Contrato de Design — portão rígido
Leia references/design-contract.md. Mescle A + B + C em um único contrato. Em seguida, verifique:
- A espinha dorsal da estrutura está ordenada; cada seção tem um trabalho, uma fonte, uma topologia copiada literalmente da referência e conteúdo real; não há faixa vazia.
- Cada token e linha de copy cita uma fonte; itens desconhecidos são marcados, não inventados.
- Conflitos entre agentes/site/referência foram resolvidos perguntando ao usuário uma pergunta consolidada (máx. 3 itens), não por suposição.
- Verbosidade e lista de skills vêm de C; nenhuma skill é executada "só porque existe".
- Registro de adoção de padrão existe: cada
adotar/adaptar/descartarcita A e B; nenhuma receita de herói/seção veio apenas da referência (vejareferences/pattern-transfer.md). - A composição não seria plausível para um produto não relacionado em um campo diferente. Tokens são portáteis; a receita do herói não é.
Os subagentes de descoberta nunca perguntam ao usuário — eles apenas relatam Lacunas / Desconhecidos. O agente principal coleta todos os três briefings, faz uma pergunta consolidada (máx. 3 itens) e mantém o portão fechado até que seja respondida. Se um fato material ainda for desconhecido (nome do produto, público, conteúdo real, imagem de referência), pergunte e pare. Não inicie a etapa 3.
3. Plano
Plano compacto: tokens, wireframe ASCII da espinha dorsal, banco de copy/dados reais e o momento de um movimento com seu gatilho e motivo. Compare com a referência e o briefing do site; qualquer coisa que seja um padrão em vez de algo observado é revisada ou descartada.
4. Construir
- Um arquivo HTML autocontido por padrão (variáveis CSS como tokens, Google Fonts com fallbacks reais). Use o React/Tailwind existente do projeto apenas se o projeto do usuário já o utilizar.
- Receitas de movimento:
references/motion-and-effects.md. GSAP de uma versão fixa do cdnjs. - Mantenha o código enxuto: nenhuma biblioteca ou abstração que o layout não precise.
- Responsivo em 1440 / 768 / 390, estados de foco visíveis,
prefers-reduced-motionrespeitado. - Releia
references/anti-ai-slop.mddurante a construção — especialmente as linhas de faixa vazia e bufê de seções.
5. Verificar visualmente
Renderize e compare lado a lado com a referência e o briefing do site. Use uma ferramenta de navegador quando disponível (roteada por C). Execute o protocolo de verificação em references/quality-bar.md: screenshots de página inteira em 1440 / 768 / 390, ordem das seções e presença de conteúdo, sem faixa vazia ou texto cortado, sem rolagem horizontal, contraste em pixels reais, foco do teclado, movimento reduzido e erros no console. Verifique hierarquia, ritmo de espaçamento, consistência de raio/sombra, densidade e idioma. Rodadas de correção: 1 quando a verbosidade é terse, até 3 quando full; corrija a maior diferença visual primeiro e pare quando a lista de verificação passar.
6. Responder
Formate de acordo com a verbosidade de C. terse: 3–5 linhas — o que foi construído, evidências usadas, resultado da verificação. full: também liste quais características da referência foram retiradas de onde, skills usadas/puladas e uma sugestão de próxima alteração. Siga os critérios de entrega em references/quality-bar.md, declare os limites conhecidos uma vez e sempre escreva no idioma do usuário.
Usando outras skills
O Agente C decide isso por execução; verifique primeiro o que está realmente disponível na sessão. Skill faltando → use o fallback e mencione-o uma vez no final.
| Fase | Se C disser para usar | Fallback |
|---|---|---|
| Plano / direção de design | Impeccable (/impeccable shape, depois craft); execute sua etapa de contexto uma vez por sessão | frontend-design ou o plano da etapa 3 |
| Revisão e polimento | Impeccable critique, polish, audit | Auto-revisão contra o contrato |
| Qualidade de movimento | emil-design-eng para easing, duração, springs, hover/press | references/motion-and-effects.md |
| Verificação visual | Browser MCP (Chrome DevTools / Claude in Chrome / developer-mcp-chrome): screenshot em 3 larguras, verificar console | Descreva as verificações e peça ao usuário um screenshot |
| Logo ou objeto 3D | img2threejs apenas se a referência contiver um objeto 3D que valha a pena reconstruir; declare seu limite: uma imagem não pode revelar lados ocultos | SVG plano ou CSS |
| Manter código pequeno | ponytail antes de adicionar qualquer dependência | CSS puro + uma timeline GSAP |
Chame uma skill apenas quando sua fase se aplicar. Uma landing page estática não precisa de img2threejs.
Originalidade e segurança
- Recrie padrões, não ativos. Nunca reutilize o logotipo, ilustrações, nome da marca ou copy exata de uma referência. Use a marca do usuário e o conteúdo real de A/B.
- Muitos pins levam a kits de UI comerciais. Corresponda apenas ao estilo e à estrutura.
- A aparência de uma referência é um ponto de partida. Se prejudicar a usabilidade (baixo contraste, tipo pequeno), mantenha o clima, corrija o problema e informe.
Arquivos
references/agents.md— os três agentes de descoberta, esquemas e orçamentos.references/design-contract.md— modelo de mesclagem e portão rígido.references/anti-ai-slop.md— sintomas e correções para layouts genéricos, empilhados e vazios.references/quality-bar.md— definição profissional de pronto e protocolo de verificação.references/pattern-transfer.md— impede que imagens de referência transplantem a mesma receita de herói para produtos não relacionados.references/polish-existing-site.md— fluxo de trabalho aditivo quando a tarefa é elevar um layout de produção existente.references/categories.md— benchmarks de gênero (viabilidade mínima, não menus de seção).references/style-dna.md— modelo de leitura de referência; requer evidências.references/motion-and-effects.md— efeitos CSS e receitas GSAP.assets/refs.json— links de referência conhecidos (ainda exigem visualização).