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.

Numa terça-feira, seu agente abre o mapa, vê o cabo que está prestes a tocar e verifica a data na linha verificada antes de alterar qualquer coisa.

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

Quatro seções, e nada mais

• Decidido — uma linha por decisão em vigor: a data, quem decidiu e o porquê. Uma proposta nunca é registrada como decidida.
• Próximo — ordenado, no máximo dez itens. Cada linha nomeia o item e diz como será saber que está concluído. A ordem é o único status que um plano tem.
• Parado — ideias apresentadas e ainda não decididas, cada uma com a data em que foi apresentada.
• Comece pelo humano — as decisões que apenas uma pessoa pode tomar, uma por linha, com data.

A lei que impede que apodreça

• Concluído significa removido. Quem conclui um item o remove na mesma sessão e coloca o que mudou no devido lugar: o fio no atlas, a decisão ou a medição em um registro, o código em um commit. Não existe uma seção “Concluído”.
• O Ledger é percorrido nesse processo. Uma linha capturada que ainda importa vira uma única linha em Next ou Parked e sai do Ledger; o resto morre.
• Um escritor de cada vez. Leia o plano antes de reescrevê-lo e reescreva-o por inteiro.

my-app-plan — walked 2026-09-10 by the Tuesday session

## Decided
2026-08-14 · you · Postgres, not SQLite — two writers, one box
2026-09-02 · you · ship the importer before the dashboard — nobody can try it empty

## Next
1. Importer accepts CSV with a header row. Finished: a real customer file lands.
2. Retry the webhook on 5xx. Finished: one blip stops costing a record.
3. Dashboard: one chart, last 30 days. Finished: it answers "is it working".

## Parked
2026-08-30 · a public status page — nothing to show yet

## Open with your user
2026-09-08 · free tier: how many rows before it asks for money