Importer un pattern

Vous pouvez adopter n'importe quel pattern de deux façons. Soit vous collez son token dans un assistant IA connecté, et Pathrule écrit les éléments sur les bons chemins à votre place, soit vous copiez le bundle à la main depuis le catalogue.

Le token de référence

Chaque pattern possède un token de référence de la forme :

::pathrule:package:<slug>

Par exemple, le pattern Next.js App Router correspond à ::pathrule:package:nextjs-app-router. Le token figure sur chaque page du catalogue, prêt à être copié.

Le préfixe ::pathrule: est un espace de noms réservé. Il est reconnu avant le chemin d'invocation ::skill-name, si bien qu'un token de pattern n'est jamais confondu avec un skill et ne déclenche jamais la découverte de skills. Cette séparation s'applique aussi bien dans le hook de prompt que dans la requête de contexte.

Collez le token en texte brut. Comme pour l'invocation d'un skill, un token placé entre backticks ou dans un bloc de code est considéré comme du code cité et ignoré. Vous pouvez mettre plusieurs tokens dans un même prompt ; chaque pattern n'est pris en compte qu'une fois.

Importer avec le token

Pour ajouter un pattern, collez son token dans un prompt, au sein d'un espace de travail connecté. Pathrule se charge ensuite du reste :

1. Il reconnaît le token. Lorsque Pathrule construit le contexte de votre prompt, il détecte le marqueur ::pathrule:package:<slug> et fait remonter une directive d'import pour ce slug.
2. Il prévisualise avant d'écrire. Une exécution à blanc résout le pattern et renvoie sa version, le problème qu'il résout, ses éléments et les chemins qu'il compte utiliser, sans rien modifier pour l'instant. Cet aperçu indique aussi les chemins, stacks et dépendances déclarés par le pattern, afin que l'assistant puisse le confronter à votre projet réel.
3. Il choisit des chemins adaptés à votre arborescence. Un pattern déclare des chemins suggérés, mais chaque dépôt est différent. L'assistant choisit une base qui correspond à votre organisation et y rattache les chemins du pattern, pour que les éléments atterrissent là où ils ont vraiment leur place. Dans un monorepo, les règles /app d'un pattern Next.js peuvent ainsi se retrouver sous /apps/web/app.
4. Il demande confirmation en cas d'incompatibilité. Si le pattern cible une stack que votre projet ne semble pas utiliser, par exemple un pattern React Native dans un projet sans Expo, l'assistant s'arrête et vous demande s'il faut l'ajouter, et où, plutôt que d'importer à l'aveugle.
5. Il écrit le bundle. Après confirmation, chaque élément est créé par le chemin d'écriture habituel : une mémoire devient une mémoire, une règle devient une règle avec son type de portée et sa priorité, et un skill devient un skill invocable, étiqueté avec le pattern dont il provient. Les nœuds manquants le long de chaque chemin sont créés à la demande.

L'assistant vous transmet ensuite un résumé d'une ligne, indiquant par exemple combien de règles, de mémoires et de skills ont été importés, combien étaient déjà présents et combien ont échoué.

Une fois importés, les éléments sont du contenu ordinaire de l'espace de travail. Ils remontent par les mêmes hooks et la même récupération que tout ce que vous avez écrit vous-même, et vous les modifiez de la même manière. Une règle importée arrive à titre indicatif : elle accompagne le contexte et ne bloque aucune modification, sauf si une personne approuve une contrainte exécutable pour elle (voir Les règles comme garde-fous).

L'import écrit en votre nom. Chaque élément passe par le même contrôle d'accès que toute autre écriture : au sein d'une équipe, vous devez donc disposer d'un accès en écriture à l'espace de travail cible, et un Viewer ne peut pas importer. Voir Rôles et autorisations.

Importer par copie manuelle

Le token n'est pas indispensable pour utiliser un pattern. Chaque page du catalogue propose une action « Manual copy (full bundle) » qui copie le bundle complet en Markdown brut, chaque élément étant étiqueté avec son type et son chemin cible, et chaque règle avec sa portée et sa priorité. Collez le résultat dans votre assistant, ou dans vos propres notes, et recréez les éléments où vous le souhaitez. Cela fonctionne sans aucune configuration et sans compte.

Chaque pattern est aussi disponible en Markdown brut à l'adresse /patterns/<slug>/raw, ce qui est pratique pour faire lire l'intégralité du bundle à un assistant à partir d'un lien.

