O GUIA DE CAMPO DO CLIPY

Grave a ideia uma vez. Use-a do começo ao fim.

O fluxo completo para transformar uma gravação de tela em uma passagem clara, contexto para agentes, uma correção publicada e a prova de que o resultado funciona.

RESPOSTA RÁPIDA

Use o Clipy para gravar exatamente o que você quer explicar, deixe os momentos importantes evidentes com o Flare e a narração e compartilhe o mesmo link com uma pessoa ou com um agente de IA. O Clipy também transforma vídeos do YouTube em contexto para agentes e grava a verificação feita por um agente como prova.

COMECE AQUI

Qual gravador você deve usar?

Todos terminam no mesmo tipo de link de compartilhamento. Escolha a ferramenta de captura que combina com o que você precisa mostrar.

Extensão do Chrome

Ideal para capturar abas rapidamente e, se quiser, diagnósticos de bug com dados sensíveis ocultados.

Adicionar ao Chrome

GUIAS EM VÍDEO

Como eu faço…? Veja um guia de um minuto.

Guias curtos e narrados, gravados no próprio Clipy. Cada um abre a página que explica a tarefa por completo, com o vídeo no topo.

01 · APP PARA MAC

Como apontar sem cobrir a tela?

Ative o Flare e o seu cursor vira um holofote temporário. Ele troca o “olha aqui” por um rastro visível que fica na gravação e nas evidências de ponteiro do Clipy.

  1. 1Comece uma gravação no app nativo do Clipy para Mac.
  2. 2Ative o Flare nos controles de gravação.
  3. 3Segure Control e mova o cursor em volta do elemento que você quer indicar. Solte quando terminar o destaque.
  4. 4Narre o que importa enquanto aponta: o problema, o estado esperado ou a diferença exata medida.

Melhor hábito: circule uma vez, pare sobre o alvo e diga uma instrução completa. Rabiscos rápidos parecem enérgicos, mas dão a quem assiste e ao agente menos evidência útil.

Flare do Clipy destacando uma parte da tela gravada com um rastro laranja do cursor que vai sumindo
How to point at what you mean: Flare, hover, clicks and the pen Watch on Clipy
Um agente de IA envolve um comando de teste com o Clipy e devolve uma gravação de prova e um documento AREC

02 · GRAVAÇÃO PELO AGENTE

Como o seu agente pode mostrar que o trabalho dele realmente funciona?

Peça ao agente para gravar a verificação, e não só dizer “os testes passaram”. O Clipy envolve a execução, captura a tela e entrega um vídeo normal mais evidências estruturadas que outro agente consegue ler.

clipy session run --url http://localhost:3000 --type bug -- npx playwright test
  1. 1Configure o Clipy para o agente atual uma vez. A instalação e a gravação sempre exigem a sua autorização explícita.
  2. 2Diga qual comportamento visível ao usuário ele deve exercitar e o que conta como sucesso.
  3. 3Peça que ele adicione marcas de evidência nos momentos importantes de antes, da ação e de depois.
  4. 4Peça os dois resultados: a URL para pessoas assistirem e a URL de contexto canônica .arec.

Um comando envolvido que falha é descartado; um que dá certo é enviado. O Clipy grava as evidências, mas as marcas ainda descrevem o que o agente observou, em vez de provar a afirmação de forma independente.

03 · CONTEXTO DE VÍDEO

Como passar um vídeo do YouTube para um agente?

Não peça ao agente que adivinhe pelo título nem que processe o vídeo inteiro. O Clipy transforma a URL em um pacote AREC com trechos da transcrição com marcação de tempo, notas sobre lacunas visuais e quadros selecionados, quando disponíveis.

clipy context import "https://youtu.be/..." --sync --json
  1. 1Cole a URL do YouTube e diga o que você quer que o agente aprenda ou implemente a partir dela.
  2. 2Deixe a skill do Clipy fazer a importação. As legendas vêm primeiro; os quadros são selecionados nos momentos em que a evidência visual importa.
  3. 3O agente lê primeiro os metadados e as lacunas visuais, busca a sua pergunta e só então abre os trechos relevantes da transcrição e os quadros próximos.
  4. 4Execute a mesma importação de novo se um resultado parcial tiver o contexto da transcrição, mas os quadros ainda estiverem pendentes; as importações são idempotentes.
Abrir o guia completo de contexto do YouTube
Clipy importando uma URL do YouTube para uma transcrição com marcação de tempo e quadros selecionados legíveis por agentes
Uma gravação de bug no Clipy virando evidência AREC e depois uma correção feita por um agente de IA de programação

04 · DO BUG À CORREÇÃO

Como gravar um bug para que um agente consiga corrigi-lo?

