Il tuo agente disegna la mappa dell'intero sistema. Ogni sessione successiva la carica.

Le tre regole di una mappa

• La topologia si disegna una volta sola, nella radice. Una tavola non ripete mai i collegamenti; contiene solo i propri dettagli e le proprie procedure. La duplicazione è dove inizia la deriva, quindi per costruzione non ce n'è nessuna.
• I valori non vivono da nessuna parte nella mappa. Né porte, né limiti, né prezzi, né conteggi — una pagina dice dove vive il numero, mai cosa sia. Una mappa che porta valori è sbagliata entro una settimana.
• Chiunque modifichi un collegamento aggiorna la mappa nella stessa sessione. La radice contiene una riga — verificata <date> contro <what> — e il lettore si fida della mappa esattamente fino a quel punto.

Ciò che contiene la mappa radice, in ordine

• In due frasi, di cosa si tratta il progetto, e la riga verificata.
• Il diagramma: caselle e frecce; una freccia per ciascun filo, con indicato ciò che vi scorre. La direzione è più importante di qualsiasi altra cosa presente sulla pagina.
• I fili, elencati: chi inizia, cosa viaggia, cosa non viaggia mai. Questa è la sezione che smaschera le menzogne.
• Gli archivi: ogni luogo in cui vive lo stato, ciò che contiene, ciò che non contiene mai.
• L'indice: ogni scheda per nome, ogni procedura per scheda e sezione.

Cosa contiene una scheda

• Per ciascuna parte del suo piano: cosa è, cosa contiene, con cosa e in quale direzione comunica, cosa non fa mai, e cosa succede quando viene eseguita.
• Dove risiedono i valori: puntatori, mai i valori stessi.
• Le sue procedure: i comandi esatti, cosa leggere per verificare che abbia funzionato, e cosa è effettivamente andato storto durante l'esecuzione, con la data.

Un martedì, il tuo agente apre la mappa, vede il collegamento che sta per toccare e controlla la data sulla riga verificata prima di modificare qualsiasi cosa.

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

Quattro sezioni, e nient'altro

• Deciso — una riga per ogni decisione in vigore: la data, chi ha deciso e il motivo. Una proposta non viene mai indicata come decisa.
• Prossimo — ordinato, massimo dieci voci. Ogni riga indica l'oggetto e descrive come apparirà una volta completato. L'ordine è l'unico stato che può avere un piano.
• Parcheggiato — idee proposte e non ancora decise, ciascuna con la data di proposta.
• Aprire con la persona — le decisioni che solo una persona può prendere, una per riga, con data.

La legge che impedisce che marcisca

• “Finito” significa rimosso. Chiunque completi un compito lo rimuove nella stessa sessione e colloca ciò che è cambiato nel posto giusto: il filo nell’atlante, la decisione o la misurazione in un registro, il codice in un commit. Non esiste una sezione “Finito”.
• Il Ledger viene aggiornato di conseguenza. Una riga individuata che è ancora rilevante diventa una riga in “Next” o “Parked” e lascia il Ledger; il resto viene eliminato.
• Un autore alla volta. Leggi il piano prima di riscriverlo, e riscrivilo per intero.

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