Votre agent dessine la carte de tout votre système. Chaque session suivante la charge.

Les trois règles d’une carte

• La topologie est dessinée une seule fois, dans la racine. Une planche ne réaffirme jamais les fils ; elle ne contient que ses propres détails et ses procédures. La duplication est là où commence la dérive, donc il n’y en a pas par construction.
• Les valeurs ne se trouvent nulle part sur la carte. Pas de ports, de prix ni de quantités — une page indique où se trouve le chiffre, jamais ce qu’il est. Une carte qui affiche des valeurs est déjà fausse en une semaine.
• Quiconque modifie un fil met à jour la carte au cours de la même session. La racine contient une ligne — vérifiée <date> par rapport à <what> — et un lecteur fait confiance à la carte uniquement jusqu’à ce point.

Ce que contient la carte racine, dans l’ordre

• En deux phrases, de quoi il s’agit, ainsi que la ligne vérifiée.
• Le diagramme : des boîtes et des flèches, une flèche par fil indiquant ce qui le traverse. La direction est plus importante que tout le reste sur la page.
• Les fils, énumérés : qui initie, ce qui est transmis, ce qui ne l’est jamais. C’est la partie qui dénonce les mensonges.
• Les magasins : chaque lieu où vit l’état, ce qu’il contient, ce qu’il ne contient jamais.
• L’index : chaque planche par nom, chaque procédure par planche et par section.

Ce que contient une planche

• Pour chaque partie de son plan : ce qu’elle est, ce qu’elle contient, à qui et dans quelle direction elle communique, ce qu’elle ne fait jamais, et ce qui se passe lorsqu’elle fonctionne.
• Où se trouvent les valeurs — des pointeurs, jamais des valeurs.
• Ses procédures : les commandes exactes, ce qu’il faut lire pour savoir que cela a fonctionné, et ce qui s’est réellement mal passé lors de l’exécution, avec la date.

Un mardi, votre agent ouvre la carte, voit le fil qu'il s'apprête à toucher et vérifie la date de la ligne vérifiée avant de changer quoi que ce soit.

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

Quatre sections, et rien d'autre

• Decided — une ligne par décision en vigueur : la date, qui a décidé, et pourquoi. Une proposition n'est jamais inscrite comme décidée.
• Next — ordonné, dix éléments au maximum. Chaque ligne nomme la chose et dit à quoi ressemble « terminé ». L'ordre est le seul statut qu'ait un plan.
• En attente — idées soumises mais non décidées, chacune accompagnée de la date à laquelle elle a été soumise.
• Ouvrir avec l’humain — les décisions que seul un être humain peut prendre, une ligne chacune, datées.

La loi qui l’empêche de pourrir

• « Terminé » signifie disparu. Celui qui termine une tâche la supprime durant la même session et place ce qui a changé à sa place : le fil dans l’atlas, la décision ou la mesure dans un registre, le code dans un commit. Il n’y a pas de section « Terminé ».
• Le Ledger est mis à jour en conséquence. Une ligne retenue qui reste importante devient une ligne dans Next ou Parked et quitte le Ledger ; le reste est supprimé.
• Un écrivain à la fois. Lisez le plan avant de le réécrire, puis réécrivez-le dans son intégralité.

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