Grave uma reprodução limpa e diga o resultado que você esperava. O link normal do vídeo basta: com a skill do Clipy instalada, o agente puxa os pedidos, o plano, os momentos-chave, as evidências de ponteiro, as lacunas de captura e a transcrição.

  1. 1Comece de um estado conhecido e diga o navegador, o perfil de conta, os dados de teste e a rota que importam.
  2. 2Narre cada ação uma vez. Quando a falha aparecer, pare e diga o que aconteceu versus o que era esperado.
  3. 3Na extensão do Chrome, ative Capture bug context para anexar erros de console, rejeições não tratadas, requisições com falha, erros de GraphQL e a atividade de WebSocket. Ele vem desativado.
  4. 4Cole o link do Clipy no seu agente de programação: “Reproduza isto, corrija a causa raiz, rode as verificações relevantes e envie a prova da correção pelo Clipy.”

Limite de privacidade: as evidências são ocultadas no seu navegador antes do upload, os cookies nunca são lidos, e cabeçalhos e corpos só são mantidos com o Full network detail ativado. As mensagens de console são texto livre escrito pela página, então evite gravar telas sensíveis e revise antes de compartilhar.

05 · ITERAÇÃO DE DESIGN

Como transformar feedback de design em uma correção na mesma sessão?

Percorra a interface construída comparando com o mock. Use o Flare para deixar “este elemento” inequívoco e fale em diferenças que um agente consegue editar: valor atual, valor desejado, token e estado.

DIGA ISTO

“Este CTA tem 20 pixels de padding horizontal. O mock usa 32 pixels, o nosso token --space-8.”

NÃO ISTO

“O botão parece um pouco apertado.”

  1. 1Deixe o mock aberto como referência, mas grave o build real que o desenvolvedor vai alterar.
  2. 2Capture layout, tipografia, cor, raio e estados de interação como observações separadas e medidas.
  3. 3Entregue o link da gravação ao agente do desenvolvedor e peça que ele associe cada diferença ao componente e ao token responsáveis.
  4. 4Peça ao agente que reconstrua, grave os estados corrigidos e devolva o link de prova para a conferência visual final do designer.
Um designer aponta uma divergência na interface com o Flare do Clipy, e um agente aplica e verifica a mudança de CSS medida

O CICLO COMPLETO

Como é usar o Clipy ao máximo?

  1. 01

    Grave

    Mostre a tela real.

  2. 02

    Esclareça

    Aponte e narre a intenção.

  3. 03

    Entregue

    Cole um link normal.

  4. 04

    Comprove

    Grave o resultado funcionando.

REFERÊNCIA RÁPIDA

O que você precisa saber antes de começar?

Qual gravador do Clipy devo usar?
Use o app nativo para Mac quando quiser Flare, áudio do sistema ou a janela de um app real. Use a extensão do Chrome para capturar rapidamente uma aba, uma janela ou a tela, com diagnósticos de bug opcionais e com dados sensíveis ocultados. Use o gravador web quando quiser começar na hora, sem instalar nada.
Como um agente de IA lê uma gravação do Clipy?
Instale a skill do Clipy uma vez e cole o link normal do vídeo no Claude Code, Codex, Cursor, Windsurf ou OpenCode. A skill busca o documento AREC canônico da gravação, que traz os pedidos, os momentos-chave, as evidências visuais, as lacunas de captura e a transcrição.
O Clipy consegue dar a um agente contexto do YouTube?
Sim. A Clipy CLI importa uma URL do YouTube para um pacote AREC com transcrição com marcação de tempo e quadros selecionados, quando disponíveis. Com --sync, o texto derivado e os quadros selecionados entram na sua biblioteca de contexto privada do Clipy; o vídeo original não é enviado por esse fluxo.
Um agente de IA consegue gravar o próprio trabalho com o Clipy?
Sim. A Clipy CLI pode envolver um comando de verificação em navegador headless, gravar a execução, adicionar marcas de evidência e devolver uma URL para assistir mais uma URL de contexto AREC. Para janelas nativas, ela pode gravar uma tela ou janela do Mac escolhida especificamente, depois que o usuário autoriza a gravação.
O que devo dizer em uma gravação de feedback de design?
Diga o valor atual, o valor pretendido e o token relevante enquanto aponta para o elemento exato. Por exemplo: ‘Este botão tem 20 pixels de padding horizontal; o mock usa 32 pixels, o nosso token space-8.’ Isso dá ao agente de programação uma diferença concreta em vez de um adjetivo.
O Clipy captura segredos nos diagnósticos do navegador?
A captura de bugs oculta os dados no seu navegador antes do upload. Tokens, chaves, e-mails e números de cartão são removidos onde quer que apareçam, inclusive no texto do console, e os cookies nunca são lidos. Cabeçalhos e corpos de requisições e respostas e valores de query só são mantidos se você também ativar o Full network detail, e mesmo assim campos com nomes de senhas, tokens ou dados pessoais são substituídos por [redacted].

Faça da sua próxima gravação algo a partir do qual o trabalho possa seguir.

Grave o contexto, aponte o que importa e deixe o mesmo link levar a tarefa da explicação à implementação e à prova.