RepoIntermediate

Watch: o usuário robótico que testa seu app e te avisa antes dos seus clientes

Existe um ponto cego entre "meu código está bom" e "meu app funciona para um usuário de verdade". Nessa lacuna moram mil coisas que seus testes não veem: um CDN caído, uma variável mal configurada em produção, um botão que mudou de texto e quebrou o login, uma tela que de repente demora 8 segundos. Você descobre quando um cliente reclama… ou quando ele vai embora sem dizer nada. O Watch fecha essa lacuna: é um usuário robótico que percorre seus fluxos críticos num navegador real, como uma pessoa, e te avisa no segundo em que algo quebra ou fica lento — e não só o alarme: ele te traz o passo exato que falhou, o screenshot e o conserto. É grátis, mora no GitHub, e aqui eu te explico quando usar e como montar.

Jun 25, 202612 min

Para quem é isto?

Para qualquer pessoa que tenha um app ou site no ar e queira dormir tranquila — mesmo que você não saiba programar. Se você já descobriu que seu próprio site estava fora do ar porque um cliente te escreveu, isto é para você. O Watch é um vigia robótico que testa seu app de tempos em tempos, como um usuário faria, e te avisa primeiro. Você configura uma vez em linguagem natural; o resto ele faz sozinho.

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ê.

Pense assim

Seus testes são como conferir a planta de um prédio: confirmam que o projeto está correto. O Watch é o inspetor que de fato entra, sobe pelo elevador, abre as portas e acende as luzes. A planta pode estar perfeita e o elevador estar quebrado. O Watch encontra o elevador quebrado — porque ele usa.

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 que acontece sem um vigia

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.

O custo escondido

Um usuário que esbarra no seu app quebrado raramente te avisa. Ele vai embora. Para cada cliente que reclama, há dezenas que simplesmente fecham a aba e não voltam. O dano de um fluxo quebrado não se mede em tickets de suporte — se mede nas pessoas que você perdeu e nunca soube por quê.

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):

Os fluxos críticos do hábito

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.

O diferencial do Watch

Como o Sentinel, o Watch não para em "o fluxo falhou, boa sorte". Ele te diz qual passo falhou, te dá o screenshot do momento exato e propõe o conserto. Exemplo real: "o passo 4 (clicar em Iniciar sessão) falhou porque o botão agora se chama Entrar → troque o texto esperado, uma linha". Não só o alarme: a causa e a cura.

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.

O motor: agent-browser, não mágica

O Watch se apoia no agent-browser, uma ferramenta real que dá à IA um navegador de verdade para navegar como uma pessoa (não é Playwright, não é um serviço pago externo). Se você já viu o recurso do agent-browser, isto é aquele poder aplicado a vigiar seu app 24/7.

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:

bash

/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.

O mais fácil: peça em bom português

Depois de instalar, você diz para a sua IA: "rode o Watch no meu app e me diga se algo quebrou" ou "meu login e meu checkout continuam funcionando?". E para a vigilância recorrente, você agenda com uma rotina (/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:

Vigiar a saúde do meu app com o Watchtext

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ê

O que o agente faz sozinho

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.

O que você faz (uma vez)

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.

Honestidade: read-only e não destrutivo

O Watch navega e observa: não apaga dados, não faz compras reais, não envia formulários irreversíveis — a menos que você marque explicitamente um fluxo como seguro e em sandbox. E como a análise é feita pelo seu agente de IA, o conteúdo é processado onde esse agente roda. O Watch não envia suas capturas nem dados para nenhum serviço de monitoramento de terceiros.

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:

MentexDev/neuralos-watch

REPO

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.

MarkdownMITView on GitHub

No NeuralOS…

O Watch é o segundo dos guardiões: pequenos aliados de IA que vigiam o seu produto e propõem o conserto, nunca mexem em nada sozinhos. O Sentinel cuida do código por dentro; o Watch cuida para que o app funcione por fora, para um usuário real. A visão: que o seu produto se vigie a si mesmo e te avise primeiro.