Communitygithub.com

replay-to-replica

Transforme a observação autorizada de um aplicativo, site, fluxo de trabalho ou demonstração de usuário existentes em uma especificação comportamental com evidências, um handoff de implementação independente, cenários de aceitação executáveis e um relatório de paridade. Use ao reproduzir o comportamento de um produto sem copiar código-fonte, marca ou ativos protegidos; não use para contornar controles de acesso, extrair segredos ou criar um clone quase idêntico não licenciado.

O que é replay-to-replica?

Esta skill permite que um agente de IA transforme a observação autorizada de um produto existente (site, aplicativo, fluxo) em uma especificação comportamental independente e um pacote de implementação limpa. O objetivo principal é garantir que o comportamento funcional seja reproduzido em um novo produto sem copiar código-fonte, ativos protegidos ou propriedade intelectual, otimizando para clareza comportamental e não para imitação visual ou de código. A skill é compatível com ferramentas como Claude Code, Cursor e Codex, e estrutura o processo em seis fases: definição de escopo e autorização, observação como usuário, normalização em um contrato de comportamento, produção de um handoff de implementação limpa, implementação independente e reprodução/comparação dos resultados. Ela enfatiza a importância de documentar evidências (como gravações, árvores de acessibilidade ou logs), classificar observações como observadas, derivadas ou inferidas, e gerar artefatos como relatórios de paridade e cenários de aceitação executáveis para verificar a conformidade. A skill não substitui a conformidade legal; cabe ao usuário garantir que a observação e a implementação respeitem licenças, termos e contratos, incluindo a divisão de papéis quando for necessária separação estrita (clean-room).

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wangjunyu86/replay-to-replica/tree/HEAD

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Replay para Réplica (Replay to Replica)

Traduza o comportamento observado de um produto em um contrato implementável e independentemente expresso, depois verifique a nova implementação reproduzindo as mesmas tarefas do usuário. Otimize para clareza comportamental, não para imitação visual ou de código.

Limite

Esta skill suporta observação autorizada em caixa preta e handoff no estilo "clean room". Ela não estabelece por si só conformidade legal. Respeite licenças, termos, patentes, privacidade e restrições contratuais. Não:

  • burle autenticação, pagamento, limites de taxa, criptografia ou controles técnicos;
  • acesse dados ou funcionalidades que o usuário não está autorizado a acessar;
  • copie código-fonte, código decompilado, ativos proprietários, marcas registradas, textos de direitos autorais, identificadores ocultos ou dados confidenciais para o pacote de implementação;
  • reivindique separação estrita de "clean room" quando a mesma pessoa ou agente viu detalhes de implementação protegidos.

Se a separação estrita for importante, divida o trabalho: um papel de observação produz um pacote de comportamento normalizado, e um papel de implementação separado recebe apenas esse pacote.

Escolha o resultado solicitado

Esclareça qual resultado é necessário:

  • Apenas pacote de comportamento — especificações e cenários de aceitação.
  • Handoff de implementação — pacote de comportamento mais tarefas e interfaces prontas para construção.
  • Réplica verificada — implementação independente mais testes de paridade reproduzidos.

Não expanda "analise este produto" para construir um clone a menos que o usuário tenha solicitado a implementação.

Inicialize um pacote de trabalho com:

python3 scripts/init_replica_pack.py <diretório-de-saída> --product "<produto observado>" --replica "<novo produto>"

Fase 1: Definir escopo e autorização

Registre:

  • alvo autorizado e método de acesso;
  • produto independente e usuário pretendido;
  • comportamentos a preservar;
  • comportamentos, marca, dados e ativos a excluir;
  • plataforma suportada e ambiente de teste;
  • se interação em tempo de execução ou ações de conta exigem consentimento renovado;
  • o limite de paridade: contrato exato, funcionalmente equivalente ou intencionalmente alterado.

Crie um escopo baseado em tarefas, em vez de "copiar o aplicativo inteiro". Comece com as jornadas mais valiosas e menores.

Fase 2: Observar como um usuário

