Tu agente dibuja el mapa de todo tu sistema. Cada sesión posterior lo carga.

Las tres reglas de un mapa

• La topología se dibuja una sola vez, en la raíz. Una lámina nunca vuelve a representar los cables; solo contiene su propio detalle y sus procedimientos. La duplicación es donde empieza la deriva, así que por construcción no existe.
• Los valores no viven en ningún lugar del mapa. Sin puertos, máximos, precios ni recuentos: una página dice dónde vive el número, nunca cuál es. Un mapa que lleva valores está mal en una semana.
• Quien cambie un cable actualiza el mapa en la misma sesión. La raíz contiene una línea — verificada <date> contra <what> — y el lector confía en el mapa exactamente hasta ahí.

Lo que contiene el mapa raíz, en orden

• Qué es el proyecto, en dos frases, y la línea verificada.
• El diagrama: cajas y flechas, una flecha por cable con lo que viaja por él. La dirección importa más que cualquier otra cosa de la página.
• Los cables, enumerados: quién inicia, qué viaja, qué nunca viaja. Esta es la sección que detecta las mentiras.
• Los almacenes: cada lugar donde vive el estado, qué contiene y qué nunca contiene.
• El índice: cada placa por su nombre, cada procedimiento por placa y sección.

Qué contiene una placa

• Para cada parte de su plano: qué es, qué contiene, con qué se comunica y en qué dirección, qué nunca hace y qué sucede cuando se ejecuta.
• Dónde viven los valores: punteros, nunca valores.
• Sus procedimientos: los comandos exactos, qué leer para saber que funcionó y qué ha salido mal realmente al hacerlo, con la fecha.

Un martes, su agente abre el mapa, ve el cable que está a punto de tocar y comprueba la fecha en la línea verificada antes de cambiar nada.

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

Cuatro secciones, y nada más

• Decidido — una línea por decisión en vigor: la fecha, quién decidió y el porqué. Una propuesta nunca se escribe como decidida.
• Siguiente — ordenado, máximo diez elementos. Cada línea nombra el asunto y describe cómo será cuando esté terminado. El orden es el único estado que tiene un plan.
• Aparcado — ideas planteadas pero no decididas, cada una con la fecha en que fue planteada.
• Comenzar con el ser humano — las decisiones que solo una persona puede tomar, una por línea, con fecha.

La ley que evita que se pudra

• “Finalizado” significa que se ha eliminado. Quien termina un elemento lo elimina en la misma sesión y coloca lo que cambió en su lugar correspondiente: el cable en el atlas, la decisión o la medición en un registro, el código en un commit. No existe una sección de “Finalizado”.
• Se introduce en el Libro de Contabilidad. Una fila que queda atrapada pero que sigue siendo importante se convierte en una línea en “Next” o “Parked” y abandona el Libro de Contabilidad; el resto desaparece.
• Un escritor a la vez. Lea el plan antes de reescribirlo, y reescríbalo completo.

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