Pour les développeurs

De simples fichiers, et une synchronisation qu’on peut comprendre.

Chaque document est un vrai fichier, dans son vrai format, dans un dossier de votre choix. Pointez-y Claude Code, Codex, Cursor ou vos propres scripts. La démo de la page d’accueil a un onglet terminal.

Ce que contient le dossier

Les fichiers .docx, .md, .txt, .csv, .svg, .epub et .mhtml restent ce qu’ils sont.
Les PDF sont écrits avec leurs annotations, champs de formulaire et modifications, et les images avec leurs calques dessinés.
Les dossiers de Golem Docs sont des dossiers sur le disque. Déplacez ou renommez un fichier et le document suit, historique compris.
Les noms commençant par un point sont ignorés, donc .git est laissé tranquille. .golemdocs/ contient l’état de synchronisation ; ne le modifiez pas.

Les règles de synchronisation

Un fichier modifié ici	Le fichier l’emporte. Si le compte a aussi changé, sa copie est d’abord gardée comme version.
Un fichier supprimé	Le document va à la corbeille du compte pendant 30 jours.
Un fichier déplacé ou renommé	Mêmes octets, nouvel endroit : cela reste un seul document, avec son historique.
Dix fichiers ou plus disparaissent	La synchronisation s’arrête et demande. C’est généralement un disque qui n’est pas monté.
À quelle fréquence	Le dossier est vérifié toutes les 4 secondes, le compte chaque minute.

Garder le dossier en phase avec votre compte, et par lui vos autres appareils et les personnes avec qui vous partagez, fait partie de la synchronisation, 3 $ par mois. Sans elle, le dossier et Golem Docs restent tout de même en phase sur cet ordinateur, et les versions et la corbeille y sont conservées. Sur le même ordinateur, un changement dans le dossier apparaît dans Golem Docs en quelques secondes, et un changement fait dans Golem Docs arrive dans le dossier en moins d’une minute. Les autres appareils consultent votre compte environ une fois par minute.

Un AGENTS.md pour votre dossier

Les agents lisent un fichier d’instructions en haut du dossier. Voici un point de départ ; changez-le selon votre façon de classer.

AGENTS.md

# Ce dossier est mon second cerveau

C’est mon dossier Golem Docs : chaque fichier ici est un document de mon compte,
et ce que tu changes ici se synchronise sur tous mes appareils.

- Cherche dans le dossier avant d’écrire sur un sujet, et appuie-toi sur les
  notes qui existent déjà.
- Mets chaque nouvelle note dans le dossier qui correspond à son sujet. Liste
  d’abord les dossiers. Demande avant de créer un nouveau dossier de premier niveau.
- Utilise des [[wikilinks]] vers les notes proches, et ajoute les nouvelles
  notes à la note d’index du dossier.
- Garde mes propres notes dans ma voix. Ajoute des liens ou une ligne à la fin ;
  ne réécris pas ce que j’ai écrit.
- Ne touche jamais à .golemdocs/.