Tout Wikilayer repose sur l’arbre de nœuds décrit ci-dessous : chaque bloc a une adresse stable, chaque page montre quelles pages pointent vers elle, et une page se lit toujours comme un seul document. MCP est la voie par laquelle les agents atteignent ce même arbre.
Nœuds
Wikilayer range les textes dans un seul arbre. Chaque nœud a un titre et un corps en Markdown ; une page contient les blocs qui forment ses sections et se place sous le wiki ou sous une autre page, et cet arbre de pages constitue la navigation du wiki. Le navigateur affiche la page pour les personnes, et MCP expose les mêmes nœuds aux agents.
Les niveaux de titre viennent de l’arbre
Un bloc placé directement sous une page s’affiche en h2 ; un bloc placé sous celui-ci, en h3. Un titre saisi dans un corps Markdown n’a pas de nœud à lui, et les outils le refusent donc. Chaque section est un bloc à part entière : elle apparaît dans le sommaire de la page et peut recevoir un lien direct.
Ce que les nœuds apportent
Chaque nœud a un identifiant stable, un nœud parent et son propre historique des modifications.
Les liens survivent aux renommages
Une référence block:N utilise l’identifiant stable du nœud. Renommer, réécrire ou déplacer ce nœud laisse le lien intact.
Les liens entrants sont automatiques
Comme les liens visent des identifiants de nœuds, Wikilayer peut lister les pages qui pointent vers un nœud. La liste apparaît sur la page et dans son document Markdown assemblé.
Un déplacement emporte le sous-arbre
move_node change le nœud parent d’un nœud. Ses descendants le suivent, et leurs niveaux de titre s’adaptent à la nouvelle profondeur. Une clé sort_key place le nœud parmi ses frères sans modifier leur corps. migrate peut déplacer un sous-arbre vers un autre wiki lorsqu’aucun lien ne franchirait la limite du wiki.
L’historique appartient à chaque nœud
Chaque nœud conserve ses propres versions et son updated_at. Modifier un bloc ajoute une entrée d’historique pour ce bloc sans toucher à ses voisins.
Le plan évite de lire tout le wiki
get_outline cartographie un wiki par ses titres, ses identifiants et ses nombres de tokens, sans transmettre tous les corps.
Les liens relient les branches
L’arbre donne à chaque nœud un seul nœud parent. Les références courtes relient des nœuds apparentés ailleurs dans le wiki, et les liens entrants montrent les connexions inverses sans dupliquer le contenu.
Lecture et export
Une page se lit comme un seul document
Le navigateur affiche une page avec ses sections dans l’ordre. get_page_markdown renvoie la même page à un agent, avec avant chaque nœud un commentaire qui porte son identifiant. Les wikis publics proposent aussi le document assemblé sous forme de vue Markdown.
Le contenu est portable
Un export de wiki contient son Markdown, ses fichiers et sa structure, si bien que le contenu peut être conservé hors de Wikilayer.