🗺️ O mapa de capacidades

No módulo 1.3 você descobriu a via de cada sistema. O mapa de capacidades é onde essa descoberta fica escrita, num formato que o agente lê antes de agir. O AGENTS.md manda: só use sistemas listados ali, pela via indicada.

Cada linha tem seis colunas. Cada coluna responde uma pergunta que você faria antes de deixar alguém usar o seu sistema.

Como ler o desenho: leia da esquerda para a direita como uma frase: "o sistema X, pela via Y, no degrau N, é chamado assim, com esta política, e foi testado nesta data". A caixa verde é a que mais pesa: sem ela, a linha não vale.

O que olhar na tabela: só a primeira coluna depende só de você. As outras saem da escada, da política e de um teste rodado.

O arquivo não chega vazio. Ele traz duas linhas já testadas: os próprios agentes. Um pode chamar o outro, e o mapa precisa dizer como.

Use estas duas como modelo de linha boa: via clara, nível da escada, comando exato, política e data.

| Sistema | Via | Nível | Como o agente chama | Política | Testado em |
|---|---|---|---|---|---|
| Codex CLI | CLI | 3 | `runtime/pontes/codex-exec.sh` | ler (N4) | 2026-10-05 ok |
| Claude Code | CLI | 3 | `claude -p --permission-mode plan` | ler (N4) | 2026-10-05 ok |

Na linha do Codex, o Claude pede uma segunda opinião pela ponte; alterar arquivos pelo Codex é outra política, que você liga só quando pedir (receita R1). Na linha do Claude, ele é chamado sem abrir a tela, em modo de planejamento: lê e responde, sem mexer em nada.

Abaixo da tabela, o arquivo traz uma seção "Exemplos para copiar": quatro linhas para casos comuns. Repare na última coluna de todas: pendente.

Pendente quer dizer que a linha descreve o plano, mas ninguém testou ainda na sua máquina. Começar de um exemplo parecido com o seu caso economiza metade do trabalho.

| Planilha de estoque (.xlsx)  | Ponte local (arquivo)   | 6 | ler ~/estoque/estoque.xlsx      | ler (N4)        | pendente |
| ERP sem API                  | Exportação CSV diária   | 6 | ler ~/erp/export/*.csv          | ler (N4)        | pendente |
| Agenda da clínica (planilha) | Ponte local (arquivo)   | 6 | ler/escrever agenda.csv         | alterar (N2)    | pendente |
| Site do fornecedor           | Uso do computador       | 5 | navegador automatizado          | enviar (N2)     | pendente |

O que olhar na tabela: três exemplos param no degrau 6 e um no 5. O do site fica no 5 porque site de fornecedor costuma não ter exportação, e a política dele é "enviar" (N2), porque preencher formulário manda dados para fora.

O agente conhece a escada; você conhece o seu trabalho. Juntos, o mapa sai em minutos. O README traz o pedido pronto, o mesmo que você usou no módulo 1.2.

O LEIA-ME.md dá a dica de como conduzir: peça ao agente para preencher "comigo, nível por nível". É uma entrevista guiada, com você aprovando cada linha.

Leia runtime/LEIA-ME.md e me ajude a preencher o CAPACIDADES.md para o meu trabalho.

Preencha comigo, nível por nível: um sistema por vez, uma pergunta por vez. Use os exemplos do CAPACIDADES.md como modelo e marque "pendente" em toda linha que ainda não testamos.

O arquivo abre e fecha com a mesma regra. No topo: "só entra linha com teste feito". No fim: "sistema sem linha aqui não é usado pelo agente".

Funciona como uma lista branca: o que não está na lista fica de fora. Isso impede o agente de inventar acesso a um sistema que ninguém conferiu.

Como ler o desenho: são duas portas em sequência. Só chega na caixa verde quem passa pelas duas. As caixas vermelhas não são erro: são o agente obedecendo a regra e devolvendo a decisão para você.

Antes de marcar um sistema como "sem via", observe o que o programa já oferece. Muita exportação mora num menu que ninguém abre. Muita integração está numa página de configurações esquecida.

Olhar é o lado bom da engenharia reversa: você descobre a via observando, sem ligar fio improvisado nenhum. E se depois de olhar não houver via, isso também vira registro.

| data | o que tentei | o que barrou | contorno | status |
|---|---|---|---|---|