🪜 A escada das vias

Uma via é o caminho por onde o agente chega num sistema: pedir dados, ler um arquivo, clicar numa tela. O runtime/LEIA-ME.md organiza as vias numa escada de sete níveis.

Você começa pelo nível 1 e vai descendo até achar a primeira via que existe e funciona. A frase do kit: use a mais alta que existir.

Como ler o desenho: o número é a ordem em que você testa. A cor é a estabilidade: verde é alta, azul é média, vermelho é baixa. Repare que o 6 é azul e o 5 é vermelho: estar mais embaixo não quer dizer ser pior. O tópico 2 explica.

O que olhar na tabela: é a tabela do runtime/LEIA-ME.md, sem mudar uma palavra. A coluna "Exemplo" mostra o tipo de coisa que mora em cada degrau; você não precisa rodar esses exemplos agora.

Estabilidade é o quanto a via continua funcionando quando o outro lado muda. Uma API tem contrato: o fabricante avisa antes de mexer. Uma tela de site muda de lugar um botão e o robô que clicava ali se perde.

O README do kit fecha a ideia: o agente usa sempre a mais estável que existir. Por isso a ponte local (6, média) ganha do uso do computador (5, baixa) quando as duas existem. A receita R5 diz o mesmo: navegador só quando não existir API, MCP, CLI ou exportação.

Agente diz "não dá" cedo demais. Ele não achou documentação e conclui que não existe. O kit tem uma regra contra isso, escrita no LEIA-ME.md e repetida no AGENTS.md.

A regra: antes de concluir que é impossível, o agente testa cada nível com um comando. "Não achei" não vale. Vale "rodei isto e veio isto".

Regra: se o agente disser "não dá", peça para ele **testar** cada nível com um comando antes de concluir. Muitas vezes a via existe e só não estava documentada.

Como ler o desenho: o laço vermelho volta para a esquerda com o degrau seguinte. Cada volta deixa uma evidência anotada. Um "não dá" honesto chega com essa lista; um "não dá" sem lista é palpite.

A Sônia quer o total de vendas por cliente da distribuidora. O ERP é antigo: não tem API. O que ele sabe fazer é exportar um CSV de vendas, o runtime/exemplos/erp-vendas.csv do kit.

Veja a escada degrau por degrau. É o caso mais comum em escritório pequeno: sistema antigo que só exporta arquivo.

O que olhar na tabela: no degrau 5 a resposta é "existe", e mesmo assim a escada segue. É a regra do tópico 2: a R5 só aceita navegador quando não há exportação, e aqui há.

Como ler o desenho: a linha de cima é o caminho escolhido: o ERP solta o arquivo e a ponte entrega uma ferramenta pronta. A caixa vermelha riscada embaixo é o caminho descartado. Na trilha 2 (receita R3) essa ponte vira uma ferramenta MCP de verdade.

A agenda da clínica da Clara é uma planilha. Uma planilha não tem API, MCP, CLI nem SDK: ela é um arquivo. Então a escada desce até a ponte local, igual à da Sônia. No kit, ela é o runtime/exemplos/agenda.csv, com os horários da Dra. Ana e do Dr. Bruno.

A diferença aparece depois. A Sônia só quer ler. A Clara, um dia, vai querer que o agente marque um horário. E a mesma via pode ter políticas diferentes para ler e para alterar.

| Agenda da clínica (planilha) | Ponte local (arquivo)   | 6 | ler/escrever agenda.csv         | alterar (N2)    | pendente |

Agora é a sua vez. Escolha um sistema do seu trabalho: o programa da loja, o portal do fornecedor, a planilha do estoque. Peça ao agente para subir a escada com você, testando cada nível.

O prompt abaixo usa só arquivos do kit. Ele pede o teste por nível e proíbe mexer no sistema: nesta etapa, o agente só descobre.

Leia runtime/LEIA-ME.md. Quero conectar o <nome do sistema>, que eu uso para <o que você faz nele>.
Suba a escada das vias comigo, um nível por vez. Em cada nível, me diga como testar com um comando, mostre o resultado e só então passe ao próximo.
Não conclua "não dá" sem testar todos. Não altere nada no sistema.
No fim, me diga qual é a via mais estável que existe e por quê.