Como usar o Replica Skill para criar uma alternativa a qualquer app com IA

O repositório replica-skill reúne 11 skills para Claude e Claude Code que organizam a criação de uma alternativa limpa para um aplicativo existente: pesquisa de funcionalidades, arquitetura, design, desenvolvimento, testes, comparação, reposicionamento, lançamento e deploy. O projeto é gratuito, usa licença MIT e inclui seis scripts em Python sem dependências externas. Ele não é um “botão de clonar apps”: é um método operacional para reconstruir fluxos e funcionalidades com código, marca, textos e infraestrutura próprios — sem copiar ativos, código, conteúdo ou APIs privadas do produto analisado.

Por que esse projeto importa em 2026

Ferramentas de IA reduziram o tempo para produzir telas e código, mas ainda deixam um problema difícil: transformar uma referência de mercado em um produto próprio, testável e juridicamente menos arriscado. Um clone superficial pode parecer convincente em uma captura de tela, porém falha em fluxos reais, dados, permissões, pagamentos, estados de erro e diferenciação de mercado.

O replica-skill, de Jake Schincariol, tenta resolver esse problema com uma sequência de trabalho. Cada etapa grava arquivos em uma pasta replica/ dentro do projeto; a skill seguinte usa esses artefatos como entrada. O resultado esperado não é uma cópia visual do concorrente, mas uma implementação nova de funcionalidades e padrões de experiência do usuário, com marca própria.

✅ O que você ganha — e ⚠️ o que você não ganha

✅ O que o Replica ajuda a fazer

• Mapear telas, fluxos, componentes e um modelo de dados inferido a partir de fontes públicas e da sua própria conta.
• Planejar uma arquitetura com banco de dados, autenticação, pagamentos, integrações e regras de acesso.
• Transformar referências visuais em tokens de design e componentes acessíveis, sem reutilizar os ativos do produto estudado.
• Construir o produto por fluxos prioritários, registrar o que foi concluído e medir paridade de funcionalidades.
• Pesquisar reclamações reais de usuários para encontrar uma proposta melhor que a do aplicativo de referência.
• Preparar marca, landing page, listagem de lojas e checklist de deploy.

⚠️ O que ele não faz

• Não copia código-fonte, HTML, CSS, JavaScript, SVGs, logos, textos, imagens, fontes licenciadas nem conteúdo do aplicativo original.
• Não deve burlar login, paywall, termos de uso ou acessar conta de terceiros.
• Não garante que qualquer aplicação possa ser reproduzida com fidelidade ou no mesmo prazo: redes de usuários, catálogos licenciados, acordos comerciais e licenças reguladas continuam fora de escopo.
• Não elimina a necessidade de revisão humana, testes, consulta jurídica para marca e cumprimento de obrigações de privacidade.

Requisitos antes de começar

As 11 skills e a ordem correta

O repositório recomenda executar as etapas na ordem abaixo. Você pode usar uma skill isoladamente, mas pular diretamente para a construção tende a gerar decisões baseadas em suposições.

1. /replica-recon: cria o mapa de telas, jornadas, componentes, modelo de dados inferido e matriz de funcionalidades.
2. /replica-architect: define stack, esquema de banco, API, regras de acesso e ordem de implementação.
3. /replica-design: transforma referências em tokens, especificações de componentes e verificações de contraste.
4. /replica-build: implementa a aplicação tela por tela, começando pelo fluxo principal.
5. /replica-backend: adiciona autenticação, banco, pagamentos, e-mails, jobs e integrações oficiais.
6. /replica-test: cria plano de testes, testes end-to-end e relatórios de bugs.
7. /replica-diff: mede paridade de funcionalidades e compara a estrutura visual de capturas.
8. /replica-entrepreneur: organiza avaliações públicas para descobrir dores e oportunidades de posicionamento.
9. /replica-brand: cria uma identidade própria e verifica se ainda restaram referências à marca original.
10. /replica-launch: prepara landing page, estratégia de preço e listagens de App Store e Google Play.
11. /replica-deploy: executa a pré-checagem e prepara infraestrutura, domínio, monitoramento e publicação.

