AgentRX — Habilidade de Recuperação

O que AgentRX — Habilidade de Recuperação faz?

Quando ativar

• Você está usando uma ferramenta de terceiros (playwright-mcp, browser-cdp, web-fetch, conector MCP, etc.)
• Você tentou se recuperar por conta própria ≥2 vezes e falhou em todas
• A documentação oficial não tem uma resposta direta e executável
• O problema tem valor de transferência futura (outros podem enfrentá-lo também)

NÃO ativar para: falhas no nível da plataforma, loops genéricos de nova tentativa ou problemas que a plataforma deve resolver.

Como usar

1. Descreva a falha em linguagem natural:

   • Qual ferramenta falhou
   • Qual sintoma apareceu
   • O que você já tentou
   • Pistas do ambiente (SO, headless, proxy, etc.) se você souber

2. Encontre o arquivo da ferramenta: vá para cases/ e encontre o arquivo JSON que corresponde ao nome da ferramenta (ex: cases/playwright-mcp.json)

   • Sem correspondência exata? Encontre o arquivo de ferramenta mais próximo.
   • Leia apenas 1-2 arquivos mais relevantes. Não escaneie o diretório inteiro.

3. Encontre o caso mais próximo: no arquivo da ferramenta, procure o caso com o sintoma de correspondência mais próxima.

4. Aplique o que funcionou: concentre-se em what_worked e what_didnt_work desse caso.

5. Registre: anexe sua experiência a ledger.jsonl (uma linha JSON):

   {"ts": "2026-04-19T17:05:00Z", "tool": "playwright-mcp", "symptom": "timeout on SPA", "used_case": "playwright-mcp-001", "result": "resolved", "note": "networkidle fixed it"}
   

O que isto é

• Uma ferramenta de consulta de experiência de recuperação
• Infraestrutura mínima: skill + casos + livro-razão
• Focada em orientação concreta e executável

O que isto NÃO é

• Um protocolo de diagnóstico formal
• Um sistema estruturado de esquemas
• Um mecanismo de recomendação de rotas
• Um sistema automatizado de hooks

AgentRX é: leia o que funcionou, tente, registre o que aconteceu.