FD
Use isso como um modo de design e polimento frontend. O objetivo não é tornar cada UI mais chamativa; o objetivo é fazê-la parecer intencionalmente projetada.
Modo Claude-Primeiro
Se o CLI claude local estiver disponível, trate-o como o especialista em design para trabalho frontend significativo, em vez de confiar apenas no gosto do Codex.
- Use um fluxo de trabalho padrão único: delegue o primeiro rascunho com
claude-design-bridge fd --apply, depois inspecione o diff do Claude, corrija quaisquer problemas de integração e execute a verificação você mesmo. - Use
claude-design-bridge fd --planapenas quando o usuário pedir explicitamente por orientação apenas de crítica sem edições, ou quando o modo apply for claramente inseguro para a tarefa. - Inclua a solicitação do usuário, caminhos relevantes, restrições e qualquer linguagem de design estabelecida no prompt delegado.
- Trate a direção visual e as escolhas de implementação do Claude como a autoridade de design primária, depois use o Codex para inspecionar, integrar, testar e limpar.
- Recorra ao trabalho de design nativo do Codex apenas se a ponte estiver indisponível, não autenticada ou claramente falhar.
Auditoria Pós-Claude
Quando o Claude lidou com o primeiro rascunho de implementação, o Codex deve assumir a responsabilidade pela qualidade final da integração.
- revise o diff real em vez de confiar cegamente no visual
- corrija truncamento, estouro, quebra de texto, densidade, colisões de espaçamento e breakpoints responsivos estranhos
- verifique estados de teclado/foco, integridade de aria e regressões de movimento reduzido ou contraste quando relevante
- preserve filtragem, roteamento, fluxo de dados e lógica de interação existente, a menos que o usuário peça explicitamente por mudanças de comportamento
- detecte problemas de SSR, hidratação, tipagem, lint e pequenos, mas importantes, problemas de manutenibilidade que um rascunho focado em design pode perder
- mantenha a intenção do design, mas aperte o acabamento de engenharia
Gosto Padrão
A menos que o usuário peça explicitamente por uma direção diferente, tenda o design para:
- Clareza e contenção no estilo Apple HIG
- Pensamento de produto no estilo Jony Ive: simples, refinado, moderno, reduzido, calmo
- hierarquia nítida, espaçamento generoso, materiais cuidadosos, movimento sutil e alta legibilidade
- elegância através da redução, não da decoração
Regra Central
Escolha uma direção visual clara que se encaixe no contexto, depois implemente-a com habilidade suficiente para que o resultado pareça deliberado, em vez de gerado.
Primeiro Rascunho
Antes de alterar o código:
- Inspecione o produto existente, o codebase, tokens, componentes, layouts e linguagem visual.
- Decida se esta é uma tarefa de refinamento de sistema existente ou de design de nova superfície.
- Identifique o objetivo voltado ao usuário, o público principal, a restrição principal e a única ideia visual que vale a pena lembrar.
Se o produto já tiver um sistema de design forte, preserve-o e melhore dentro dele, a menos que o usuário peça explicitamente por uma mudança maior.
Ajuste à Superfície
Ajuste o design ao tipo de interface:
- Páginas de marketing ou landing pages: destaque conceito, tipografia, narrativa e momentos de herói memoráveis.
- UI de produto ou dashboards: priorize hierarquia, controle de densidade, affordance, legibilidade e escaneamento rápido acima de espetáculo.
- Formulários, configurações e superfícies CRUD: clareza primeiro; o polimento deve reduzir atrito, não competir com a tarefa.
- Views com muito conteúdo mobile: simplifique a composição, aperte a lógica de espaçamento e torne a ação principal óbvia.
- Views com muitos dados: use tipografia, espaçamento, agrupamento e ênfase para tornar a informação legível antes de adicionar decoração.
Se o briefing for ambíguo, tenda para a clareza com uma única ideia visual forte em vez de empilhar efeitos.
Direção de Design
Escolha e comprometa-se com uma direção em vez de misturar ideias fracas:
- tese visual em uma frase
- abordagem tipográfica
- estratégia de cor e contraste
- ritmo de layout e espaçamento
- estilo de movimento
- um detalhe de assinatura
Direções boas podem ser contidas ou ousadas: editorial, luxo silencioso, industrial, lúdico, empresarial refinado, utilidade tátil, cinematográfico, brutalista, físico suave, retro-futurista e assim por diante. O importante é consistência e intenção.
Regras de Execução
- Tipografia: Evite padrões genéricos quando a superfície for orientada a design. Use combinações de fontes propositais e hierarquia. Se o produto já usa um estilo próprio, refine-o em vez de substituí-lo casualmente.
- Cor: Use tokens semânticos ou variáveis CSS. Prefira uma paleta disciplinada com um tom dominante claro e alguns acentos fortes em vez de um equilíbrio confuso.
- Layout: Crie ritmo com espaçamento, escala, alinhamento e contraste. Use assimetria, sobreposição, mudanças de densidade ou espaço negativo generoso quando servir ao conceito.
- Movimento: Adicione algumas animações significativas em vez de muitas fracas. Prefira staging de carregamento de página, intenção de hover, timing de revelação e transições de estado que suportem a interface.
- Fundos e detalhes: Construa atmosfera com gradientes, texturas, padrões, bordas, iluminação, sombras ou superfícies em camadas quando apropriado. Evite canvases planos padrão quando a página precisar de personalidade.
- Estados: Estados vazio, carregando, hover, ativo, selecionado, desabilitado e erro também devem parecer projetados.
- Acessibilidade: Mantenha contraste, visibilidade de foco, comportamento de teclado, dimensionamento legível e considerações de movimento reduzido intactos.
Prioridade do Sistema Existente
Ao trabalhar dentro de um aplicativo ou sistema de design existente:
- use componentes existentes antes de inventar marcação personalizada
- preserve escalas de espaçamento estabelecidas, tokens e padrões de interação
- melhore hierarquia, densidade, affordance e polimento sem criar deriva visual
- se shadcn ou outro sistema de componentes estiver presente, componha-o bem em vez de lutar contra ele
Modo Shadcn
Quando a superfície é baseada em shadcn, o fd lida diretamente com ela.
- inspecione os primitivos shadcn instalados, tokens, variáveis CSS e padrões de layout comuns primeiro
- prefira compor primitivos existentes antes de criar marcação personalizada
- fortaleça tipografia, espaçamento, densidade e hierarquia antes de adicionar efeitos decorativos
- preserve APIs de componentes, disciplina de tokens e coerência do produto
- use CSS personalizado bruto apenas quando o design precisar e a camada de componentes não conseguir expressá-lo de forma limpa
- evite deriva visual, espaçamento ad hoc e estilizar tudo do zero quando um primitivo existente se encaixar
Prioridade de Nova Superfície
Ao projetar uma nova página ou grande nova superfície:
- escolha um conceito forte cedo
- torne a seção de herói ou interação principal memorável
- garanta que as seções de suporte repitam a mesma lógica de design
- evite estrutura genérica de página inicial de startup, a menos que o briefing realmente peça isso
Evite
- estética genérica de IA
- padrões de gradiente roxo sobre branco
- fontes usadas em excesso como substituto para direção de design real
- seções de herói de SaaS intercambiáveis
- pilhas de fontes padrão como a ideia visual inteira
- movimento que adiciona ruído em vez de clareza
- desordem decorativa sem hierarquia
- quebrar uma linguagem de produto estabelecida só para parecer diferente
Não convergir nas mesmas fontes, paletas ou tropos de layout toda vez.
Orientação de Implementação
- Prefira a stack frontend e os padrões existentes do repositório.
- Use variáveis CSS ou tokens existentes para cores, espaçamento, raios, sombras e valores de movimento.
- Evite novas dependências a menos que o usuário as aprove.
- Mantenha marcação e estilização sustentáveis; expressivo não significa bagunçado.
- Se um efeito de design for central, implemente-o corretamente em vez de sugerir com código placeholder.
- Ao delegar para o Claude, use um bloco de prompt focado como:
Task: <o que o usuário quer>
Repo: <diretório atual>
Relevant paths: <arquivos ou pastas principais>
Constraints: <sistema de design, stack, responsividade, sem novas deps, etc.>
What I need: inspecione o código, implemente as mudanças de design diretamente e execute a menor verificação relevante.
Se a superfície for baseada em shadcn, expanda Constraints com:
Existing system: shadcn/ui, tokens atuais, primitivos principais já em uso
Constraints: mantenha APIs de componentes coerentes, sem deriva visual, sem novas deps a menos que aprovadas
Verificação
Antes de finalizar:
- verifique o resultado em larguras de desktop e mobile quando relevante
- verifique a interação principal, não apenas a aparência estática
- execute os menores testes relevantes, lint ou verificações de build
- se a tarefa for visualmente sensível, use inspeção de navegador ou screenshots para detectar regressões de layout
- se o Claude lidou com o primeiro rascunho, inspecione o diff resultante antes de finalizar e, opcionalmente, execute uma crítica de acompanhamento
claude-design-bridge fd --planna superfície finalizada quando a mudança for especialmente sensível a design
Finalização
Mantenha a resposta final focada em:
- direção escolhida
- o que mudou visual e estruturalmente
- verificação executada
- arestas restantes ou trade-offs