Passo 1: instale o pacote no Claude Code

Há três formas de começar. A primeira é usar o repositório como plugin do Claude Code, que mantém as skills com namespace próprio:

/plugin marketplace add Jakeschincariol/replica-skill
/plugin install replica-skill@replica-skill

Depois da instalação, as skills aparecem com nomes como /replica-skill:replica-recon. Esse é o caminho mais organizado para quem já trabalha no Claude Code.

Se preferir nomes sem namespace, clone o repositório e copie as pastas de skill para o diretório global do Claude:

git clone https://github.com/Jakeschincariol/replica-skill.git
cp -r replica-skill/replica-* ~/.claude/skills/

Para limitar o método a apenas um projeto, copie as mesmas pastas para .claude/skills/ dentro do repositório da aplicação. Sem Claude Code, ainda é possível abrir qualquer arquivo SKILL.md e colá-lo no começo de uma conversa com Claude. Nesse modo, o método permanece útil, mas os scripts auxiliares não são executados automaticamente pelo chat.

Passo 2: escolha um escopo pequeno e verificável

Não comece com “quero recriar o Notion” ou “quero fazer uma versão do Spotify”. A primeira tarefa do /replica-recon é reduzir a ambição a um loop central. Para uma ferramenta de agenda, por exemplo, um escopo inicial plausível seria: criar tipo de evento, compartilhar link, permitir que uma pessoa reserve horário e exibir a reserva no painel.

O comando pode ser iniciado assim:

/replica-recon
Quero estudar o fluxo de agendamento de uma ferramenta pública para criar uma agenda voltada a consultórios pequenos. O escopo inicial é criar disponibilidade, gerar um link e confirmar uma reserva.

O motivo de formular a intenção antes da pesquisa é evitar o erro clássico de copiar uma lista enorme de recursos sem resolver o problema principal de um público específico.

Passo 3: produza o mapa de pesquisa sem ultrapassar limites

O replica-recon deve trabalhar com páginas públicas, central de ajuda, página de preços, changelog, listagem de loja, vídeos de demonstração, documentação de API pública e a sua própria conta. A skill proíbe leitura de bundles JavaScript, captura de chamadas internas de rede, automação em massa, bypass de login e uso de conta de outra pessoa.

Como saída, ela deve criar:

replica/recon.md
replica/features.csv
replica/screens/

O arquivo recon.md registra telas, estados, fluxos e hipóteses. Já o features.csv organiza cada recurso por prioridade: must, should ou could. Recursos que não podem ser legitimamente reproduzidos — como catálogo musical licenciado, base de usuários ou parceria comercial — entram como skip, acompanhados de uma justificativa.

Passo 4: transforme observações em arquitetura

Com o mapa pronto, execute /replica-architect. A skill propõe, por padrão, uma pilha pragmática: Next.js com TypeScript, Postgres em Supabase ou Neon, autenticação por Supabase Auth ou Auth.js, Stripe Checkout, Resend ou Postmark para e-mails e Vercel para hospedagem. São sugestões, não exigências; a recomendação é aproveitar a tecnologia que o time já domina quando isso fizer sentido.

O ponto mais valioso dessa etapa é converter suposições em regras explícitas. Banco de dados precisa de chaves estrangeiras, índices, dados de horário em UTC, valores monetários em centavos e controles de acesso. Se dois usuários não podem reservar o mesmo horário, isso deve ser protegido no banco ou em uma restrição adequada — não apenas por uma mensagem na interface.

Passo 5: recrie padrões de design, não a identidade visual

O /replica-design extrai papéis de cor, escala tipográfica, espaçamentos, raios, sombras, comportamento de componentes e requisitos de acessibilidade. A orientação é transformar esses elementos em tokens. Um botão, por exemplo, deve ser definido por variantes, tamanhos, estados de foco, carregamento, desabilitado e semântica HTML.