Para cada jornada, capture:

  1. estado inicial e pré-requisitos;
  2. ação do usuário;
  3. resposta imediatamente observável;
  4. estado resultante e dados persistidos;
  5. erros, atrasos, limites e caminhos de recuperação;
  6. caminho da evidência e ambiente;
  7. rótulo epistêmico: observado, derivado ou inferido.

Redefina o alvo entre execuções quando o estado puder afetar o comportamento. Repita comportamento variável ou sensível ao tempo o suficiente para identificar faixas, em vez de tratar uma única amostra como regra.

As evidências de observação podem incluir gravações, capturas de tela, árvores de acessibilidade, comportamento de rede público, arquivos exportados, logs visíveis ao usuário e APIs documentadas. Use ferramentas de inspeção disponíveis apenas dentro da autorização. Detalhes internos de implementação são desnecessários para um contrato comportamental.

Leia references/observation-and-spec.md ao escrever o pacote de comportamento.

Fase 3: Normalizar em um contrato de comportamento

Descreva o comportamento de forma independente da interface e redação originais. O contrato deve definir:

  • atores e permissões;
  • entidades, identificadores e relacionamentos;
  • estados e transições válidas;
  • ações, entradas, saídas, efeitos colaterais e invariantes;
  • comportamento de validação e falha;
  • regras de persistência, ordenação, temporização e concorrência onde visível;
  • limites de integração externa;
  • expectativas de acessibilidade e plataforma;
  • diferenças intencionais.

Cada regra não trivial precisa de uma referência de evidência ou um rótulo de inferência explícito. Observações conflitantes permanecem não resolvidas até serem testadas; não escolha silenciosamente a interpretação conveniente.

Fase 4: Produzir um handoff de implementação limpa

O handoff de implementação pode incluir:

behavior-spec.yaml
state-model.md
data-contracts.md
acceptance-scenarios.md
implementation-handoff.md
source-observations.csv

Reescreva nomes, texto, identidade visual e exemplos de domínio para o novo produto. Exclua ativos originais e identificadores internos. Especifique interfaces e resultados, não arquitetura de origem presumida.

Leia references/clean-room-handoff.md antes de entregar o pacote a um agente de implementação.

Fase 5: Implementar de forma independente

Escolha a tecnologia a partir das restrições do novo produto, não de suposições sobre a pilha original. Preserve os contratos de comportamento enquanto permite arquitetura, algoritmos, design visual e estruturas de dados diferentes.

Mantenha um registro de decisões de implementação para diferenças deliberadas. Não altere a especificação de comportamento apenas para fazer uma implementação com falha parecer conforme; atualize a especificação somente quando uma nova observação a refutar ou o usuário aprovar uma alteração no produto.

Fase 6: Reproduzir e comparar

Transforme cenários de aceitação em testes executáveis quando prático. Execute as mesmas ações normalizadas contra o original e a réplica, depois compare os resultados observáveis pelo usuário.

Classifique cada cenário:

  • match — todas as observáveis exigidas concordam dentro da tolerância declarada;
  • acceptable-difference — difere intencionalmente e é aprovado/documentado;
  • mismatch — contradiz o contrato de comportamento;
  • unverified — um lado não pôde ser exercitado ou a evidência é insuficiente.

Para rastreamentos de eventos estruturados, use:

python3 scripts/compare_traces.py original.json replica.json --output parity-report.md

Leia references/parity-testing.md ao projetar normalização, tolerâncias ou portões de liberação.

Portão de conclusão

Não considere a réplica completa a menos que:

  • todo cenário de bloqueio de versão seja match ou um acceptable-difference aprovado;
  • regras inferidas não resolvidas sejam divulgadas;
  • o novo produto não contenha ativos protegidos ou identidade copiados;
  • um usuário possa executar a jornada principal no ambiente pretendido;
  • o relatório de paridade tenha links para evidências inspecionáveis.

Um relatório final deve declarar escopo, limite de autorização, cobertura observada, inferências, diferenças intencionais, incompatibilidades, áreas não verificadas e o artefato de implementação exato testado.

Habilidades Relacionadas