1. O momento: quando "passou nos testes" não significa "funciona"
O momento chega no dia em que você descobre uma verdade incômoda: seu código estar "bom" não garante que seu app funcione. Você lançou, os testes passaram no verde, o deploy ficou perfeito. E, mesmo assim, um usuário não consegue fazer login. Como? Porque entre o seu código e o seu usuário existe um mundo de coisas que nenhum teste do seu repo enxerga: o servidor, a rede, uma configuração de produção, uma API externa lenta, uma mudança de última hora.
Esse é o momento do Watch: quando você entende que precisa de alguém testando o app de verdade, de fora, como um usuário real — abrindo o navegador, digitando no login, clicando no botão, verificando que a tela seguinte carrega. Não revisando o código: usando o app. Isso se chama monitoramento sintético, e o Watch faz isso por você.
2. A dor: você descobre pelo cliente, e aí já é tarde
A dor é honesta e silenciosa. Não é dramática — é pior: é invisível até te custar usuários. Os sintomas:
- O login quebra às 3h da manhã e você só descobre às 9h, quando chega o primeiro e-mail de um cliente furioso.
- Uma mudança de copy ("Iniciar sessão" → "Entrar") quebra um fluxo automatizado sem que ninguém perceba.
- Uma tela começa a demorar 8 segundos; os usuários não reclamam, simplesmente vão embora.
- Uma API externa falha e metade do app para de funcionar, mas seu monitoramento só olha "se o servidor responde" (e ele responde… com uma página quebrada).
O problema de fundo: os monitores tradicionais só verificam "o servidor está vivo?". Mas um servidor pode estar vivíssimo servindo uma página quebrada. A única forma de saber se o seu app funciona é alguém usar ele. E se esse alguém é sempre um cliente real descobrindo a falha, você já perdeu.
3. O hábito: vigiar é CONSTANTE, não uma revisão de uma vez só
Aqui está o que muda o seu comportamento: o Watch não é um teste que você roda uma vez antes de lançar. É uma ronda de vigilância que se repete. Você diz para ele vigiar seus fluxos críticos de tempos em tempos (a cada 15-30 minutos, por exemplo) e comparar cada rodada com a anterior. O que ontem funcionava em 2 segundos e hoje demora 8, ele detecta. O que ontem passava e hoje falha, ele detecta.
Os fluxos que SEMPRE vale a pena vigiar (os que, se quebram, você perde dinheiro ou usuários):
- Login — se ninguém entra, seu app está fora do ar para quem já é cliente.
- Cadastro — se ninguém se cadastra, você para de crescer (e de faturar as campanhas que já pagou).
- O fluxo que te dá o pão de cada dia — o que o usuário VEM fazer (criar algo, publicar, comprar).
- Checkout / pagamento — se quebra, você perde receita de forma silenciosa.
4. Como funciona, em 3 peças simples
Não precisa entender de código para captar. O Watch trabalha em três passos:
1) Você descreve seus fluxos uma vez. Num arquivo simples (flows.json) você lista os caminhos críticos: "abra /login, digite o e-mail, digite a senha, clique em Iniciar sessão, verifique que chega ao painel". Sem senhas reais escritas ali — são usadas variáveis seguras.
2) O Watch percorre eles como um usuário. Usa o agent-browser (um navegador real controlado pela IA) para fazer exatamente isso: abre, digita, clica, espera, olha. Mede quanto demora cada passo e captura telas.
3) Compara com a última vez em que estava tudo bem. Um passo que antes funcionava agora falha? Um fluxo que demorava 2s agora demora 8s? Ele só te avisa do que mudou de verdade — nada de spam com o mesmo alarme cem vezes.
5. Como instalar: um comando
O Watch é uma skill para o Claude Code. Instala-se com um comando e precisa do agent-browser como motor do navegador:
/plugin marketplace add MentexDev/neuralos-watch /plugin install neuralos-watch@neuralos-watch # O motor do navegador (uma vez): npm i -g agent-browser && agent-browser install
Outro assistente? Também funciona com npx skills add MentexDev/neuralos-watch. Depois você copia o arquivo de exemplo de fluxos, adapta ao seu app e conversa normalmente com a sua IA.
/schedule) para que ele rode sozinho de tempos em tempos. Honestidade: não é um serviço mágico que roda sozinho para sempre — é o seu agente, executando os seus fluxos, no horário que você decidir.6. O prompt pronto para copiar
Aqui está de ponta a ponta. Cole no seu agente (com o Watch já instalado), preencha os [colchetes] e deixe a Vigia fazer a ronda:
Quero que você use a skill neuralos-watch para revisar a saúde dos meus fluxos críticos, em modo read-only e NÃO destrutivo (não apague dados nem faça compras reais). URL do meu app (aponte para staging/testes, não para produção com dados de clientes): [https://staging.meuapp.com] Fluxos críticos a vigiar: [ex. 1) que a home carregue · 2) login com e-mail+senha → chega ao painel · 3) criar um projeto novo] Credenciais de teste: use as variáveis de ambiente [WATCH_TEST_EMAIL / WATCH_TEST_PASSWORD], nunca senhas escritas aqui. Siga o procedimento do Watch: me ajude a definir o flows.json se eu não tiver, percorra cada fluxo com o agent-browser, meça os tempos e me entregue um relatório. Para cada problema: o passo exato que falhou, o screenshot, o que era esperado vs o que você encontrou, e o fix proposto. Marque também o que ficou lento mesmo que não tenha quebrado. Se for a primeira rodada, estabeleça a baseline (não compare ainda). NÃO execute nenhum passo destrutivo ou de pagamento a menos que esteja marcado como seguro e em sandbox.
7. O caminho fácil: quem faz o quê
- Percorrer seus fluxos num navegador real, passo a passo, como um usuário.
- Medir tempos, capturar telas e detectar requisições de rede que falharam.
- Comparar com a última rodada boa e escrever o relatório com o fix.
- Descrever seus fluxos críticos no arquivo de exemplo (ou pedir para a IA te ajudar a fazer).
- Apontar para um ambiente de testes, não para produção com dados reais de clientes.
- Agendar a rotina (/schedule) se você quiser vigilância automática recorrente.
8. O repositório (grátis, MIT, deixe uma estrela)
O Watch é de código aberto e grátis. Se ele te avisou de uma quebra antes dos seus usuários, deixe uma estrela:
Um usuário robótico que percorre seus fluxos críticos num navegador real com o agent-browser e te avisa quando um deles quebra ou fica lento — com o passo, o screenshot e o fix. Read-only por padrão.