O projeto inclui um verificador de contraste WCAG:

python3 replica-design/contrast.py replica/design/tokens.json

O script verifica pares de texto e fundo. O material recomenda pelo menos 4,5:1 para texto comum e 3:1 para texto grande, bordas de campos e anéis de foco. O que não deve ser reutilizado são logos, ilustrações, fotos, fontes proprietárias, textos e a cor de assinatura da marca original.

Passo 6: construa primeiro o fluxo vertical

O /replica-build pede que a equipe comece pelo caminho central de ponta a ponta, mesmo que ele ainda esteja visualmente simples. Para uma agenda, isso seria: criar conta, configurar disponibilidade, abrir página pública, reservar horário e ver a reserva no painel. Essa sequência valida a escolha técnica mais cedo do que uma coleção de telas bonitas e desconectadas.

Para cada tela, a definição de pronto inclui estados de carregamento, vazio, erro, permissão negada e conteúdo longo; compatibilidade em larguras como 390px e 1440px; navegação por teclado; foco visível; textos alternativos e ausência de erros no console. A matriz de recursos é atualizada a cada avanço.

Passo 7: conecte serviços sem reutilizar credenciais alheias

O /replica-backend cobre login, migrações, regras de acesso, pagamentos, e-mail e integrações. A regra decisiva é usar apenas APIs públicas e chaves que pertencem ao novo produto. A pessoa responsável cria as contas e preenche variáveis em .env.local; a IA pode escrever um arquivo .env.example, mas não deve receber senha, cartão, chave de produção ou credencial de terceiros.

Para pagamentos, a recomendação é usar Stripe Checkout e o Customer Portal, validar assinatura de webhooks, registrar o ID de cada evento e tornar os handlers idempotentes. Para OAuth, a skill alerta que alguns escopos, como os do Google Calendar, podem exigir verificação do provedor antes de uma abertura pública.

Passo 8: teste o clone, nunca o produto de referência

O /replica-test deriva casos de teste dos fluxos registrados no recon. Para automatizar, o README indica Playwright:

npm i -D @playwright/test
npx playwright install chromium
npx playwright test

Use seletores acessíveis, como getByRole, em vez de classes CSS. A recomendação é falhar o teste em erros de console, respostas 5xx e problemas de acessibilidade detectados por @axe-core/playwright. Pagamentos reais, OAuth e e-mails exigem também uma checagem manual controlada.

Passo 9: meça a paridade sem perseguir cópia pixel a pixel

O pacote traz duas ferramentas complementares. A primeira calcula paridade de funcionalidades:

python3 replica-diff/parity.py replica/features.csv

Ela dá peso 3 para itens must, 2 para should e 1 para could; itens parciais contam pela metade. Itens excluídos justificadamente e recursos novos não entram na nota. O projeto considera não publicável qualquer versão com funcionalidade obrigatória faltando.

A segunda compara o layout estrutural de capturas de tela no mesmo viewport:

python3 replica-diff/imgdiff.py original.png clone.png --out diff.png

O modo padrão usa mapas de borda, para que uma troca de paleta não prejudique o resultado. A meta é verificar hierarquia e posicionamento, não copiar a aparência exata que pode caracterizar a identidade visual do concorrente.

Passo 10: encontre uma razão real para o novo produto existir

A skill /replica-entrepreneur pesquisa avaliações públicas em fontes como App Store, Google Play, G2, Capterra, Trustpilot, Reddit, Hacker News e quadros públicos de pedidos. Cada linha em replica/reviews.csv precisa conter fonte, URL, data, nota e texto. O script descarta avaliações sem link, prioriza evidência recente e marca como fraco qualquer tema com menos de três comentários ou apenas uma fonte.

Esse cuidado é essencial: uma alternativa vendável não deve nascer de reclamações inventadas ou de três comentários isolados. A saída é um plano de correções e uma frase de posicionamento fundamentada no que usuários realmente relatam.