Amorcer, pas s'abonner

Importer un pattern revient à amorcer votre espace de travail, une seule fois. À partir de ce moment, la copie présente dans votre espace de travail vous appartient ; elle ne reste pas liée au catalogue et ne changera pas à votre insu. Pathrule n'enregistre pas la version que vous avez importée et ne vous prévient pas lorsqu'une nouvelle version est publiée : rien ne vient donc jamais écraser par synchronisation un contenu que vous avez déjà adapté.

Pour savoir si un pattern a évolué depuis votre import, comparez la version et la date de mise à jour affichées sur sa page du catalogue, et consultez son changelog dans le package open source. Une réimportation n'apporte pas les changements, puisque chaque élément dont le titre est déjà présent est ignoré. Pour récupérer une version plus récente, retirez le bundle puis importez-le à nouveau, en sachant que cela remplace vos modifications sur les éléments importés. Si vous ne voulez qu'un seul élément amélioré, copiez-le à la main depuis la page du catalogue.

Réimporter et retirer

• Une réimportation ne crée jamais de doublon. Relancer le même import ignore chaque élément dont le titre est déjà présent, et indique ce qui a été ajouté et ce qui existait déjà. Une mémoire est considérée comme présente lorsqu'une mémoire de même titre existe à son chemin ; une règle ou un skill est considéré comme présent lorsqu'une règle ou un skill de même nom existe n'importe où dans l'espace de travail. Les éléments ignorés restent exactement tels quels, modifications comprises. Un élément renommé après l'import n'est plus reconnu, et une réimportation l'ajoute donc de nouveau.
• Le retrait se fait en une étape. Un pattern est défini par son propre manifeste de titres et de chemins : vous pouvez donc demander à votre assistant de retirer le pattern, et un seul appel annule l'ensemble du bundle. Si vous avez importé sous un chemin de base, indiquez la même base lors du retrait ; les éléments introuvables à cet endroit sont signalés comme non trouvés plutôt que traités comme des erreurs.

Ce que le retrait affecte

Le retrait retrouve chaque élément par son titre à son chemin, et non en se souvenant de ce que l'import a créé. Cela a trois conséquences à connaître avant de le lancer :

• Les éléments modifiés sont aussi retirés. Une mémoire, une règle ou un skill importé que vous avez modifié depuis est retiré avec vos modifications, tant que son titre et son chemin n'ont pas changé.
• Votre propre élément portant le même titre est retiré. Si vous avez écrit vous-même une mémoire, une règle ou un skill portant le même titre qu'un des éléments du pattern, au même chemin, le retrait le supprime également. Les titres sont comparés sans tenir compte de la casse.
• Les éléments renommés ou déplacés restent. Renommer un élément ou le déplacer vers un autre chemin le met hors de portée du retrait : c'est le moyen de conserver un élément tout en retirant les autres.

Les éléments retirés sont archivés plutôt qu'effacés. Sur un espace de travail Cloud, ils restent dans l'archive de l'espace de travail jusqu'à leur suppression définitive, et un propriétaire ou un administrateur peut les restaurer depuis les paramètres de la console web, sous Workspace, Archive.

Où cela fonctionne

L'import et le retrait par token s'appuient sur les outils MCP stdio locaux, y compris lorsque ce runtime est rattaché à un espace de travail Cloud. Remote MCP n'expose pas ces fonctions. Un client distant peut lire le bundle brut et créer les entrées de son choix avec les outils de connaissances dont il dispose.

L'import se comporte de la même façon dans Claude Code, Codex, Cursor, Windsurf et GitHub Copilot connectés via Pathrule CLI ou l'extension VS Code. L'import et le retrait fonctionnent de la même manière sur un espace de travail local et sur un espace de travail Pathrule Cloud. Dans Claude Code et Codex, le hook de prompt repère le token avant que l'agent n'agisse. Cursor, GitHub Copilot et Windsurf n'ont pas de hook de prompt : l'assistant y apprend le même workflow d'import et de retrait grâce à la requête de contexte et aux consignes de protocole présentes dans ses fichiers d'instructions.

Pour aller plus loin

• Présentation des patterns pour avoir une vision globale.
• Anatomie d'un pattern pour savoir ce que contient un bundle et comment fonctionne le versionnage.
• Fonctionnement des hooks pour comprendre comment les éléments importés sont fournis une fois présents dans votre espace de travail.