O que replicar faz?
Transforme a fidelidade em um loop de implementação baseado em evidências. Inspecione a referência, faça um inventário de seus detalhes, implemente, compare, corrija e verifique. Uma primeira impressão convincente não é a conclusão: preserve os pequenos relacionamentos e comportamentos que tornam a referência distinta.
Comece pela referência do usuário
- Infira o alvo, escopo, plataforma e diferenças intencionais a partir da conversa. Esta skill funciona para uma captura de tela, arquivo de design, componente, implementação existente, aplicativo, site ou serviço. Não exija um original interativo quando o usuário forneceu um design estático.
- Inspecione a referência real antes de codificar. Prefira a fonte especificada pelo usuário; use software instalado para comportamento, arquivos de design para especificações explícitas de design e imagens em resolução total para aparência renderizada. Quando as fontes discordarem, registre a discrepância e aplique a prioridade declarada pelo usuário, em vez de misturá-las silenciosamente.
- Inspecione a implementação existente e as instruções do projeto. Preserve os recursos funcionais e as alterações do usuário. Se a tarefa for uma correção de fidelidade, corrija o design existente em vez de inventar uma nova direção.
- Pergunte apenas por informações ausentes que impeçam o progresso significativo. Se o acesso ao original não estiver disponível, continue com as evidências disponíveis e declare o que não pode ser verificado. Nunca invente observações.
- Estabeleça um conjunto limitado de fluxos ou estados e critérios de aceitação. Não interprete "replicar" como autorização para comprar, publicar, entrar em contato com outras pessoas, copiar credenciais ou alterar dados de serviço não relacionados.
Inspecione antes de simplificar
Crie um inventário compacto de referência usando evidence-template.md. Para um componente pequeno, isso pode ser algumas linhas; não transforme uma pequena edição em um grande projeto de documentação.
Inspecione a referência inteira e, em seguida, regiões individuais. Registre fatos observados, medições, estimativas e desconhecidos separadamente. Não substitua detalhes incomuns por padrões familiares apenas porque são mais fáceis de implementar.
Inspecione os detalhes aplicáveis:
- Layout: alinhamento, contenção, grade, margens, preenchimento, lacunas, proporções, camadas, recorte, áreas seguras e elementos fixos/pegajosos.
- Tipografia: família de fontes, peso, tamanho, altura da linha, espaçamento entre letras, linha de base, quebra de linha, truncamento e alinhamento. Comprimento do texto e conteúdo real fazem parte do layout.
- Superfícies: cores amostradas, gradientes, transparência, materiais, bordas, tratamento de cantos, sombras, recorte de arte, formato/peso de ícone e alinhamento óptico.
- Estados: selecionado, focado, pressionado, carregando, vazio, erro, desabilitado, expandido, rolado e teclado visível; variantes claro/escuro ou responsivas quando estiver no escopo.
- Comportamento: áreas de toque, navegação, comportamento do botão voltar, retenção de estado, escopo de pesquisa, menus, rolagem, sobre-rolagem, arrastar e gestos interrompidos.
- Movimento: gatilho, atraso, duração, atenuação/mola, deslocamento, ultrapassagem, desvanecimento, escala, ancoragem, interrupção e retorno ao repouso.
- Fluxos de trabalho do serviço: contratos de entrada/saída, ordenação, persistência, repetições, erros, latência e efeitos colaterais visíveis ao usuário. A semelhança visual por si só não reproduz um serviço.
Para referências estáticas, corresponda primeiro à aparência observável. Marque interações não mostradas e comportamento responsivo como inferidos; escolha um comportamento sensato sem alegar que foi observado. Para referências interativas, explore as transições completas, não apenas seus pontos finais. Inclua entrada rápida repetida e gestos parciais/cancelados quando relevante.
Escolha ferramentas para as evidências
Use ferramentas disponíveis, não nomes ou capacidades presumidas de ferramentas. Leia as instruções aplicáveis da ferramenta/skill antes de usá-las.
- Arquivos de design: use a integração de design relevante para inspecionar nós, estilos, recursos e restrições, além de pré-visualizações renderizadas. Exporte recursos autorizados reais quando possível, em vez de aproximá-los.
- Aplicativos: use ferramentas Argent/dispositivo para operação, capturas de tela, quadros de acessibilidade e rotas repetíveis. Use como padrão um telefone USB físico conectado antes de considerar um simulador. Aplique as skills de configuração/interação da plataforma quando necessário.
- Sites: use as ferramentas de navegador disponíveis para capturas de tela, estados de viewport, interações e inspeção de layout. Teste as larguras responsivas e modos de entrada relevantes.
- Capturas de tela: inspecione em resolução total e recorte regiões para análise. Meça em unidades lógicas quando a escala do dispositivo for conhecida; não confunda pixels de captura de tela com pontos de layout.
- Movimento: capture vídeo com ferramentas de gravação suportadas e inspecione quadros/folhas de contato. Meça a posição em relação ao tempo, incluindo os quadros finais de estabilização. Use gravações para estudar o movimento, não para alegar FPS de exibição que elas não podem estabelecer.
- Desempenho: use profilers nativos/Instruments para aplicativos nativos ou ferramentas de desempenho do navegador para aplicativos web. Leia as skills de perfil relevantes. As skills de animação/polimento de IU complementam as evidências de referência; suas preferências gerais não devem substituir o design solicitado.
- Serviços: use APIs documentadas, conectores disponíveis e dados de teste controlados para comparar contratos observáveis. Evite testes destrutivos e solicitações pagas desnecessárias.
Use pequenos scripts de medição quando eles resolverem a incerteza. Prefira amostragem reproduzível a uma cor, fonte, espaçamento ou mola adivinhados. Não instale uma grande cadeia de ferramentas para uma pequena comparação quando as ferramentas existentes forem suficientes.
Implemente um recorte completo
- Reproduza um fluxo ou componente representativo completo com conteúdo real antes de expandir. Escolha um que exercite o layout importante e as transições de estado.
- Codifique os valores medidos compartilhados de forma coerente. Mantenha a identidade do componente, estado de navegação e layout estáveis entre as transições.
- Use mecanismos nativos/da plataforma onde eles correspondem à referência. Use implementação de nível inferior apenas quando a observação ou teste demonstrar uma incompatibilidade. Não presuma que uma folha, menu ou mola padrão corresponde apenas porque parece nativa.
- Preserve texto, recursos, ordenação e detalhes visuais distintos. Não adicione gradientes, decoração, seções de espaço reservado, alterações de cópia ou "melhorias" ausentes na referência, a menos que solicitado.
- Mantenha o comportamento funcional correto enquanto corresponder à aparência. Carregamento, pré-processamento ou animações não devem bloquear desnecessariamente uma ação que já pode prosseguir.
Compare e corrija
Execute este loop após cada recorte significativo:
- Coloque a referência e a implementação em estados comparáveis: mesmo conteúdo, viewport/dispositivo, escala, tema, posição de rolagem, teclado e estado relevante de dados/reprodução.
- Capture ambos. Compare a composição completa e, em seguida, as regiões. Use sobreposições/comparações de diferença quando útil e inspecione as imagens reais, não apenas uma pontuação. Mantenha as máscaras de exclusão explícitas e limitadas a áreas genuinamente variáveis.
- Registre as discrepâncias concretas, suas evidências e gravidade. Corrija as maiores diferenças estruturais primeiro, depois tipografia/superfícies, depois movimento e pequenos detalhes de interação. Revise a estrutura se observações posteriores a contradisserem.
- Para movimento, compare a transição inteira, incluindo o primeiro quadro, cancelamento, ultrapassagem, cobertura da área segura e estabilização final. Procure por flashes, mudanças tardias de fundo, barras desaparecendo, redimensionamento de ícones e reconstrução de conteúdo.
- Repita as verificações afetadas após as correções, além de regressões comportamentais relevantes. Não continue repetindo testes amplos depois que passarem sem novas evidências que os justifiquem.
Não trate a incompatibilidade de pixels como uma pontuação universal de similaridade. Declare o estado exato, dispositivo/viewport, limite e máscaras por trás de afirmações quantitativas. Corresponder a uma captura de tela não estabelece paridade de produto inteiro. Diferenças de renderização/fonte podem ser restrições legítimas; identifique-as em vez de escondê-las atrás de limites amplos.
Se parece certo, mas parece errado
Separe o design de movimento do desempenho da execução. Perfile antes de alterar durações ou molas aleatoriamente.
- Repita a mesma carga de trabalho representativa antes e depois da alteração, com sobrecarga de observação comparável.
- Evite capturas de tela/consultas de acessibilidade por quadro durante medições sensíveis ao tempo. Capture evidências visuais separadamente quando a instrumentação alterar a carga de trabalho.
- Investigue transformações repetidas de dados, invalidação excessiva de estado, reconstrução de visualização, E/S síncrona, decodificação, trabalho de layout e callbacks de gestos duplicados.
- Altere o gargalo demonstrado e, em seguida, verifique o desempenho e a aparência. Reter visualizações/caches troca memória por velocidade: limite-os e lide corretamente com a invalidação/ciclo de vida.
- Relate o que foi medido e suas limitações. A reamostragem de vídeo não é FPS de exibição; cargas de trabalho diferentes não são uma linha de base numérica válida.
Termine com evidências
Conclua a implementação e verificação autorizadas, não apenas uma auditoria ou plano, a menos que o usuário tenha solicitado apenas pesquisa.
Antes de considerar o trabalho concluído:
- Cada critério de aceitação no escopo tem evidências de implementação e verificação, ou uma limitação explícita não resolvida.
- Estados estáticos importantes foram comparados com a referência; transições importantes foram exercitadas quando observáveis.
- As verificações funcionais cobrem o comportamento que a alteração poderia quebrar. Use rotas repetíveis para fluxos substanciais; evite testes que apenas reafirmam código de estilo trivial.
- Diferenças intencionais conhecidas são distinguidas de defeitos e desconhecidos.
- O relatório final indica o que mudou, o que foi realmente testado e as diferenças restantes. Vincule evidências de comparação úteis; não afirme "perfeito em pixels" ou "comportamento exato" além do que foi verificado.
Mantenha em mente os limites de recursos do host. Serialize builds/perfis pesados em máquinas com recursos limitados. Feche apenas janelas, aplicativos, dispositivos e serviços iniciados para esta tarefa que não são mais necessários. Preserve o trabalho existente do usuário e os serviços necessários. Mantenha segredos e dados de sessão pessoais fora das evidências e do controle de versão. Não exclua evidências de referência sem autorização; retenha capturas finais e medições úteis.
Exemplos de invocação
/replicar Corresponda esta captura de tela na página existente. Preste atenção à tipografia e ao espaçamento./replicar Implemente este arquivo de design, incluindo suas variantes móveis. Preserve o comportamento de checkout existente./replicar Recrie os fluxos do player e de pesquisa deste aplicativo. Compare ambos os aplicativos no telefone conectado./replicar A implementação atual perdeu detalhes deste design. Inspecione ambos e finalize a passagem de fidelidade./replicar Reproduza o fluxo de importação deste serviço com nosso backend, incluindo estados de progresso, repetição e falha.