Passo 11: rebrand, lançamento e deploy

Antes do lançamento, /replica-brand cria nome, paleta, briefing de logo e voz. Em seguida, o script sweep.py procura nomes, domínios e cores do produto original que tenham sobrado no código:

python3 replica-brand/sweep.py . --avoid "Nome Original" --domains original.com --colors "#006bff"

O /replica-launch cria landing page, pricing e listagem para lojas. Ele proíbe colocar o nome do concorrente em título, palavras-chave, anúncios ou descrição. Por fim, /replica-deploy só libera o deploy depois de testes, paridade, verificação de marca, build de produção, páginas legais e autorização explícita do responsável.

Ferramentas incluídas e o que elas verificam

Erros comuns e como resolver

• ❌ Começar pelo código sem um recon map. Causa: o time assume como o app funciona. Solução: complete recon.md, fluxos e features.csv antes de arquitetura e interface.
• ❌ Confundir paridade com cópia visual. Causa: tentar imitar logo, copy e cores. Solução: mantenha padrões de usabilidade, mas use ativos, textos e marca próprios.
• ❌ Usar screenshots em tamanhos diferentes no imgdiff.py. Causa: a comparação encontra diferenças que são apenas de viewport ou estado. Solução: capture ambas no mesmo tamanho e com dados equivalentes.
• ❌ Tratar tarefas de UI como segurança de backend. Causa: apenas esconder opções no front-end. Solução: implemente regras de acesso no banco ou em toda consulta do servidor.
• ❌ Lançar com restos da marca original. Causa: nomes em variáveis, favicon, metadados ou e-mails passam despercebidos. Solução: execute o sweep.py e revise manualmente ativos e templates.
• ❌ Tirar conclusão de poucas avaliações negativas. Causa: generalizar comentários isolados. Solução: marque temas com pouca amostra como fracos e procure evidência em fontes independentes.

Perguntas frequentes

O Replica Skill cria uma cópia pronta de qualquer aplicativo?

Não. Ele estrutura o trabalho de reconstruir funcionalidades e fluxos com uma implementação nova. O esforço depende do escopo, das integrações, da complexidade técnica e da qualidade da pesquisa.

Posso usar o projeto sem Claude Code?

Sim. O README informa que um SKILL.md pode ser colado no início de uma conversa com Claude. Porém, a experiência perde a integração direta com os scripts e com a organização automática das skills.

O projeto exige chave de API ou assinatura adicional?

O repositório informa que o pacote é gratuito, MIT e não requer cadastro ou chave própria para seus scripts. O uso do Claude Code, modelos de IA, hospedagem, Stripe ou outros provedores pode ter seus próprios planos, limites e custos.

Posso analisar um produto que só conheço por screenshots?

É possível começar com páginas públicas, demonstrações e listagens, mas o resultado terá mais hipóteses. O método pede que inferências sejam marcadas como tal e que a pesquisa não ultrapasse conteúdo público ou sua própria conta.

É permitido usar o nome do concorrente para divulgar a nova aplicação?

O próprio projeto recomenda não colocar o nome original no aplicativo, anúncios, palavras-chave ou listagem de loja. Comparações comerciais e análise de marca devem ser avaliadas com orientação jurídica adequada.

Conclusão: a ferramenta organiza disciplina, não substitui julgamento

O replica-skill é útil porque trata a criação de uma alternativa como um processo de produto inteiro. Ele começa pela descoberta, formaliza decisões de arquitetura, exige segurança e testes, mede o que falta e força a equipe a criar uma razão de mercado para existir além da semelhança com um concorrente.

Em 2027, a barreira para gerar interfaces e código deve continuar caindo. A diferença entre um protótipo descartável e um produto sustentável será cada vez mais a capacidade de validar fluxos, proteger dados, corrigir dores reais e construir uma identidade própria. O método do Replica é mais valioso exatamente nessa parte: usar IA para acelerar a execução, sem terceirizar responsabilidade, criatividade ou conformidade.