Seu agente desenha o mapa de todo o seu sistema. Cada sessão o carrega novamente.

As três regras de um mapa

• A topologia é desenhada uma única vez, na raiz. Uma placa nunca repete as conexões; ela contém apenas seus próprios detalhes e procedimentos. A duplicação é onde começa o desvio, portanto não há nenhuma por construção.
• Os valores não existem em lugar algum do mapa. Sem portas, limites, preços ou contagens — uma página indica onde o número se encontra, mas nunca qual é seu valor. Um mapa que exibe valores está incorreto já em uma semana.
• Quem quer que altere um fio atualiza o mapa na mesma sessão. A raiz contém uma linha — verificada em <data> em relação a <o quê> — e um leitor confia no mapa apenas até esse ponto.

O que o mapa de raízes contém, em ordem

• O que é o projeto, em duas frases, e a linha verificada.
• O diagrama: caixas e setas; uma seta para cada fio, indicando o que nele é transportado. A direção é mais importante do que qualquer outra coisa na página.
• Os fios, listados: quem inicia, o que é transmitido, o que nunca é transmitido. Esta é a seção que revela as mentiras.
• As lojas: todo lugar onde o estado existe, o que contêm, o que nunca contêm.
• O índice: cada placa por nome, cada procedimento por placa e seção.

O que uma placa contém

• Para cada parte do seu plano: o que é, o que contém, com o quê e em que direção se comunica, o que nunca faz, e o que acontece quando funciona.
• Onde residem os valores — ponteiros, nunca os valores.
• Seus procedimentos: os comandos exatos, o que ler para saber se funcionou, e o que de fato deu errado ao realizá-lo, com a data.

Um mapa de raízes, em forma

my-app-map — verified 2026-09-04 against commit a1b2c3d and the live containers

  browser ──(requests, session cookie)──▶ api ──(SQL)──▶ postgres
                                          │
                                          └──(jobs)──▶ worker ──(files)──▶ object store

Wires: the browser never talks to the worker; the worker never reads a cookie.
Stores: postgres (users, orders — never card numbers) · object store (uploads).
Plates: my-app-map-api · my-app-map-worker · my-app-map-data · my-app-map-ops
Procedures: deploy → my-app-map-ops, deploy · restore → my-app-map-data, restore